优先工具列表
为破坏与实体替换任务配置独立的、有序耐久工具列表,避免替换绕过工具消耗。
功能是什么
优先工具列表是每位玩家独立的一组虚拟工具栏。它不占用主手或副手,专门为队列中的批量破坏和实体方块替换提供工具。
它解决了替换模式直接覆盖已有方块、绕过破坏阶段工具耐久与保护检查的问题:替换实体方块时,插件会先执行破坏阶段,再执行放置阶段。
配置优先工具
- 打开
/eb→ 个人设置 → 优先工具; - 把工具放入 GUI 的材料槽位,点击「保存优先工具」;
- 槽位从前到后就是消耗顺序,排在前面的工具会优先使用。
只有同时满足以下条件的物品可以放入:
- 是有耐久度的工具;
- 材质位于管理员配置的
breaking.tool-affinity.allowed-tool-materials列表中。
工具会以独立状态保存,包括材质、当前耐久、附魔和不可破坏属性。取出工具后可以在铁砧等界面修理,再重新放入列表。点击「清空优先工具」会清空列表并把工具返还玩家;背包放不下时会掉落在玩家附近,不会静默丢失。
消耗规则
| 场景 | 使用的工具 |
|---|---|
| 破坏任务 + 工具列表为空 | 保持原有逻辑,使用主手工具 |
| 破坏任务 + 工具列表非空 | 按列表顺序使用优先工具,耗尽后暂停,不会回退到主手 |
| 使用可覆盖实体方块的替换策略 | 必须使用优先工具;破坏阶段和放置阶段在同一个队列执行单元中完成 |
任务在创建时会记录是否使用优先工具。因此,任务开始后清空列表不会让它改用主手;列表中的工具全部损坏、被工具亲和性跳过,或在启用工具保护时剩余耐久小于等于 5,任务会暂停并提示补充或修理优先工具。补充工具后,打开 /eb → 任务菜单 →「继续任务」即可恢复。
启用「个人设置 → 工具保护」时,低于保护阈值的工具会被跳过并保留在列表中,方便取出修理。效率附魔继续影响处理速度,耐久附魔继续按原版概率减免耐久消耗。管理员将 breaking.consume-tool-durability 设为 false 时,任务仍遵循现有配置,不会实际扣除工具耐久。
与替换策略的关系
只有「仅空气」不会主动覆盖实体方块,不要求优先工具。以下策略都可能选中实体方块,因此切换前必须先配置至少一个优先工具:
| 策略 | 是否需要优先工具 |
|---|---|
仅空气(AIR_ONLY) | 否 |
空气与方块(BLOCKS_AND_AIR) | 是 |
仅方块(BLOCKS_ONLY) | 是 |
副手匹配(OFFHAND_FILTER) | 是 |
白名单(WHITELIST) | 是 |
没有配置优先工具时,这些替换策略的按钮会显示「需要在个人设置里配置优先工具,当前优先工具未配置」,点击后不会切换策略。即使策略已经用于任务,之后清空列表也只会让需要破坏的任务安全暂停,不会绕过工具检查。
替换实体方块时会发生什么
- 空气目标只执行放置阶段,消耗一次放置额度;
- 实体方块目标先完成破坏预检、保护校验、
BlockBreakEvent和工具耐久检查,再执行放置,分别消耗一次破坏额度和一次放置额度; - 破坏阶段失败、被保护插件拦截、额度不足或工具不可用时,不会进入放置阶段,游标也不会推进;
- 替换仍然不掉落旧方块,但会保留破坏事件、权限、黑名单、方块实体保护和领地保护校验。