Data pack

The data pack system provides a way for players to further customize their Minecraft experience. Data packs can be used to override or add new advancements, dimensions, functions, loot tables, predicates, recipes, structures, tags, world generation settings, and biomes without any code modification.

Usage
Data packs can be placed in the  folder of a world. Each data pack is either a sub-folder or a  file within the   folder. After it is in the folder, a data pack is enabled for that world when the world is reloaded or loaded.

Data packs load their data based on the load order. This order can be seen and altered by using the command and is stored in the  file.

The player can also select data packs at the world creation screen by clicking the Data Packs button and dragging-and-dropping their data pack folders/zip-files there. This is similar to the Resource Pack selection screen, and allows the player to enable data packs before the world is generated, and easily customize the load order too.

Folder structure
More than one directory for different namespaces may exist under the directory.

A data pack is identified by Minecraft based on the presence of the  file in the root directory of the data pack, which contains data in JSON format.


 * The root object.
 * Holds the data pack information.
 * A JSON text that appears when hovering over the data pack's name in the list given by the  command, or when viewing the pack in the Create World screen.
 * : Pack version: If this number does not match the current required number, the data pack displays a warning and requires additional confirmation to load the pack. Requires  for 1.13–1.14.4. Requires   for 1.15–1.16.1. Requires   for 1.16.2–1.16.5. Requires   for 1.17. Requires   for Java Edition 1.18 from snapshot 21w37.

, as used by the "vanilla" data pack in 1.17, as found in the client and official server jars:

This folder contains all the data under one or multiple namespaces. It can contain,  ,  ,  ,  ,  ,  ,  ,   and/or  ,  folders. The  folder can contain ,  ,  ,  ,  ,  ,   and   folders.

The,   and   folders are currently experimental features.

Each advancement, function, loot table, predicate, structure, recipe and tag file can be placed directly in their respective folder but sub-folders are also allowed.

Template
The folder structure of the vanilla data pack: