Format Versions

Format versions are an important part of Minecraft: Bedrock Edition's add-on system. They appear at the top of most files, formatted like this: "format_version": "1.21.0". You can think of this as the "version number" of the file, and the number you select here is really important! The format version you select will define which syntax and features are available to you, in that particular file.

Why Do Format Versions Exist? ​

Format versions exist to version the Add-on system, and allow Minecraft to introduce new features into the add-on system, without breaking old Add-ons. For example, a 1.8.0 format version RP Entity file has very different syntax than a 1.10.0 format version RP Entity file. By using the 'formatversion' key in the json _you can decide which version you want to use.

By using format versions per file, Minecraft gives you a lot of control over how your add-on will be interpreted by the game. It is completely possible and expected to mix different format versions in your add-on.

Format Version Is Not Game Version ​

It is really important to understand that format version is per subsystem, and is generally not equal to the base game version. This simply means that every type of file (item, rp entity, bp entity, recipe) will use a different versioning system.

For example: "format_version": "1.8.0" in an RP entity file means "use version 1.8.0 of the item system". It does not mean "use version 1.8.0 of the add-on system".

For this reason, some file types will have very "old" format versions. Do not be tempted to replace this version with the latest game version, such as 1.17.0.

Format Version Fixing ​

Minecraft has a system that will "fix" your format version if you've written it wrong. This system isn't well understood, isn't enabled for all systems, and shouldn't be relied upon. But it's important to note that an incorrect format version will often "regress" downwards until it hits a valid format version. For example a 1.11.0 RP entity file will simply be interpreted as 1.10.0, and cause no errors.

This system is useful, as it means you are less likely to generate a broken file, by selecting the wrong format version.

Picking a Format Version ​

Generally speaking, there is a cool tricky to pick the correct format version, for any file type.

For example, imagine you are creating a Recipe file:

1. Install the Vanilla Packs.
2. Look at some recipe files, to judge which format version is most used, or the most recent
3. Use this format version in your file

This simple trick will help you select a valid format version for your file.

Format Versions per Asset Type ​

This section will list the format versions used in the vanilla game, alongside how many times it appears.

• The '⭐' marks the recommended version.

Last Updated for 1.21.50

Resource Pack ​

Behavior Pack ​