format_version explained

What the format_version line at the top of every add-on file means and which number to use.

It is the version of the file format

format_version tells the game which rules to read the file with. It is not the version of your add-on and not necessarily the version of the game you play. A component that was added or changed in a later format is only available when the file says it uses that format or a newer one.

Each file type has its own

Items, blocks, entities, recipes and spawn rules each carry their own number. In the official samples of Bedrock 1.26.60.5 the vanilla files use, for example, 1.26.30 for a data-driven item, 1.20.10 for recipes and 1.8.0 for spawn rules.

Which number to pick

Use the format the component you need was written for. Every page in the component reference shows the schema version of that component. The files written by the maker use 1.26.50 for items and 1.26.60 for blocks, and need Minecraft 1.26 or newer.

The manifest is separate

In manifest.json, format_version is 2, and min_engine_version is the oldest game version allowed to load the pack.

More guides

More from 9Minecraft