任务与队列
文档/easier-building/任务与队列

任务与队列

建造与拆除任务的执行方式、暂停原因、恢复与取消规则。

任务是什么

选点完成后,建造或拆除操作会提交为一个任务,进入智能队列分帧执行。插件把大量方块操作分摊到多个游戏刻,避免一帧卡死服务器,同时实时向玩家反馈进度。

任务状态

状态含义
运行中正在逐帧处理方块
已暂停因材料不足、额度不足等原因挂起,可手动继续
已取消被玩家或管理员取消
已完成全部方块处理完毕

每个方块的结果分为三类:成功跳过(如被保护插件拦截、工具不匹配)、失败。任务完成时会在聊天栏汇总:任务完成:成功 <n>,跳过 <n>,失败 <n>

任务菜单

打开 /eb → 任务菜单,可以看到:

  • 任务摘要:状态、类型、处理进度(已处理 / 总数)、成功 / 跳过 / 失败数量;
  • 继续任务:恢复被暂停的任务;
  • 取消任务:取消当前任务(不可恢复)。

暂停与恢复

任务可能在以下情况自动暂停:

暂停原因说明如何处理
材料不足建造消耗背包方块,材料不够时暂停补充材料后到任务菜单点「继续任务」
优先工具不可用使用优先工具的破坏或实体替换任务没有可用工具修理或补充优先工具后点「继续任务」,详见优先工具列表
额度不足公平用量计划的配额耗尽额度刷新后继续,参见公平用量
玩家离线任务所有者在任务期间下线重新上线后继续(取决于管理员配置,可能直接取消)
保护拦截大量方块被保护插件拒绝检查领地 / 权限后继续
连续失败失败次数达到 64 次检查选点和配置后继续
区块卸载 / Folia 区域不安全目标区域不在安全执行范围回到对应区域后继续

恢复方式:打开 /eb → 任务菜单 → 继续任务。

注意:材料不足暂停的恢复需要手动点击继续(默认配置下不会自动恢复)。每个玩家最多同时挂起 3 个暂停任务;达到上限后新的暂停任务会被直接取消。

运行限制

限制默认值说明
每玩家同时运行任务数1已有运行中任务时,新提交会被拒绝
每玩家暂停任务数3超过上限的暂停任务会被取消
单次操作最大方块数10000超限提交会被拒绝
每玩家每刻方块数2基准速度,受工具亲和性影响
全服每刻方块数上限512所有玩家共享
每刻处理时间预算2ms防止任务拖垮服务器 tick

材料消耗

  • 放置操作真实消耗背包中的方块(创造模式与拥有豁免权限的玩家除外);
  • 消耗顺序:启用材料背包且拥有权限时,材料背包 → 背包存储槽 →(开启「消耗潜影盒」时)背包内潜影盒中的同类方块;材料背包的使用条件和 Shift 操作详见材料背包,潜影盒规则详见从潜影盒消耗材料
  • 拆除操作按任务来源消耗工具耐久:未配置优先工具时使用主手,配置后按优先工具列表顺序消耗,且不会回退到主手(生存模式,效率附魔按原版规则减免);
  • 可覆盖实体方块的替换任务会在同一个执行单元内先破坏、后放置,因此一个实体方块会分别消耗一次破坏额度和一次放置额度;
  • 材料不足时任务暂停而不是失败,这正是「建筑助力」而非「刷方块作弊」的体现。

常见问题

任务卡在暂停状态,点继续也没反应?

如果已经有一个任务在运行,恢复操作会被拒绝(运行任务上限为 1)。先等当前任务完成或取消,再继续暂停的任务。

为什么补充了主手工具,替换任务仍然暂停?

替换实体方块的任务创建时会记录「使用优先工具」。优先工具耗尽后不会回退到主手,请在个人设置 → 优先工具中修理或补充工具,再继续任务。

为什么任务处理得很慢?

每玩家每刻的基础额度是 2 个方块,持有效率附魔的工具(或配置调高 blocks-per-tick-per-player)可以显著提速。拆除速度同时受工具亲和性倍率影响。

下线后任务会怎样?

默认配置下任务会暂停(玩家离线原因),重新上线后可继续;管理员可以配置为直接取消(cancel-task-when-player-offline)。