WoChainMine · 涡轮连锁

全配置化的 Minecraft 连锁采集 / 作物收割插件。支持 Paper / Purpur / Spigot / Folia，
适配 Minecraft 1.21 ~ 26.x。无硬依赖，装上即用。

• 版本：1.2.2
• 作者：LittleWo
• 主命令：/chainm（别名 /chainmine、/wcm）

当前发布版本 · v1.2.2（2026-10-11） 本版更新：新增 原版经验掉落、粒子反馈、连锁冷却、管理命令、配置自动升级， 并修复「挖矿看不见方块裂纹」「禁用世界误提示」等问题。

点击展开...

一、核心特点

二、安装

1. 把 WoChainMine-x.x.x.jar 放进服务端的 plugins/ 目录。
2. 启动服务器，生成 plugins/WoChainMine/config.yml。
3. 按需编辑配置，执行 /chainm reload 或重启。

从旧版本升级

直接用新 jar 替换即可，不要删掉自己的 config.yml，插件启动时会自动把老配置补齐到新版本。

要求

• 服务端核心：Paper / Purpur / Spigot / Folia 任选
• Minecraft：1.21 ~ 26.3
• Java：21 及以上

可选依赖（不装也能正常运行）

三、怎么用

玩家需要 潜行 才能触发连锁（require-sneak: false 可关掉）。

• 挖矿：手持对应工具（镐 / 斧 / 铲 / 锄），潜行，破坏一个可连锁方块 → 整条矿脉/整棵树一起掉。
• 收菜：手持锄头，右键（或直接破坏）成熟作物 → 一片成熟的同种作物一起收，默认自动补种。
• 看预览：潜行并看向可连锁方块，会高亮出即将连锁的范围。
• 开面板：/chainm。

四、命令与权限

命令

权限

工具组还可以单独设权限：在工具组里写 permission: "某权限节点"，没这个权限的玩家就用不了该组（留空表示不检查）。

五、配置速览

完整注释都在 config.yml 里。

enabled: true            # 功能总开关
require-sneak: true      # 是否必须潜行
auto-collect: true       # 掉落是否直接进背包
max-chain: 64            # 全局连锁上限
durability-protect: 2    # 工具剩余耐久 ≤ 该值就停（0 = 不保护）
cooldown-ms: 0           # 两次连锁的最小间隔，0 = 不限制

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
  range: 6.0
  scan-interval: 10
  max-blocks: 64
  glow-inset: 0.01       # 发光预览实体缩进方块内部的比例（0~0.4），防止挡住挖掘裂纹

crop-harvest:            # ★ 作物连锁收割
  enabled: true
  triggers: [RIGHT_CLICK, BREAK]
  radius: 3
  max-blocks: 64         # 作物只有这一个上限
  replant: true
  tools: [WOODEN_HOE, ...]
  blocks: [WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART]

exp-drops:               # ★ 连锁挖矿补发的经验（表里没列的方块不给，与原版一致）
  enabled: true
  mode: player           # player（直接给玩家）| orb（生成经验球）
  table:
    DIAMOND_ORE: "3-7"
    NETHER_GOLD_ORE: "0-1"
    SCULK: "1"
    …

feedback:                # ★ 粒子反馈
  particles:
    enabled: true
    type: BLOCK          # BLOCK = 方块碎裂粒子；也可填 CRIT / HAPPY_VILLAGER 等
    count: 4

tool-groups:             # ★ 工具组，整段可任意增删
  pickaxe: { ... }
  axe: { ... }
  shovel: { ... }
  hoe: { ... }

gui: { ... }             # 面板标题 / 行数 / 槽位 / 按钮 / 文案
messages: { ... }        # 全部提示文案

增删一个工具组

在 tool-groups 下修改：

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 列表：

    blocks:
      - DIAMOND_ORE
      - "#minecraft:iron_ores"
      - "#minecraft:copper_ores"

六、跨平台兼容说明

七、常见问题

Q：潜行挖矿没反应？
按顺序排查：enabled 是否为 true → 玩家是否有 wochainmine.use → 是否在 disabled-worlds 里 →
玩家是否用 /chainm 关掉了总开关或该工具组 → 手持工具是否在该工具组的 tools 里 →
该方块是否在 blocks 里。

Q：站在领地边上会连锁到别人的地吗？
不会。插件会做领地判定：只要连通范围里有任何一格属于你无权破坏的领地，整次连锁就会取消（玩家手挖的那一格照常掉落）。
装了 Residence 或 WorldGuard 就自动生效，两者都没装则跳过判定。

Q：连锁会不会把服务器卡崩？
不会。连锁是分批的：每 tick 最多 max-blocks-per-tick 格，且不超过 time-budget-ms 毫秒。
想更保守就把这两个值调小。

Q：工具快坏了会一直连锁到爆掉吗？
不会。durability-protect（默认 2）表示工具剩余耐久 ≤ 该值时连锁立即停止。
检查发生在三个位置：连锁启动前、每一格处理前、整条连锁结束时。想完全不管耐久就设 0。

八、更新日志

v1.2.2 · 2026-10-11

新增功能

• 经验掉落：连锁挖矿补发原版经验（煤 / 红石 / 青金石 / 钻石 / 绿宝石 / 下界石英 / 下界金 / 幽匿系列），

  数值照抄原版；exp-drops.table 可自定义，mode 可选直接给玩家或生成经验球。

• 粒子反馈：每挖掉 / 收割一格都在原位撒粒子，类型与数量可配，只发给发起者本人。

• cooldown-ms：限制连点间隔，防刷屏 / 防刷耐久；冷却期间不会亮连锁预览。

• 管理命令 /chainm admin status|on|off <玩家>：查看或强制开关任意玩家的连锁。

• config.yml 自动升级：换 jar 升级时自动把新增配置项（连同模板里的说明注释）补进你的配置文件，

  只加不减、改前先备份成 config.yml.v<旧版本>.bak，你已经写下的每一行、每个取值都不动。

  不想写回文件的话把 auto-update-config 改成 false（新增项仍按内置默认值生效）。

• 配置 preview.glow-inset（默认 0.01，范围 0~0.4）：预览实体内缩多少格，见下面「修复」第一条。

修复与改进

• 挖矿时看不到方块裂纹：现在实体改为整体缩进方块内部，方块表面重新交还原版渲染：裂纹正常显示；方块边缘的高亮照旧。
• 禁用世界 / 无权限时的误提示：现在只有真的要连锁时才判环境限制并发送提示。

v1.0.1 · 2026-10-10

• 接入 bStats 匿名统计。

v1.0.0 · 2026-10-08

• 首个公开版本。

九、联系作者

有问题或建议可反馈到作者邮箱 block409@foxmail.com