原创 付费 [1.20.1-1.21.x|Folia]WarZVeinMiner —— 高还原原版低卡顿连锁采集插件 1.2.0

[原创|生存]WarZVeinMiner —— 高还原原版低卡顿连锁采集插件[1.20.1-1.21.x]

插件简介​

WarZVeinMiner 是一款专为MC生存服、末日类服务器打造的高适配、低卡顿、可高度定制连锁采集插件，由作者 Crazy_Jky 原创开发。
区别于传统连锁插件无脑批量破块的弊端，本插件全程严格遵循原版游戏机制，以玩家原生操作逻辑为核心设计，拒绝乱连锁、错连锁问题。同时兼容旧版 ChainTools 插件指令，支持老旧服务器无缝迁移，是替代传统连锁插件的优质选择。
核心亮点

• 原版极致还原：矿石、木材、作物分家族识别，不跨类别乱连锁，贴合原版生存手感
• 全场景适配：支持挖矿、伐木、作物收割、地形开垦、植物清理全场景连锁
• 低卡顿高性能：轻量化代码架构，适配Folia等主流服务端，高配低配服务器均可流畅运行
• 精细化保护联动：完美兼容主流领地、区域保护插件，精准拦截保护区操作并细分提示
• 可拓展性极强：可选能量平衡系统、全自定义消息样式、完整PAPI变量支持
• 无缝迁移：兼容ChainTools旧版指令，老服迁移无需修改玩家操作习惯

核心功能​

插件覆盖原版生存全部连锁需求，同时附带多项优化功能，兼顾实用性与服务器平衡性：

• 矿脉连锁挖掘：适配全版本原版矿石、深层矿石、下界矿石、远古残骸，同矿家族互通连锁，斜向3D扫描可自由开关
• 树木连锁砍伐：按树种精准识别，原木、去皮木、菌柄互通，支持砍伐后自动补种对应树苗
• 锄头范围开垦：支持3×3/5×5/7×7多档位耕地开垦，遵循原版规则，仅上方为空时触发
• 作物智能收割：小麦、胡萝卜等普通作物成熟自动收割+原地补种；甘蔗、竹子、地狱疣等特殊作物专属规则，保留底部植株可持续生长
• 快捷操作开关：支持潜行+右键工具一键切换连锁状态，无需频繁输入指令
• 智能工具保护：自动识别工具耐久，杜绝连锁挖掘导致工具瞬间爆掉
• 多样式消息展示：支持传统颜色、HEX、RGB、MiniMessage渐变样式，自定义程度拉满
• 能量平衡系统：可选开启，支持能量消耗、自动恢复、权限加成，精准调控连锁频率，平衡服务器经济与生存节奏
• 多端状态显示：ActionBar、BossBar、聊天栏三种状态展示模式，可自定义样式与时长

兼容与依赖​

服务端兼容​

• 支持核心：Paper、Spigot、Purpur、Folia（原生适配）
• 适配版本：Minecraft 1.20.1 - 1.21.x
• 运行环境：Java 17+
• API版本：1.20

可选软依赖（非必需）​

无依赖即可运行基础功能，安装对应插件可解锁拓展能力：
[TABLE=ace-table]
[TR]
[/TR]
[TR]
[td]PlaceholderAPI[/td]
[td]提供连锁状态、玩家能量等全局变量，支持自定义UI展示[/td]
[/TR]
[TR]
[td]WorldGuard[/td]
[td]区域保护判定，禁止连锁破坏保护区方块[/td]
[/TR]
[TR]
[td]Residence[/td]
[td]领地保护判定，禁止连锁破坏玩家私有领地方块[/td]
[/TR]
[/TABLE]

安装教程​

基础安装步骤​

1. 将 WarZVeinMiner-x.x.x.jar 上传至服务器 plugins 文件夹
2. 按需安装 PlaceholderAPI、WorldGuard、Residence 等拓展依赖
3. 启动服务器，插件将自动生成全部核心配置文件

自动生成配置文件​

• config.yml：插件核心功能、数值、开关全局配置
• messages.yml：全量提示消息、文本样式自定义配置
• playerdata.yml：玩家连锁状态、能量数据本地存储

配置重载​

修改配置后无需重启服务器，执行指令即时生效：/veinminer reload

基础使用教程​

必做权限配置​

插件默认通过权限节点管控功能，需给玩家组授予基础权限：

• warzveinminer.toggle：允许切换连锁功能开关
• warzveinminer.inspect：允许查看工具适配规则
• warzveinminer.use.pickaxe：镐类矿脉连锁权限
• warzveinminer.use.axe：斧类伐木连锁权限
• warzveinminer.use.shovel：铲类地形平整权限
• warzveinminer.use.sword：植物批量清理权限
• warzveinminer.use.hoe：锄头开垦、作物收割权限

若开启配置 settings.require-permission: true，需额外授予总权限：warzveinminer.use

玩家使用流程​

1. 手持对应工具（镐/斧/锄/铲/剑）
2. 执行 /veinminer toggle 开启连锁功能
3. 直接挖掘方块即可触发对应原版连锁规则
4. 可通过 /veinminer status 查看当前功能状态

快捷操作：开启配置后，可通过 潜行+右键手持工具 快速切换连锁开关，操作更便捷。

全部指令大全​

玩家指令​

