格式版本 format_version
本页面镜像自 BedrockWiki
根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。
格式版本是Minecraft基岩版附加包系统的重要组成部分。它们通常以"format_version": "1.16.100"的形式出现在文件头部。你可以将其视为文件的"版本号"，所选用的数值至关重要！格式版本决定了该文件可用的语法和功能特性。
TIP
选择错误的格式版本是常见错误来源。排查问题时，人们可能会询问"你的物品使用什么格式版本"。请确保你知晓如何回答这类问题。
格式版本存在的意义
格式版本用于为附加包系统建立版本控制机制，使Minecraft能够在引入新功能的同时保持旧版附加包的兼容性。例如，使用1.8.0格式版本的RP实体文件与1.10.0格式版本的RP实体文件在语法结构上有显著差异。通过在JSON中使用format_version字段，你可以自主选择要使用的版本。
通过按文件指定格式版本，Minecraft赋予你对附加包运行方式的精细控制。在一个附加包中混合使用不同格式版本是完全可行且常见的做法。
实验性格式版本
格式版本也用于管理实验性功能的版本控制。由于Minecraft基岩版会将实验性功能直接发布到稳定版中，某些格式版本需要开启对应实验性选项才能启用。
典型案例是物品/方块系统：1.16.100代表实验性版本，1.10.0代表稳定版本。在制作物品时，建议尽早确定格式版本，因为这会影响文件后续的所有内容。如果选用实验性格式版本，可能需要使用高于1.16.100的版本——例如制作自定义刷怪蛋时，若需要设置怪物刷怪箱的实体类型，则必须使用1.19.80或更高版本。
格式版本 ≠ 游戏版本
需要重点理解的是：格式版本是按子系统独立管理的，通常与基础游戏版本号无关。这意味着每种文件类型（物品、RP实体、BP实体、配方等）都使用独立的版本体系。
例如：RP实体文件中的"format_version": "1.8.0"表示"使用物品系统的1.8.0版本"，而非"使用附加包系统的1.8.0版本"。
因此某些文件类型可能使用看似"陈旧"的格式版本。切忌将其替换为最新游戏版本（如1.17.0）。
格式版本自动修正
Minecraft具备自动修正错误格式版本的机制。该机制尚未被完全掌握，也未在所有系统中启用，不建议依赖此功能。但需注意：错误的格式版本通常会被"降级"到最近的合法版本。例如1.11.0的RP实体文件会被识别为1.10.0且不会报错。
此机制可有效降低因格式版本错误导致文件损坏的概率。
如何选择格式版本
通常可采用以下技巧确定正确的格式版本：
以配方文件为例：
- 安装原版资源包
- 参考原版配方文件，确定最常用或最新的格式版本
- 在你的文件中使用相同版本
此方法可帮助你为文件选择有效的格式版本。
各资源类型的格式版本
本节列出原版游戏中使用的格式版本及其出现频率：
- '⭐' 代表推荐使用的**稳定**版本
- '🚀' 代表推荐使用的**实验性**版本（如适用）
资源包
| 资源类型 | 版本 | 数量 |
|---|---|---|
| 实体 | 1.10.0 ⭐ | 82 |
| 实体 | 1.8.0 | 74 |
| 动画控制器 | 1.10.0 ⭐ | 56 |
| 动画 | 1.8.0 | 120 |
| 动画 | 1.10.0 ⭐ | 6 |
| 可附着物 | 1.10.0 ⭐ | 29 |
| 可附着物 | 1.8.0 | 25 |
| 可附着物 | 1.10 | 1 |
| 模型 | 1.8.0 | 92 |
| 模型 | 1.12.0 | 19 |
| 模型 | 1.10.0 | 4 |
| 模型 | 1.16.0 | 7 |
| 粒子效果 | 1.10.0 ⭐ | 131 |
| 渲染控制器 | 1.10.0 ⭐ | 83 |
行为包
| 类别 | 版本 | 数量 |
|---|---|---|
| 实体 | 1.8.0 | 2 |
| 实体 | 1.16.210 | 1 |
| 实体 | 1.13.0 | 7 |
| 实体 | 1.16.0 ⭐ | 58 |
| 实体 | 1.16.100 | 3 |
| 实体 | 1.12.0 | 21 |
| 实体 | 1.17.20 | 7 |
| 实体 | 1.17.10 | 4 |
| 实体 | 1.10.0 | 1 |
| 实体 | 1.14.0 | 1 |
| 物品 | 1.10 ⭐ | 44 |
| 物品 | 1.16.0 | 1 |
| 物品 | 1.16 | 1 |
| 物品 | 1.14 | 1 |
| 物品 | 1.16.100 🚀 | 0 |
| 物品 | 1.19.80 | 0 |
| 物品 | 1.20.40 | 0 |
| 配方 | 1.12 | 991 |
| 配方 | 1.16 ⭐ | 194 |
| 配方 | 1.14 | 2 |
| 生成规则 | 1.8.0 ⭐ | 48 |
| 生成规则 | 1.17.0 | 1 |
| 生成规则 | 1.11.0 | 1 |