区域清理器

区域清理器

一个强大的服务器管理工具,专为在大范围内移除方块和实体而设计,且不会造成服务器卡顿。包含智能进度条和撤销功能。

管理

Zone Cleaner

极致无卡顿的世界编辑器

MCreaHub NeoForge Fabric Forge GitHub License

删除数百万个方块,而不会掉一点 TPS。

Zone Cleaner 是一款服务端管理工具,旨在安全地执行大规模世界编辑操作。与可能导致服务器冻结的 WorldEdit 或原版命令不同,Zone Cleaner 使用时间切片引擎和物理抑制来清理世界,同时你可以继续游玩。

报告 Bug


⚡ “忍者”引擎(3.1.0 新增)

该模组已完全重新架构。它现在使用 Flag 18 绕过标准方块更新。

  • 无光照重算:移除一座山不会因计算阴影而冻结服务器。
  • 无物理:沙子和沙砾不会下落,水不会流动,侦测器不会触发。
  • 零卡顿:操作被切分为微小的微任务,分散到服务器 tick 中执行。

🎚️ 侵略等级(1 到 5)

由你掌控。在命令末尾添加数字来选择任务允许使用的 CPU 性能。

等级 名称 描述 使用场景
1 幽灵 0.5ms / tick。不可见的后台任务。 清理时继续游玩。零影响。
2 安全 5ms / tick。平滑流畅。 默认的均衡用量。
3 普通 20ms / tick。标准速度。 管理员维护。
4 快速 50ms / tick。使用完整的 tick 预算。 当你希望尽快完成时。
5 NUCLEAR 500ms / tick。强制卡顿。 挂机进行大规模破坏。比普通快 10 倍。

🛠️ 命令

需要管理员等级 4。

1. 定义区域

对于超大区域,使用这些命令标记角点(类似 WorldEdit)。

  • /pos_start:在你脚下设置第一个角点。
  • /pos_end:在你脚下设置第二个角点。

2. 移除方块

语法: /remove block <coords> <block> [level]

从基岩到天空,清理 5000 方块半径内的所有*沙子(等级 4 - 快速):*

/remove block ~ min ~ ~5000 max ~5000 minecraft:sand 4

清理由 pos_start/end 定义的特定区域(等级 1 - 静默):

/remove block pos_start pos_end minecraft:stone 1

手动坐标(等级 5 - 核弹):

/remove block 0 60 0 100 100 100 minecraft:dirt 5

3. 移除实体

立即清除所选区域内的实体。

  • /remove entity pos_start pos_end all(杀死所有生物/物品,保留玩家)
  • /remove entity ~ -64 ~ ~100 320 ~100 minecraft:zombie

4. 实用工具

  • /remove stop:紧急停止。 立即终止当前后台任务。
  • /remove undo:使用安全调度器逐方块还原上一次操作。

📉 兼容性

  • 仅服务端:客户端无需安装该模组即可加入。
  • 语言:消息会根据玩家客户端语言自动翻译(包含英语和法语)。

📚 3.1.0 之前版本的文档

性能

Zone Cleaner 从底层设计上就尊重你的服务器性能。其他工具会立即执行命令并造成巨大的卡顿峰值,而 Zone Cleaner 会将每个大型任务拆解为微小的、可管理的片段。

它会智能监控服务器的每 tick 平均峰值(MSPT),并为每个 tick 动态分配“工作量预算”。如果服务器繁忙,它就少做一些。如果服务器空闲,它就多做一些。结果呢?即使正在清理数百万个方块,你的服务器也能保持完美的 20 TPS。

特性

  • 动态防卡顿引擎:一个根据服务器实时性能逐步处理操作的调度器。
  • 智能撤销系统:使用同样的无卡顿系统还原最近 5 次方块移除操作。
  • 动作栏进度更新:在动作栏上获取实时百分比反馈。
  • 灵活选区:使用绝对坐标、相对位置(~)或世界边界(min/max)。对于更大的区域,使用 /pos_start 和 /pos_end 设置点。
  • 完全掌控:每个玩家同一时间只能运行一个任务。使用 /remove stop 立即停止当前操作。

命令

所有命令均为服务端命令,需要管理员权限。

位置选择 对于大型区域,先设置起点和终点会更方便。

  • /pos_start:将你的当前位置保存为第一个角点。
  • /pos_end:将你的当前位置保存为第二个角点。

方块移除 核心的方块移除命令。

要清除 y=64 处 100x100 区域的石头:

/remove block 0 64 0 100 64 100 minecraft:stone

要从你的位置周围 50 方块半径内、从世界底部到顶部移除所有沙子:

/remove block ~-50 min ~-50 ~50 max ~50 minecraft:sand

使用已保存的位置排干一片海洋:

# 前往海洋的一个角并运行 /pos_start
# 前往对面的角并运行 /pos_end
/remove block pos_start pos_end minecraft:water

实体移除 快速且安全地从区域中移除实体。此命令即时执行,不使用防卡顿调度器。

要移除大片区域内的所有僵尸:

/remove entity 0 0 0 1000 255 1000 minecraft:zombie

要从之前保存的区域清除所有敌对生物:

# 先设置好你的 /pos_start 和 /pos_end
/remove entity pos_start pos_end all

(除非指定,否则不会移除玩家或非敌对实体。)

实用工具

  • /remove undo:使用无卡顿引擎还原上一次移除操作中的方块。最多可使用 5 次。
  • /remove stop:立即取消你当前正在运行的任务。

技术细节

Zone Cleaner 的性能并非魔法,而是工程。

  • 仅服务端:无需安装客户端。
  • 基于 tick 的调度器:挂接 ServerTickEvent.Post,在该 tick 的主游戏逻辑完成后执行工作。
  • 动态工作负载均衡:
    1. 实时测量服务器 MSPT。
    2. 维护滚动平均值以平滑瞬时峰值。
    3. 根据可用性能为每个 tick 计算纳秒级“工作预算”。
    4. 如果任务超出预算,则让出,并在下一个 tick 自动继续。
  • 安全且同步:所有方块操作都在服务器主线程上执行,保证世界存档完整性并防止并发问题。
  • 高效撤销:使用内存高效的 BlockSnapshot 记录和 LinkedList 来快速追踪最近 5 次操作的历史记录。

这一架构确保 Zone Cleaner 是适用于任何生产服务器的强大且安全的工具。