原创 付费 工具 娱乐 YiyunChain - 全新高性能连锁插件 | 支持Folia | 支持CraftEngine | 1.21.4+ v1.2.0

[MD] # 🌌 YiyunChain | 逸云连锁 **一款面向 Paper / Folia 现代服务端的高级真实连通连锁挖掘插件，适配生存服、商业服、玩法服、RPG 服务器，告别传统半径连锁，让方块连锁更精准、更直观、更可控。** ## 📖 插件简介 传统半径型连锁插件通常依赖固定范围检测，容易出现隔块误挖、连通结构漏挖、无法识别不规则矿脉等问题。YiyunChain 逸云连锁摒弃半径判定逻辑，采用**26 向真实方块连通扫描**，根据方块实际相邻关系判定连锁区域。 无论是斜向连接的矿石、弯折的原木、复杂自定义地形，还是不规则堆叠的同类方块，插件都会按真实连通关系和 `max_chain` 上限进行处理。配合性能调控、发光预览、GUI 管理和软依赖扩展，适合作为正式服务器长期使用的连锁解决方案。  ## 🛒 购买与联系 YiyunChain 逸云连锁为付费插件。如需购买插件、咨询授权、获取更新或售后支持，请通过 QQ 联系作者。 - 作者 QQ：`2919089965` - 售前交流群：`1093090518` - 联系方式：QQ 搜索作者号码后添加咨询 - 也可以加入售前交流群，提前了解插件功能、适配情况和购买相关信息 - 咨询时建议说明服务器核心、Minecraft 版本，以及是否使用 Folia 核心，CraftEngine、PlaceholderAPI 等相关插件，方便确认适配方案 ## ✨ 核心亮点一览 | 功能特性 | 功能说明 | | -------------------- | ------------------------------------------- | | **26 向全维度连通扫描** | 覆盖方块全部相邻维度，识别真实连通的同类方块，适配复杂地形 | | **无半径限制机制** | 移除半径判定，连锁范围由方块连通关系 + 自定义单次连锁上限控制 | | **潜行发光预览** | 瞄准可连锁方块自动显示发光描边，提前预知连锁范围，减少误挖 | | **分段式性能调控** | 逐 tick 分批处理连锁任务，控制服务器瞬时负载，降低卡顿风险 | | **Paper / Folia 适配** | 适配 Paper / Folia 服务端，面向 1.21+ API 环境 | | **智能自动收集** | 连锁掉落物自动存入玩家背包，背包满则正常落地，兼顾便捷与平衡 | | **工具耐久保护** | 工具濒临破损时自动中断连锁，防止玩家误损毁珍贵工具 | | **原版附魔友好** | 兼容时运、精准采集等原版掉落逻辑，耐久消耗参考耐久附魔概率 | | **可视化GUI管理** | 可视化界面一站式管理工具组、连锁方块、参数配置，无需反复改配置文件 | | **无需外部数据库** | 玩家工具组开关状态通过 Player PDC 持久化，配合内存缓存快速读取 | | **自定义方块支持** | 软依赖 CraftEngine，支持服务器自定义方块连锁需求 | | **变量拓展支持** | 兼容 PlaceholderAPI，提供丰富连锁状态变量，适配计分板、菜单、公告等场景 | ## 💎 为什么优于普通连锁插件？ 1. **判定逻辑更专业**：传统半径连锁只会挖掘指定范围内的方块，容易出现隔块误挖、连通方块漏挖的情况。逸云连锁基于**真实连通逻辑**，只连锁真正连在一起的同类方块，减少误连与漏连。 2. **场景适配更全面**：针对不规则矿脉、倾斜原木、多层堆叠方块、自定义地形等复杂场景优化，减少传统连锁插件在复杂结构中的适配问题。 3. **服务器性能更稳定**：摒弃一次性批量处理逻辑，采用分批扫描、分批破坏机制，通过 tick 处理上限和时间预算双重限制，降低大范围连锁带来的瞬时压力。 4. **工具体验更接近原版**：连锁破坏会基于玩家当前工具计算掉落结果，保留时运、精准采集等原版附魔带来的收益；耐久消耗参考耐久附魔概率，不会简单粗暴地每破坏一个方块固定扣 1 点耐久。 5. **管理使用更省心**：兼顾玩家体验与服主管理需求，既有可视化预览、自动收集、耐久保护等玩家功能，也有 GUI 配置、快捷指令、权限管控等管理功能，开箱即用，便于自定义。 6. **状态保存更轻量**：玩家的工具组开关状态不需要额外配置 MySQL、SQLite 或独立玩家数据文件。插件使用 Player PDC 保存状态，并配合内存缓存进行快速读取，降低服主部署和维护成本。 ## 🎮 玩家体验优化 ### 1. 精准连锁挖掘 玩家手持对应工具潜行即可触发连锁挖掘。无论是挖矿、砍树，还是采集其他已配置方块，插件都会优先按照真实连通关系处理目标连通区块，减少漏挖和误挖，提升生存采集效率。 ### 2. 发光预览预判 瞄准可连锁方块时，系统会自动为扫描结果中的待连锁方块添加发光描边预览。该功能采用**缓存机制、差量更新、分批生成、自动清理**优化，减少重复扫描和瞬时实体创建，让玩家提前清晰掌握连锁范围。 ### 3. 智能耐久保护 开启保护功能后，插件会检测工具剩余耐久，并根据耐久保护规则限制本次连锁规模。工具即将损坏时会自动终止连锁流程，减少玩家因连锁操作误损珍稀工具的情况。 连锁破坏会使用玩家当前工具计算方块掉落，时运、精准采集等原版附魔能够按原版掉落规则影响结果。耐久扣除会参考耐久附魔概率，让高级工具在连锁中保持更符合原版预期的表现。 ### 4. 自动掉落收集 原版方块连锁产生的掉落物会自动收纳至玩家背包，无需手动拾取。若玩家背包已满，掉落物会正常掉落至地面。CraftEngine 方块会走 CraftEngine 适配移除逻辑，具体掉落表现以对应方块配置和 CraftEngine 行为为准。 ## ⚙️ 服主管理能力 ### 1. GUI 可视化管理 服主可通过 `/yc gui` 打开可视化管理界面，无需频繁编辑配置文件，即可管理工具组、绑定工具列表、连锁方块列表、单次连锁上限、耐久消耗规则、功能启用状态等常用核心配置。 ### 2. 快捷指令管理 支持手持物品快速添加/移除连锁工具、手持方块快速添加/移除连锁目标、一键重载配置、开关调试日志等实用指令，日常运维无需重启服务器。 ### 3. 精细化权限管控 区分普通玩家使用权限与管理员管理权限，可自由开关权限检测，适配公开服务器、私密服务器、RPG服务器等不同场景。 ### 4. 预设成熟工具组 插件开箱即用，默认内置四大常用工具组，覆盖服务器绝大多数采集场景： - **镐子组**：适配各类原版矿石、远古残骸挖掘连锁 - **斧头组**：适配各类原木、菌柄砍伐连锁 - **铲子组**：适配沙砾、黏土、灵魂沙、灵魂土挖掘连锁 - **锄头组**：适配树叶、疣块、干草块、海带块、海绵、幽匿系列方块采集连锁 ## 🔍 核心技术原理详解 ### 1. 26 向全维度连通扫描 普通 6 向连通只检测上下左右前后 6 个基础方向，无法识别斜向连通的方块。YiyunChain 采用 **26 向立体扫描算法**，覆盖方块三维空间内所有相邻点位（平面相邻、边角相邻、对角相邻）。 只要同类方块存在任意维度的真实连通关系，就会被纳入扫描候选，并受到 `max_chain`、耐久保护和性能预算等规则限制。它适合弯折矿脉、斜向原木、交错堆叠方块等复杂场景，真正做到「连在一起，就优先按连通关系处理」。 ### 2. 高性能发光预览系统 插件的发光预览机制搭配**数据缓存、差量更新、分批生成、自动回收**四大优化策略。目标未变化时会复用缓存，目标变化时只更新差异部分，并在停止潜行、切换目标或退出服务器时清理预览状态，从而降低重复创建和瞬时开销。 ### 3. 精细化服务器性能控制 针对大范围连锁场景专门优化，不采用一次性加载处理的粗暴模式。通过两个核心参数精准调控服务器负载： - **max\_blocks\_per\_tick**：限制每游戏 tick 处理的最大方块数量，避免单帧运算过载 - **time\_budget\_ms**：限制每 tick 连锁运算的最大耗时，预留服务器资源给其他玩法 连锁任务会按规则分批扫描、分批破坏，降低大规模连锁造成 TPS 波动的风险，更适合对稳定性要求较高的服务器。 ### 4. 轻量化玩家状态保存 YiyunChain 会将玩家的工具组开关状态保存到 Player PDC 中，并在运行时使用内存缓存进行快速读取。 这意味着： - 不需要 MySQL - 不需要 SQLite - 不需要单独维护玩家状态文件 - 玩家开关状态可随玩家数据保存 - 插件安装后即可使用，减少额外部署成本 ## 🔗 拓展插件支持 ### 1. CraftEngine 自定义方块支持（软依赖） 插件无 CraftEngine 时可正常运行。安装 CraftEngine 后，可识别 CraftEngine 自定义方块。服主可通过 `ce:自定义方块ID` 的格式，将自定义方块加入连锁列表，适配 RPG 服、定制服的专属玩法需求。 支持三种方块匹配规则： - 原版精准匹配：`DIAMOND_ORE` - 原版通配匹配：`*_ORE`、`*_LOG` - 自定义方块匹配：`ce:ruby_ore` ### 2. PlaceholderAPI 变量支持（软依赖） 安装 PlaceholderAPI 后，插件自动注册专属变量，可用于计分板、标题、公告、菜单界面等场景，展示玩家连锁状态数据。 **可用变量列表：** - `%yiyunchain_status%`：玩家是否有任意有效工具组处于开启状态 - `%yiyunchain_count%`：玩家当前已开启的有效工具组数量 - `%yiyunchain_total%`：当前配置中的工具组总数量 - `%yiyunchain_tool_<组>%`：指定工具组对该玩家的开启/关闭状态 - `%yiyunchain_tool_<组>_max%`：对应工具组单次连锁上限 - `%yiyunchain_tool_<组>_blocks%`：对应工具组当前匹配到的原版方块数量 - `%yiyunchain_tool_<组>_enabled%`：对应工具组启用状态 ## 📥 安装部署步骤 1. 确保服务端环境满足：Java 21、Paper/Folia 核心、Minecraft 1.21+ 2. 将插件 Jar 包放入服务器 `plugins` 文件夹 3. 启动服务器，插件自动生成配置文件，无需手动初始化 4. （可选）安装 CraftEngine、PlaceholderAPI 启用对应扩展功能 5. 使用 `/yc gui` 进入可视化界面，根据服务器需求微调配置即可开箱即用 ## 📜 指令与权限 ### 核心指令（别名：/yiyunchain、/ychain、/yc） | 指令 | 功能说明 | | --------------------- | ------------------------ | | `/yc gui` | 打开可视化管理GUI界面 | | `/yc reload` | 重载插件配置，并清空旧预览与正在执行的旧连锁任务 | | `/yc debug` | 开关插件调试日志输出 | | `/yc addtool <组>` | 将手持物品添加至指定工具组 | | `/yc addblock <组>` | 将手持方块添加为指定工具组连锁目标 | | `/yc removetool <组>` | 从指定工具组移除手持物品 | | `/yc removeblock <组>` | 从指定工具组移除手持连锁方块 | | `/yc help` | 查看插件指令帮助 | ### 权限节点 | 权限节点 | 权限说明 | 默认权限 | | ------------------ | -------------- | ---------- | | `yiyunchain.use` | 玩家使用连锁挖掘功能 | 全部玩家（true） | | `yiyunchain.admin` | 使用管理指令、GUI配置界面 | OP | ## 📝 配置文件示例 ### 全局基础配置（config.yml） ```yaml settings: max_blocks_per_tick: 100 time_budget_ms: 5 default_enabled: true check_permission: false auto_collect: true durability_protection: true toggle_actionbar: true toggle_sound: true chain_particles: true debug: false chain_glow: true ``` ### 工具组配置示例 ```yaml tool_groups: pickaxes: display: "<yellow>镐子" tools: - DIAMOND_PICKAXE - NETHERITE_PICKAXE - IRON_PICKAXE rules: enabled: true max_chain: 300 consume_durability: true blocks: - DIAMOND_ORE - DEEPSLATE_DIAMOND_ORE - "*_ORE" - "ce:custom_block" ``` ## ❓ 常见问题 FAQ #### Q：插件是否支持旧版本服务端？ A：插件基于 Minecraft 1.21+ API 开发，建议在 Paper / Folia 1.21+ 环境中使用并实际测试。 #### Q：Folia服务端使用会报错、卡顿吗？ A：插件按 Folia 调度模型进行适配，方块操作走区域调度，玩家相关操作走实体调度。经过大量实测，不会出现任何服务器连锁会卡顿的现象，如有卡顿现象请及时反馈。 #### Q：为什么没有半径配置选项？ A：本插件舍弃传统半径判定逻辑，连锁范围由**方块真实连通关系**和 **max\_chain 单次连锁上限**决定，无需半径参数，判定更贴近真实连接结构。 #### Q：自定义方块无法连锁怎么办？ A：确认已安装CraftEngine插件，使用`ce:方块ID` 格式添加至对应工具组的方块列表即可正常识别。 #### Q：如何限制玩家单次最大连锁数量？ A：在对应工具组配置中修改 `max_chain` 参数，即可单独设置该工具的单次连锁上限，精准控制玩法平衡。 ## 🏁 总结 YiyunChain 逸云连锁摒弃传统半径连锁思路，以**真实连通扫描**为核心，搭配性能调控、可视化交互、原版附魔友好、PDC 轻量状态保存、软依赖扩展和高自由度配置，针对普通连锁插件常见的判定不准、瞬时压力高、适配性弱、管理繁琐等痛点进行优化。 插件稳定、精准、可控，兼顾玩家体验与服务器稳定性，适合作为生存服、商业服、RPG 服、玩法服等正式服务器的高级连锁挖掘方案。 [/MD]