优先工具列表
文档/easier-building/优先工具列表

优先工具列表

为破坏与实体替换任务配置独立的、有序耐久工具列表,避免替换绕过工具消耗。

功能是什么

优先工具列表是每位玩家独立的一组虚拟工具栏。它不占用主手或副手,专门为队列中的批量破坏和实体方块替换提供工具。

它解决了替换模式直接覆盖已有方块、绕过破坏阶段工具耐久与保护检查的问题:替换实体方块时,插件会先执行破坏阶段,再执行放置阶段。

配置优先工具

  1. 打开 /eb个人设置优先工具
  2. 把工具放入 GUI 的材料槽位,点击「保存优先工具」;
  3. 槽位从前到后就是消耗顺序,排在前面的工具会优先使用。

只有同时满足以下条件的物品可以放入:

  • 是有耐久度的工具;
  • 材质位于管理员配置的 breaking.tool-affinity.allowed-tool-materials 列表中。

工具会以独立状态保存,包括材质、当前耐久、附魔和不可破坏属性。取出工具后可以在铁砧等界面修理,再重新放入列表。点击「清空优先工具」会清空列表并把工具返还玩家;背包放不下时会掉落在玩家附近,不会静默丢失。

消耗规则

场景使用的工具
破坏任务 + 工具列表为空保持原有逻辑,使用主手工具
破坏任务 + 工具列表非空按列表顺序使用优先工具,耗尽后暂停,不会回退到主手
使用可覆盖实体方块的替换策略必须使用优先工具;破坏阶段和放置阶段在同一个队列执行单元中完成

任务在创建时会记录是否使用优先工具。因此,任务开始后清空列表不会让它改用主手;列表中的工具全部损坏、被工具亲和性跳过,或在启用工具保护时剩余耐久小于等于 5,任务会暂停并提示补充或修理优先工具。补充工具后,打开 /eb任务菜单 →「继续任务」即可恢复。

启用「个人设置 → 工具保护」时,低于保护阈值的工具会被跳过并保留在列表中,方便取出修理。效率附魔继续影响处理速度,耐久附魔继续按原版概率减免耐久消耗。管理员将 breaking.consume-tool-durability 设为 false 时,任务仍遵循现有配置,不会实际扣除工具耐久。

与替换策略的关系

只有「仅空气」不会主动覆盖实体方块,不要求优先工具。以下策略都可能选中实体方块,因此切换前必须先配置至少一个优先工具:

策略是否需要优先工具
仅空气(AIR_ONLY
空气与方块(BLOCKS_AND_AIR
仅方块(BLOCKS_ONLY
副手匹配(OFFHAND_FILTER
白名单(WHITELIST

没有配置优先工具时,这些替换策略的按钮会显示「需要在个人设置里配置优先工具,当前优先工具未配置」,点击后不会切换策略。即使策略已经用于任务,之后清空列表也只会让需要破坏的任务安全暂停,不会绕过工具检查。

替换实体方块时会发生什么

  • 空气目标只执行放置阶段,消耗一次放置额度;
  • 实体方块目标先完成破坏预检、保护校验、BlockBreakEvent 和工具耐久检查,再执行放置,分别消耗一次破坏额度和一次放置额度;
  • 破坏阶段失败、被保护插件拦截、额度不足或工具不可用时,不会进入放置阶段,游标也不会推进;
  • 替换仍然不掉落旧方块,但会保留破坏事件、权限、黑名单、方块实体保护和领地保护校验。

详细的目标筛选和替换建议见替换策略;工具速度、允许材质和破坏保护见工具亲和性