- ◆ 游戏版本
- 1.21 ~ 26.x
- ◆ 服务端核心
- Paper / Purpur / Spigot / Folia
- ◆ 前置/依赖
- 无硬依赖
WoChainMine · 涡轮连锁
全配置化的 Minecraft 连锁采集 / 作物收割插件。支持 Paper / Purpur / Spigot / Folia，
适配 Minecraft 1.21 ~ 26.x。无硬依赖，装上即用。
- 版本：1.0.0
- 作者：LittleWo
- 主命令：
/chainm（别名/chainmine、/wcm）
一、核心特点
| 特性 | 说明 |
|---|---|
| 四核心通吃 | Paper、Purpur、Spigot、Folia 同一份 jar；Folia 上使用区域线程调度，不跨线程操作 |
| 全配置化 | 工具组、可连锁方块、GUI 布局、全部都在 config.yml |
| 标签支持 | 方块可以写 #minecraft:logs 这类原版标签，一次覆盖一整类 |
| 作物连锁收割 | 锄头右键 / 破坏成熟作物，一键收一片田，可自动补种 |
| 连锁发光预览 | 潜行时高亮发光显示将要连锁的方块，只对本人可见，不会干扰别人 |
| 领地保护 | 内置 Residence / WorldGuard 判定，杜绝「站领地外连锁别人家」 |
| 性能可控 | 双重闸门（每 tick 格数 + 每 tick 毫秒预算），大矿脉也不会造成 TPS 抖动 |
| 玩家级GUI开关 | 总开关 / 每个工具组 / 作物收割 / 预览，四个维度都可由玩家自己开关 |
二、安装
- 把
WoChainMine-x.x.x.jar放进服务端的plugins/目录。 - 启动服务器，生成
plugins/WoChainMine/config.yml。 - 按需编辑配置，执行
/chainm reload或重启。
要求
- 服务端核心：Paper / Purpur / Spigot / Folia 任选
- Minecraft：1.21 ~ 26.3
- Java：21 及以上
可选依赖（不装也能正常运行）
| 插件 | 作用 |
|---|---|
| PlaceholderAPI | 提供 %wochainmine_*% 变量 |
| Residence | 连锁时的领地保护判定 |
| WorldGuard | 连锁时的区域保护判定 |
三、怎么用
玩家需要 潜行 才能触发连锁（require-sneak: false 可关掉）。
- 挖矿：手持对应工具（镐 / 斧 / 铲 / 锄），潜行，破坏一个可连锁方块 → 整条矿脉/整棵树一起掉。
- 收菜：手持锄头，右键（或直接破坏）成熟作物 → 一片成熟的同种作物一起收，默认自动补种。
- 看预览：潜行并看向可连锁方块，会高亮出即将连锁的范围。
- 开面板：
/chainm。
四、命令与权限
命令
| 命令 | 说明 |
|---|---|
/chainm |
打开连锁管理面板 |
/chainm list |
查看所有工具组与作物收割的开关状态 |
/chainm status |
查看自己的各项开关 |
/chainm on / /chainm off |
打开 / 关闭连锁总开关 |
/chainm toggle <组名> |
切换某个工具组 |
/chainm toggle crops |
切换作物连锁收割 |
/chainm toggle preview |
切换连锁预览 |
/chainm reload |
重载配置文件 |
权限
| 权限 | 说明 |
|---|---|
wochainmine.use |
允许使用连锁采集与作物收割 |
wochainmine.admin |
允许 /chainm reload |
wochainmine.preview |
允许使用连锁预览（预留） |
wochainmine.bypass.durability |
连锁时不消耗工具耐久 |
wochainmine.bypass.protection |
连锁时无视领地 / 区域保护（危险） |
工具组还可以单独设权限：在工具组里写 permission: "某权限节点"，没这个权限的玩家就用不了该组（留空表示不检查）。
五、配置速览
完整注释都在 config.yml 里。
YAML:
enabled: true # 功能总开关
require-sneak: true # 是否必须潜行
auto-collect: true # 掉落是否直接进背包
max-chain: 64 # 全局连锁上限
durability-protect: 2 # 工具剩余耐久 ≤ 该值就停
performance: # 双重闸门
max-blocks-per-tick: 16
time-budget-ms: 5
worlds: # 生效范围
mode: BLACKLIST
disabled-worlds: []
allowed-worlds: []
disabled-gamemodes: []
protection: # 领地保护
residence: true
worldguard: true
preview: # 连锁预览
mode: auto # auto | glow | damage | off （damage暂未支持）
range: 6.0
scan-interval: 10
max-blocks: 64
crop-harvest: # ★ 作物连锁收割
enabled: true
triggers: [RIGHT_CLICK, BREAK]
radius: 3
replant: true
tools: [WOODEN_HOE, ...]
blocks: [WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART]
tool-groups: # ★ 工具组，整段可任意增删
pickaxe: { ... }
axe: { ... }
shovel: { ... }
hoe: { ... }
gui: { ... } # 面板标题 / 行数 / 槽位 / 按钮 / 文案
messages: { ... } # 全部提示文案
增删一个工具组
在 tool-groups 下修改：
YAML:
tool-groups:
# 例：剪刀剪树叶
shear:
enabled: true
display-name: "&d剪刀组"
description: "&7树叶连锁修剪"
icon: SHEARS
tools: [SHEARS]
blocks:
- "#minecraft:leaves" # 标签写法，一次覆盖所有树叶
max-chain: 32 # 本组专属上限，0 = 用全局
permission: "" # 留空 = 不检查权限
加完 /chainm reload 即可。GUI 会自动多出一个按钮（需要 gui.group-slots 里还有空槽位）。
增删可连锁方块
直接改对应工具组的 blocks 列表：
YAML:
blocks:
- DIAMOND_ORE
- "#minecraft:iron_ores"
- "#minecraft:copper_ores"
六、跨平台兼容说明
| 能力 | Paper / Purpur / Folia | Spigot |
|---|---|---|
| 连锁采集 / 作物收割 | ✅ | ✅ |
| 领地保护（Residence / WorldGuard） | ✅ | ✅ |
传统 & 颜色代码 |
✅ | ✅ |
MiniMessage（<red>、<#ff8800>） |
✅ | ❌ 会原样显示 |
预览 · 发光描边（glow） |
✅ | ❌ |
预览 · 方块裂纹（damage）（暂未支持/未来计划） |
❌ | ❌ |
七、常见问题
Q：潜行挖矿没反应？
按顺序排查：enabled 是否为 true → 玩家是否有 wochainmine.use → 是否在 disabled-worlds 里 →
玩家是否用 /chainm 关掉了总开关或该工具组 → 手持工具是否在该工具组的 tools 里 →
该方块是否在 blocks 里。
Q：站在领地边上会连锁到别人的地吗？
不会。插件会做领地判定：只要连通范围里有任何一格属于你无权破坏的领地，整次连锁就会取消（玩家手挖的那一格照常掉落）。
装了 Residence 或 WorldGuard 就自动生效，两者都没装则跳过判定。
Q：连锁会不会把服务器卡崩？
不会。连锁是分批的：每 tick 最多 max-blocks-per-tick 格，且不超过 time-budget-ms 毫秒。
想更保守就把这两个值调小。
八、联系作者
有问题或建议可反馈到作者邮箱 block409@foxmail.com
