Minecraft 版本
目标版本是用于制作地图的 Minecraft 版本。方块列表、纹理和导出检查都遵循该版本。默认为 1.21.11。编辑器会在本机的启动器文件夹中查找同一版本的客户端 jar，并读取原版纹理。不会复制或解压 jar。
| 内容 | 打开位置 |
|---|---|
| 选择目标版本 | 菜单栏右侧的「目标版本」下拉菜单 |
| 在项目设置中 | 编辑 › 项目设置… › 世界 › 目标版本 |
| 重新查找启动器文件夹 | 文件 › 重新查找启动器文件夹 (版本列表) |
| 直接选择 jar | 文件 › 加载 jar… |
| 生成方块列表 | 文件 › 用服务器 jar 生成方块列表… (目标版本) |
- 打开菜单栏右侧的「目标版本」下拉菜单。
- 在列表中选择版本。每行显示版本、找到的启动器以及「有列表」（方块列表缓存）。
- 编辑器会使用该版本的客户端 jar 替换纹理。
- 通知中会显示「目标版本 1.21.11: 方块 N 种 · 状态 N」。
- 如果世界中有该版本不存在的方块，也会在通知中一并显示。
jar 的查找方式
Section titled “jar 的查找方式”编辑器按以下顺序查找启动器文件夹。同一版本存在于多处时，使用排在前面的。
| 顺序 | 启动器 | 查找的文件夹 |
|---|---|---|
| 1 | CurseForge | %USERPROFILE%\curseforge\minecraft\Install\versions |
| 2 | 官方启动器 | %APPDATA%\.minecraft\versions |
| 3 | Prism | %APPDATA%\PrismLauncher\libraries\com\mojang\minecraft |
| 4 | MultiMC | %APPDATA%\MultiMC\libraries\com\mojang\minecraft |
| 5 | TLauncher | %APPDATA%\.tlauncher\legacy\Minecraft\game\versions |
| 6 | Modrinth | %APPDATA%\ModrinthApp\meta\versions 等 |
| 7 | 手动选择 | 用「加载 jar…」选择的 jar（记住最近 12 个） |
- 只查找原版版本。排除 forge · neoforge · fabric · quilt · optifine 等模组加载器文件夹。
- 本机上没有所选版本的 jar 时，纹理保持当前 jar 不变，并给出提示。
- 用启动器下载了新版本后，请点击 文件 › 重新查找启动器文件夹 (版本列表)。
方块列表（服务器报告）
Section titled “方块列表（服务器报告）”方块名称、属性和默认状态的权威来源，是该版本服务器 jar 的数据报告（blocks.json）。
- 点击 文件 › 用服务器 jar 生成方块列表… (目标版本)。
- 选择该版本的 Minecraft 服务器 jar。
- 用 java 生成报告（数十秒）。生成的列表会保留在用户缓存中。
- 需要 java。找不到时，会提示设置
JAVA_HOME或将 java 加入PATH。 - 没有列表时，使用客户端 jar 中的方块列表。此时属性值的检查较弱。
- 内容浏览器中的红色名称表示目标版本列表中不存在的方块。
绘制其他版本的方块
Section titled “绘制其他版本的方块”自 0.9.10 起：所选 jar 中不存在的方块，会以该方块的贴图绘制，而不是占位盒。
| 情况 | 绘制方式 |
|---|---|
| 仅名称改变的方块 | 以该 jar 中的名称绘制（见下表）。 |
| 该版本中不存在的方块（更新版本的方块） | 从本机上更新的 jar 中获取贴图。方块列表仍为目标 jar 的列表。 |
| 也没有更新的 jar | 以名称颜色方块绘制。 |
通知示例：「此 jar 中没有的方块 2 种(…)—— 以 1.21.11 的贴图显示(该版本游戏中不存在)」。这只是借用贴图，该方块在目标版本的游戏中并不存在。
| 旧名称 | 新名称 | 更改版本 |
|---|---|---|
sign | oak_sign | 1.14 |
wall_sign | oak_wall_sign | 1.14 |
grass_path | dirt_path | 1.17 |
grass | short_grass | 1.20.3 |
chain | iron_chain | 1.21.9 |
当前支持的范围
Section titled “当前支持的范围”| 功能 | 当前支持的内容 |
|---|---|
| 目标版本列表 | 在本机启动器文件夹中找到的所有原版版本（包括 26.x），以及有方块列表缓存的版本 |
| 纹理 · 绘制其他版本的方块 | 限于本机上已有的 jar 之间。名称变更表已使用 1.18.2 · 1.20.1 · 1.21.1 · 1.21.11 · 26.1.2 · 26.2 的 jar 进行确认。 |
| 导出目标版本（.schem · .npbuild） | 1.20.1 · 1.20.4 · 1.20.6 · 1.21 · 1.21.1 · 1.21.3 · 1.21.4 ~ 1.21.11 |
| 保存 Minecraft 世界 | 1.20.1 及以上。道具需 1.21.4 及以上。26.x 以 1.21.11 格式写入，由游戏进行升级。 |
| 导入世界 | 1.18 及以上的世界 |
| 资源包 · 光影包 | 以 1.21.11 为基准（资源包 pack_format 75，物品为 1.21.4+ 方式） |
| AI 连接的方块检查 | 默认 1.21.11 |
尚在计划中的内容
Section titled “尚在计划中的内容”跨版本兼容的目标范围为 1.13 ~ 26.x。以下内容尚未实现。
| 计划 | 当前状态 |
|---|---|
| 以 1.13 ~ 1.19 为目标的导出 | 导出目标列表从 1.20.1 开始。1.18.2 仅支持导入。 |
| 适配属性改变的方块（1.16 墙的 low/tall、1.17 炼药锅的水等） | 尚未加入名称变更表。 |
含义改变的方块（1.14 stone_slab 等） | 不处理。 |
| 将世界中的方块名称改为目标版本名称的工具 | 界面中尚未提供。目前仅在绘制时使用不同名称。 |
| 26.x 专用导出格式 | 尚未确认 26.x 的格式值。 |
| 1.14 · 1.17 名称变更行的 jar 确认 | 基于公开资料，尚未用该版本的 jar 确认。 |
| 设置 | 位置 | 默认 |
|---|---|---|
| 目标版本 | 菜单栏 · 项目设置 | 1.21.11（记住最后选择的版本） |
| 方块列表 | 导出窗口「方块列表」 | 留空则使用缓存 · 自动 |
| 缺失方块 | 导出窗口 | 仅警告表(保持原样) |
此功能没有专门的快捷键。
提示 / 注意
Section titled “提示 / 注意”- 目标版本保存在项目（世界文件）中。打开其他世界时，会切换为该世界中保存的版本。
- 原版纹理只从用户本机的 jar 中读取。编辑器不分发原版贴图。
- 一个 jar 都没有时，方块以名称颜色占位符显示。用官方启动器运行一次该版本即可生成 jar。
- 导出时，目标版本中不存在的方块会按「缺失方块」的设置进行警告 · 替换 · 阻止（导出与导入）。