Hi Gamepedia users and contributors! Please complete this survey to help us learn how to better meet your needs in the future. We have one for editors and readers. This should only take about 7 minutes!

Data pack

From Minecraft Wiki
(Redirected from Datapack)
Jump to: navigation, search
Information icon.svg
This feature is exclusive to Java Edition.

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, functions, loot tables, predicates[upcoming: JE 1.15], structures, recipes and tags without any code modification.

Usage[edit]

Data packs can be placed in the .minecraft/saves/(world)/datapacks folder of a world. Each data pack is either a sub-folder or a .zip file within the datapacks folder. After it is in the folder, a data pack will be enabled for that world when the world is reloaded or loaded.

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

Contents[edit]

Folder structure[edit]

  • (data pack name)
    • pack.mcmeta
    • data
      • (namespace)
        • advancements
          • (advancement).json
        • functions
          • (function).mcfunction
        • loot_tables
          • (loot_table).json
        • predicates‌[upcoming: JE 1.15]
          • (predicate).json
        • recipes
          • (recipe).json
        • structures
          • (structure).nbt
        • tags
          • blocks
            • (tag).json
          • entity_types
            • (tag).json
          • fluids
            • (tag).json
          • functions
            • (tag).json
          • items
            • (tag).json

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

pack.mcmeta[edit]

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

  • The root object.
    •  pack: Holds the data pack information.
      •  description: A JSON text that will be shown when hovering over the data pack's name in the list given by the /datapack list command.[when?]
      •  pack_format: Pack version. Since 1.15, if this number does not match the current required number, the data pack will display an error and required additional confirmation to load the pack, though there is actually no incompatibility.[verify] Requires 5 for 1.15.‌[upcoming: JE 1.15]

data[edit]

This folder contains all the data under one or multiple namespaces. It can contain advancements, functions, loot_tables, predicates[upcoming: JE 1.15], structures, recipes and/or tags folders.

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

History[edit]

Java Edition
1.1317w43aAdded data packs.
17w46aAdded /datapack, a command to control loaded data packs.
17w48aData packs can now load custom recipes.
17w49aTags can now be created with data packs.
17w49bTags can now be created for functions.
Functions tagged in tick now run every tick at the beginning of the tick.
18w01aAdded set_name function to loot tables.
Functions tagged in load will now run once after a (re)load.
Crash reports now list what data packs are enabled.
1.1418w43aTags can now be created for entity types.
Upcoming Java Edition
1.1519w38aAdded predicates folder where predicates can be defined.
Pre-Release 2It is now obligatory to set pack_format to 5 or else it will need additional confirmation.[verify]

Issues[edit]

Issues relating to "Data pack" are maintained on the bug tracker. Report issues there.

See also[edit]