minecraft-worldedit-ops

Minecraft WorldEdit Operations Skill

范围与定位

此技能用于在运行中或暂存服务器上操作 WorldEdit。
不用于编写集成 WorldEdit API 的插件代码。

路由边界

• Use when：任务是在游戏内通过命令使用 WorldEdit 进行编辑（选区、变换、原理图、地形塑造、可安全回滚的工作流）。
• Do not use when：任务是 Java 插件实现（minecraft-plugin-dev）。
• Do not use when：任务涉及广泛的服务器部署／调优／代理／备份策略（minecraft-server-admin）。
• Do not use when：任务涉及 EssentialsX 命令／经济／管理工作流（minecraft-essentials-ops）。

---

平台和设置说明

WorldEdit 常用于：

• 通过 WorldEdit 插件运行的 Paper/Purpur/Folia 服务器
• 通过模组变体运行的 Fabric/NeoForge

运维最佳实践：

1. 在暂存环境或维护时段进行大型编辑。
2. 在执行主要区域操作前保留自动备份。
3. 执行破坏性命令前，使用保守的选区和遮罩约束。

兼容性说明：WorldEdit 7.4.x 有适用于 1.21.x、26.1 和 26.2 的构建版本。 选择针对确切服务器版本列出的构建版本，并在暂存环境中测试后， 再用于生产世界。

参考资料

• 在进行大型粘贴、破坏性替换，或任何回滚规范比速度更重要的编辑前，请阅读 references/safety-checklists.md。

---

核心选区工作流

选区模式

最常见的长方体选区流程：

//wand
//pos1
//pos2
//size

快捷替代方式：

//hpos1
//hpos2
//chunk
//expand 20 up
//expand 20 down

选区安全检查：

• 在运行 //set 或 //replace 前，务必运行 //size
• 在运行 //paste 前，使用与实际粘贴计划相同的放置标志运行 //paste -n，预览目标位置（例如 //paste -n -a 或 //paste -n -o），然后运行 //size 并检查所选目标区域
• 使用 //distr 在替换前预览方块组成

---

区域操作

高频操作

//set stone
//replace stone andesite
//replace water air
//walls stone_bricks
//overlay grass_block
//smooth 3

遮罩和筛选替换

使用遮罩限制作用范围：

//gmask #existing
//replace grass_block dirt
//gmask

单命令遮罩方式：

//replace stone,andesite,diorite,granite smooth_stone
//replace ##leaves air

模式示例：

//set 70%stone,20%andesite,10%cobblestone
//replace dirt 60%coarse_dirt,40%podzol

---

剪贴板和原理图工作流

剪贴板基础

//copy
//rotate 90
//flip east
//paste -a

如果想在粘贴时跳过空气方块，请使用 -a。

原理图工作流

//schem save spawn-hub-v3
//schem list
//schem load spawn-hub-v3
//paste -n -a
//size
//paste -a

运维建议：

• 使用带版本信息的名称（arena-mid-2026-03-27）
• 保留只读归档副本以便回滚
• -n 会将选区更改为计划的目标位置，但不会放置方块；预览和实际粘贴时的 -a、-o 及其他放置标志应保持一致
• 每次主要粘贴后立即创建备份检查点

---

画笔和地形塑造

实用的画笔设置

//brush sphere stone 4
//brush smooth 3
//brush raise sphere 2
//brush lower sphere 2
//mask #existing

重置画笔：

//none

地形塑造安全注意事项：

• 从较小半径（3-5）开始，逐步调整
• 保持遮罩启用，避免损坏建筑
• 定期保存原理图或备份检查点；//undo 可撤销编辑

---

撤销、历史记录和安全

历史记录命令

//undo
//undo 5
//redo

生产环境操作的安全策略：

1. 创建备份检查点。
2. 执行一批逻辑上完整的编辑。
3. 通过目视检查进行验证。
4. 继续操作，或立即运行 //undo。

不要在没有中间验证的情况下连续执行多项破坏性编辑。 只有在编辑已获接受、存在备份或原理图检查点，并且回滚窗口已关闭后， 才运行 //clearhistory。

---

实用操作手册

操作手册：刷新出生点区域

• 选择出生点区域并运行 //size。
• 创建快照：

//copy
//schem save spawn-before-refresh

• 应用受约束的替换和覆盖。
• 平整地形边缘：

//smooth 2

• 验证出生点安全性（虚空、照明、导航）。
• 如有需要，重新选择编辑后的区域，然后在保存前复制最终状态：

//copy
//schem save spawn-after-refresh

操作手册：比赛间重置竞技场

• 保留一份原始放置位置有记录的完好竞技场蓝图。
• 每场比赛后：

//schem load arena-pristine
//paste -n -o
//size
//paste -o

• 预览后检查选定的目标位置，然后使用相同的 -o 原点标志粘贴。包含空气方块，以移除玩家添加的方块；使用 -a 会保留这些方块。恢复实体和生物群系需要有意指定复制／粘贴标志，并单独验证。
• 验证与竞技场逻辑相关的命令方块／信号。

操作手册：方块清理（卡顿与视觉杂乱）

常见清理目标：

• 丢弃的脚手架建筑
• 意外扩散的流体
• 过多残留的树叶／原木

清理序列示例：

//replace lava air
//replace water air
//replace ##leaves air

务必先设置选区／蒙版，避免意外修改整张地图。

操作手册：路径塑形与地形融合

• 选定走廊／路径范围。
• 构建混合表面：

//set 50%dirt_path,30%coarse_dirt,20%gravel

• 使用低半径平滑笔刷融合边缘。
• 在高程变化处添加挡土边界（stone_bricks、andesite）。

---

操作守则

• 切勿在全局／世界范围内执行大范围替换。
• 每次执行破坏性命令前，确认选区大小。
• 为每个主要建筑区域保留一份还原蓝图。
• 与其他工作人员协调编辑，避免操作重叠。
• 按角色验证 WorldEdit 限制／权限，防止意外进行大范围编辑。

---

参考资料

• https://worldedit.enginehub.org/en/latest/
• https://worldedit.enginehub.org/en/latest/usage/
• https://worldedit.enginehub.org/en/latest/usage/regions/selections/
• https://worldedit.enginehub.org/en/latest/usage/general/masks/
• https://worldedit.enginehub.org/en/latest/usage/clipboard/
• https://worldedit.enginehub.org/en/latest/usage/tools/brushes/