---
title: 格式版本
category: 扩展内容
description: 如何正确使用格式版本
prefix: 'e. '
nav_order: 5
mentions:
    - SirLich
    - SmokeyStack
    - ThomasOrs
    - Xterionix
---

# 格式版本 format_version

<!--@include: @/wiki/bedrock-wiki-mirror.md-->

格式版本是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. 安装[原版资源包](/wiki/guide/download-packs)
2. 参考原版配方文件，确定最常用或最新的格式版本
3. 在你的文件中使用相同版本

此方法可帮助你为文件选择有效的格式版本。

## 各资源类型的格式版本

本节列出原版游戏中使用的格式版本及其出现频率：

    - '⭐' 代表推荐使用的**稳定**版本
    - '🚀' 代表推荐使用的**实验性**版本（如适用）

### 资源包

| 资源类型            | 版本       | 数量 |
|---------------------|------------|------|
| 实体                | 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    |