WorldEdit
[!INFO] Git Commit:
e5623ac| Updated: 2026-10-02
modid worldedit，资源域 worldedit，工作目录 <config>/worldedit/。本条目分类名 worldedit-gtnh 与 modid 不同：分类名带了 -gtnh 后缀以区分 GTNH 分支，modid 本身仍是无后缀的 worldedit。资源域与 modid 相同，均为 worldedit。
WorldEdit 是一个纯指令/工具型世界编辑模组：它在游戏中不注册任何方块、物品、实体、TileEntity 或合成配方（grep -rn 'GameRegistry\.|registerBlock|registerItem|registerTileEntity' src/main/java 全部为 0 命中），全部能力以 137 条指令、一套配置文件、一个参考手册 GUI 和若干存档格式的形式提供。
版本判定依据 gradle.properties:24 的 minecraftVersion = 1.7.10（:27 为 forgeVersion = 10.13.4.1614），由 RetroFuturaGradle 约定插件 com.gtnewhorizons.gtnhconvention 构建。本仓不使用 git describe 判定版本：这是一个 depth-1 浅克隆，git describe 返回 v0.0.10（指向 HEAD e5623ac），是分支自身的版本方案而非 MC 版本号。
入口类唯一：com.sk89q.worldedit.forge.ForgeWorldEdit（@Mod 位于 ForgeWorldEdit.java:73-78，MOD_ID = "worldedit" 在 :82）。全仓 @Mod( 仅此 1 处。构建使用 generateGradleTokenClass = com.sk89q.worldedit.WETags 生成的版本令牌（WETags.java 不在源码树中，由 Gradle 生成）。
依赖：硬依赖为 Forge 1.7.10 + de.schlichtherle:truezip + rhino:js + org.yaml:snakeyaml + Guava + JSR-305 + Gson + CodeChickenCore（implementation）；内嵌（shadowImplementation）为 jchronic、paranamer、jlibnoise。软依赖为 ForgeMultipart、ArchitectureCraft、CarpentersBlocks（@Mod 中只写 after:，运行时用 Loader.isModLoaded 判断）与 NotEnoughItems（runtimeOnlyNonPublishable）。注意：mcmod.info 把 ForgeMultipart 写成硬依赖 "dependencies": ["ForgeMultipart"]，与注解里的 after: 不一致。CodeChickenCore 在代码中只被 ForgeMultipartExistsCompat 用于 codechicken.multipart 两个类，是 ForgeMultipart 的底层库而非通用 CCLib。
本条目的 1.7.10 与其它 MC 版本内容已隔离：仓内不含其它 MC 版本的源码树，无 1.12/1.16/1.20 分支代码混编。版本专属特征（数字 ID ↔
minecraft:命名空间桥blocks.json、172 条方块记录）集中在 平台与能力 API 中标注。
指令列表
- 指令树与注册机制 - 137 条指令如何组装成 6 个根指令，以及
//双斜杠拼写规则 - 选区指令 - 16 条：
//pos1//pos2//wand//sel//size等 - 区域指令 - 21 条：
//set//replace//move//regen等 - 生成类指令 - 10 条：
//sphere//cyl//pyramid//generate等 - 工具与环境指令 - 22 条：
//fixlava//calc//limit//gmask等 - 移动、历史与脚本指令 - 12 条：
/jumpto//undo//redo/cs等 - 剪贴板指令 - 8 条：
//copy//paste//rotate//load等 - 生物群系与区块指令 - 6 条：
/biomelist/chunkinfo/delchunks等 - 工具与超级镐指令 - 17 条：
/tree/floodfill/superpickaxe area等 - 刷子指令 - 14 条：
/brush sphere/brush raise等 - Schematic 与快照指令 - 11 条：
/schematic load/snapshot list/restore等 - 世界编辑管理指令 - 6 条：
/worldedit versionreloadtzreloadmappings等
配置列表
- worldedit.properties 配置项 - 35 个实际读取的配置键、4 个死配置项与跨平台缺口
- 旋转映射（分支新增） -
<config>/worldedit/mappings/*.json，模组方块的旋转规则
会话与存档列表
- 会话与存档 -
sessions/<id>.json的绑定时机、存了什么、为什么不存剪贴板 - 剪贴板与 schematic 格式 - 唯一格式
SCHEMATIC（mcedit/mce/schematic）
集成列表
- 方块变换钩子 - ForgeMultipart / ArchitectureCraft / CarpentersBlocks / 旋转映射四个钩子
- 可选模组支持 - NEI、CUI 协议（入站未注册）、参考手册 GUI
API 列表
编辑操作列表
- 编辑会话与历史 -
EditSession、历史上限 15 的硬下限、撤销/重做模型