[TABLE=ace-table]
[TR]
[/TR]
[TR]
[td]/veinminer help[/td]
[td]查看插件完整帮助文档[/td]
[/TR]
[TR]
[td]/veinminer toggle[/td]
[td]切换个人连锁功能开关[/td]
[/TR]
[TR]
[td]/veinminer status[/td]
[td]查看连锁状态、手持工具适配分类[/td]
[/TR]
[TR]
[td]/veinminer inspect[/td]
[td]查看工具匹配规则、权限详情[/td]
[/TR]
[TR]
[td]/ct toggle / /ct look[/td]
[td]兼容旧版ChainTools指令，适配老玩家习惯[/td]
[/TR]
[/TABLE]
指令别名：/vm、/warzveinminer、/ct

管理员指令​

[TABLE=ace-table]
[TR]
[/TR]
[TR]
[td]/veinminer reload[/td]
[td]重载全部配置、消息文件[/td]
[/TR]
[TR]
[td]/veinminer energy help[/td]
[td]查看能量系统管理帮助[/td]
[/TR]
[TR]
[td]/veinminer energy add <玩家> <数值>[/td]
[td]为在线玩家增加能量（自动封顶上限）[/td]
[/TR]
[TR]
[td]/veinminer energy set <玩家> <数值>[/td]
[td]直接设置玩家能量值[/td]
[/TR]
[TR]
[td]/veinminer energy take <玩家> <数值>[/td]
[td]扣除玩家能量（最低为0）[/td]
[/TR]
[TR]
[td]/veinminer energy reset <玩家>[/td]
[td]重置玩家能量至最大上限[/td]
[/TR]
[/TABLE]

权限节点​

全局核心权限​

[TABLE=ace-table]
[TR]
[/TR]
[TR]
[td]warzveinminer.use[/td]
[td]功能总开关（需开启权限校验才生效）[/td]
[td]true[/td]
[/TR]
[TR]
[td]warzveinminer.toggle[/td]
[td]允许切换连锁状态[/td]
[td]true[/td]
[/TR]
[TR]
[td]warzveinminer.inspect[/td]
[td]允许查看工具适配信息[/td]
[td]true[/td]
[/TR]
[TR]
[td]warzveinminer.reload[/td]
[td]允许重载插件配置[/td]
[td]op[/td]
[/TR]
[TR]
[td]warzveinminer.energy.admin[/td]
[td]玩家能量管理权限[/td]
[td]op[/td]
[/TR]
[TR]
[td]warzveinminer.admin[/td]
[td]插件全部管理权限[/td]
[td]op[/td]
[/TR]
[/TABLE]

能量加成权限（自定义拓展）​

可通过权限配置玩家能量减免、上限加成，适配VIP权限体系：

• warzveinminer.energy.costreduce.10：能量消耗降低10%
• warzveinminer.energy.costreduce.25：能量消耗降低25%
• warzveinminer.energy.max.50：最大能量固定+50
• warzveinminer.energy.max.100：最大能量固定+100
• warzveinminer.energy.maxrate.20：最大能量增幅20%

PAPI变量支持​

安装 PlaceholderAPI 后可使用以下变量，支持自定义前缀，适配计分板、头衔、菜单等场景：

• %warzveinminer_status%：返回连锁开关状态（on/off）
• %warzveinminer_status_text%：返回中文状态（已开启/已关闭）
• %warzveinminer_energy%：玩家当前能量数值
• %warzveinminer_energy_max%：玩家最大能量上限
• %warzveinminer_energy_percent%：当前能量百分比

保护联动机制​

原生无缝联动 Residence、WorldGuard 两大主流保护插件，机制智能且人性化：

• 连锁时逐方块判定权限，受保护方块自动跳过，不终止整次连锁，不影响正常游戏体验
• 精细化拦截提示，精准区分保护插件来源、操作类型，让玩家清晰知晓拦截原因
• 完全规避领地、区域恶意破坏，兼顾生存便利与服务器规则

常见问题FAQ​

• Q：开启连锁后无法触发功能？ A：大概率权限缺失，需授予对应工具使用权限；若开启总权限校验，需额外添加 warzveinminer.use 权限。
• Q：甘蔗、竹子无法整列挖完？ A：原版适配设计，刻意保留底部一格植株，保障作物持续生长，贴合原版生存规则。
• Q：部分方块无法连锁？ A：可排查连锁上限超限、方块受保护、工具耐久不足、能量不足、不属于同方块家族等问题。
• Q：PAPI变量不显示？ A：确认已安装PAPI插件、插件变量功能已开启、未自定义修改变量前缀。
• Q：消息颜色代码不生效？ A：区分消息模式，LEGACY模式使用&代码，MINIMESSAGE模式使用官方渐变标签，禁止混用格式。

技术支持与作者信息​

插件作者：Crazy_Jky
适配场景：生存服、末日服、开荒服、原版复刻服务器
交流渠道

• 插件技术交流群：398893720
• 末日服务器交流群：1063544727
• 定制开发QQ：1285988665
• 作者爱发电：https://afdian.com/a/sunjood

Bug反馈须知：反馈问题请附带服务端核心、游戏版本、依赖插件列表、配置片段及报错日志，方便快速定位修复问题。

结语​

WarZVeinMiner 摒弃传统连锁插件的粗糙逻辑，以原版手感、低卡顿、高定制、高平衡为核心，完美替代 ChainTools 等老旧插件，适配绝大多数生存、末日类服务器，是开荒运营、长期服优化的必备连锁插件！文档将随插件版本持续迭代更新。