导出是将当前世界保存为服务器和游戏中使用的文件。可以一次性生成资源包、服务器注册表、.npbuild、.schem 和 Minecraft 世界文件夹。导入是将 .schem 原理图或 Minecraft 世界中的某个范围读入编辑器并粘贴。
| 内容 | 打开位置 |
|---|
| 导出窗口 | 构建 › 导出: 资源包片段 · .npbuild(Ctrl+Shift+E) |
| 直接保存为 Minecraft 世界 | 构建 › 保存为 Minecraft 世界… |
| 仅资源包 | 构建 › 构建资源包(资源包与 HUD) |
| markers.json | 构建 › 导出: markers.json(服务器标记) |
| 导入 .schem | 文件 › 导入: .schem(Sponge 原理图),或导出窗口中的「导入 .schem」 |
| 导入世界 | 导出窗口中的「导入世界」 |
- 按 Ctrl+Shift+E 打开导出窗口。
- 在「目标」中勾选要生成的内容(资源包 · 服务器注册表 · .npbuild · .schem · 世界存档(.mca))。
- 选择「目标版本」(默认 1.21.11)。
- 选择「范围」(整个世界 · 分区域 / 整个世界 · 单个文件 / 仅选区)。
- 点击「导出」。
- 用「打开文件夹」图标打开结果文件夹。「日志」中会显示生成的文件和警告。
- 点击 构建 › 保存为 Minecraft 世界…,并选择文件夹。
- 将生成的
<名称>_world 文件夹复制到 %APPDATA%\.minecraft\saves\。
- 在 Minecraft 单人游戏列表中打开。这是一个创造模式 · 固定正午 · 无生物的世界。
| 目标 | 生成的内容 | 用途 |
|---|
| 资源包 | 完整资源包(独立)或片段 zip | 服务器资源包 |
| 服务器注册表 | <名称>_registry_vN.json | 服务器插件(自定义方块 · 道具 · 物品) |
| .npbuild | 服务器 build 模块安装文件 — 方块实体 · 道具 · 组,开启「包含标记」时含 markers.json,开启「包含场景」时含 scene.json | 服务器插件 |
| .schem | Sponge v3 原理图 | WorldEdit · FAWE |
| 世界存档(.mca) | level.dat + region/*.mca + entities/*.mca | 单人游戏 · 服务器世界 |
- scene.json 包含场景 Actor、动画和世界逻辑规则。它不单独导出为文件,而是放在 .npbuild 中(scene.json 格式)。
- 存在音源 · 方块声音时,导出服务器注册表时还会生成
<名称>_sounds_server_vN.json。
| 内容 | 备注 |
|---|
| 方块状态 | 保持朝向 |
| 告示牌文字 | 双面 · 颜色 · 发光 · 涂蜡 |
| 旗帜图案 · 箱子名称 | — |
| 箱子内的物品 | 从导入的世界 · 原理图中读取的内容 |
| 道具 | item_display(1.21.4+)— 与服务器方式相同 |
| 自定义方块 | 替代方块(默认品红色羊毛)或音符盒状态(需要资源包) |
| 字段 | 值 | 含义 |
|---|
| 目标版本 | 1.20.1 ~ 1.21.11 | .schem DataVersion · .npbuild 头部 · 方块检查的基准。 |
| 方块列表 | 留空则自动 | 服务器 jar 报告 blocks.json。 |
| 缺失方块 | 仅警告表(保持原样) · 按建议替换 · 不导出 | 如何处理目标版本中不存在的方块 · 属性 |
| 范围 | 整个世界 · 分区域 / 整个世界 · 单个文件 / 仅选区 | 选区会自动带入。 |
| 区域大小 | 默认 256(16 的倍数) | 分区域时每个区域的边长。 |
| 空气格 | 清空(与编辑器一致) · 保持原样(叠加) | 安装到服务器时空气格的处理方式 |
| 包含标记 | 开 | 将范围内的标记放入 .npbuild。 |
| 包含场景 | 开 | 将 scene.json 放入 .npbuild。 |
| .schem 自定义 | 空气(仅原版) · 音符盒状态 | 在 .schem 中写入自定义方块的方式 |
| 负载预算检查 | 开 | 存在超出的区块时进行询问。 |
| 忽略错误 | 关 | 即使有错误也生成文件(用于审查)。 |
| 字段 | 值 |
|---|
| 位置偏移 | 按 X · Y · Z 平移后写入。 |
| 地面以下 | 留空 · 用石头填充(最底层基岩) |
| 外围地形 | 虚空(仅建筑) · 平坦 |
| 自定义方块 | 替代方块 + 警告 · 音符盒状态(需要资源包) |
| 替代方块 | 默认 minecraft:magenta_wool |
| 方块实体 | 写入告示牌文字 · 旗帜 · 箱子名称等内容(默认开启) |
| 道具 | 将道具写为 item_display(默认开启,1.21.4+) |
| 写入后校验 | 写入后重新读取,逐格校验(默认开启) |
| 字段 | 含义 |
|---|
| 输出文件夹 | 留空则为 <项目>/export。 |
| 文件名 | 文件名的前缀部分。留空则为世界名称。 |
| 要合并的 RP | 片段方式中要合并的已有资源包(只读)。 |
| 导入 | 字段 | 结果 |
|---|
| .schem | 文件 ·「音符盒转为自定义」(默认开启) | 读取 Sponge v1~v3 并交给粘贴工具。 |
| 世界 | 世界文件夹(含有 level.dat 的文件夹)· 范围起点 · 范围终点(Minecraft 坐标) | 粘贴该范围内的方块 · 方块实体 · 道具。 |
- 也会读取告示牌、旗帜、箱子名称和箱子物品。
- 未知方块以占位符保留,并以列表形式提示。
- 由编辑器 · 服务器放置的
item_display 道具会还原为编辑器道具。
- 不导入其他实体(生物 · 物品展示框等)。
- 只读取 1.18 及以上版本的世界。范围过大时会以「范围过大」拒绝。
| 版本 | 世界存档 |
|---|
| 1.20.1 · 1.21.1 | 支持。不写入道具。 |
| 1.21.4 ~ 1.21.11 | 支持。也写入道具。1.21.11 为默认。 |
| 1.18.2 | 不导出(仅导入)。选择后会发出警告,并以 1.20.1 格式写入。 |
| 26.x | 以 1.21.11 格式写入,由游戏进行升级。 |
更详细的版本说明见 Minecraft 版本。
- 导出不会覆盖。已有同名文件时,会附加
_v2 · _v3 …。
- 完整资源包会像
<名称>_rp_vN.zip 这样附带版本号。
- 世界文件夹为
<名称>_world。
| 键 | 动作 |
|---|
| Ctrl+Shift+E | 导出窗口 |
| Esc | 关闭导出窗口 |
- 有错误时不会生成文件。请先修正「日志」中的
[错误] 行。
- 要使道具大小准确,请同时勾选资源包。否则会以大小 1 为基准写入并发出警告。
- 将箱子物品导出到不同格式时代(1.20.5 之前/之后)时,名称 · 附魔会丢失,只保留种类 · 数量。
- 资源包 · 服务器注册表请按服务器
plugins 文件夹的设置上传。资源包的 SHA-1 行位于 .sha1.txt 中。