بسته داده

این مقاله دربارهٔ the data pack system است.برای the command، به Commands/datapack مراجعه کنید.برای the resource pack system، به resource pack مراجعه کنید.

الگو:Exclusive

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, item modifiers, recipes, structures, tags, damage types, world generation settings, and biomes without any code modification.

Usage

Data packs can be placed in the الگو:Code folder of a world. Each data pack is either a sub-folder or a [[wikipedia:Zip (file format)|الگو:Code file]] within the الگو:Code 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 الگو:Cmd command and is stored in the [[Java Edition level format#level.dat_format|الگو:Cd 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.

Contents

Folder structure

Data packs use the following folder structure:

• (data pack name)
  • pack.mcmeta
  • pack.png
  • data
    • (namespace)
      • advancements
        • (advancement).json
      • functions
        • (function).mcfunction
      • item_modifiers
        • (item_modifier).json
      • loot_tables
        • (loot_table).json
      • predicates
        • (predicate).json
      • recipes
        • (recipe).json
      • structures
        • (structure).nbt
      • chat_type
        • (chat type).json
      • damage_type
        • (damage type).json
      • tags
        • blocks
          • (tag).json
        • entity_types
          • (tag).json
        • fluids
          • (tag).json
        • functions
          • (tag).json
        • game_events
          • (tag).json
        • items
          • (tag).json
        • chat_type
          • (tag).json
        • damage_type
          • (tag).json
        • (registry name)
          • (tag).json
      • dimension
        • (dimension).json
      • dimension_type
        • (dimension type).json
      • worldgen
        • biome
          • (biome).json
        • configured_carver
          • (carver).json
        • configured_feature
          • (feature).json
        • density_function
          • (density_function).json
        • noise
          • (noise).json
        • noise_settings
          • (noise_settings).json
        • placed_feature
          • (placed_feature).json
        • processor_list
          • (block_processor).json
        • structure
          • (structure).json
        • structure_set
          • (structure_set).json
        • template_pool
          • (jigsaw_pool).json
        • world_preset
          • (preset).json
        • flat_level_generator_preset
          • (flat_level_generator_preset).json

More than one directory for different namespaces may exist under the الگو:Cd directory.

الگو:Code

A data pack is identified by Minecraft based on the presence of the الگو:Code 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 appears when hovering over the data pack's name in the list given by the الگو:Code command, or when viewing the pack in the Create World screen.
    •  pack_format: 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. See #Pack format for a full list of pack format numbers.
  •  filter: Section for filtering out files from data packs applied below this one. Any file that matches one of the patterns inside الگو:Mono will be treated as if it was not present in the pack at all.
    •  block: List of patterns
      • •  namespace: A regular expression for the namespace of files to be filtered out. If unspecified, it applies to every namespace.
        •  path: A regular expression for the paths of files to be filtered out. If unspecified, it applies to every file.

الگو:Code, as used by the "vanilla" data pack in 1.19, as found in the client and official server jars:

{
    "pack": {
        "pack_format": 10,
        "description": "The default data for Minecraft"
    }
}

الگو:Code

This folder contains all the data under one or multiple namespaces. It can contain الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, and/or الگو:Code folders. The الگو:Code folder can contain الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code, الگو:Code and الگو:Code folders.

The الگو:Code, الگو:Code and الگو:Code 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.

Pack format

The table below describes the version range using each pack format number:

الگو:Data pack format

Template

The folder structure of the vanilla data pack: Resource pack/Folders

History

Java Edition
الگو:Version link		17w43a			Added data packs.
		17w46a			Added الگو:Cmd, a command to control loaded data packs.
		17w48a			Data packs can now load custom recipes.
					Added the initial pack format version of 4.
		17w49a			Tags can now be created with data packs.
		17w49b			Tags can now be created for functions.
					Functions tagged in tick now run at the beginning of every tick.
		18w01a			Added set_name function to loot tables.
					Functions tagged in load now run once after a (re)load.
					Crash reports now list what data packs are enabled.
الگو:Version link		18w43a			Tags can now be created for entity types.
الگو:Version link		19w38a			Added predicates folder where predicates can be defined.
		Pre-release 1			Changed the pack format number to 5.
الگو:Version link		20w22a			Slightly changed data pack loading to prevent custom data packs from crashing.
					If data pack reload fails, changes are not applied and the game continues using previous data.
					Changes to data pack list are stored only after successful reload.
					If existing data packs prevent the world from loading, the game gives an option to load the world in safe mode, which loads only vanilla data pack.
					Added --safeMode option for servers to load only with vanilla data pack.
					Game now detects any critical data pack issues, such as required tags being missing, and prevent the world from being loaded.
		Pre-release 1			Data packs can now be loaded before the world is created.
					Data packs can now add and change dimensions and dimension types.
الگو:Version link		20w27a			Data packs can now have a pack.png in the root folder, and display it in the data pack menu.
		20w28a			Custom worlds now support custom biomes and can now be used in custom dimension generators.
					Data packs can now customize world generation in the worldgen folder.
		Release Candidate 1			Changed the pack format number to 6.
الگو:Version link		20w45a			Pack format in version.json has been split into data and resource versions.
		20w46a			Changed the pack format version to 7.
الگو:Version link		21w37a			Changed the pack format version to 8.
الگو:Version link		Pre-release 1			It is now possible to add custom structures in experimental data packs: the game now generates and stores data-driven configured structures.
					A lot of the cave generation is now configurable through data packs.
					Changed the pack format version to 9, due to the changes above.
الگو:Version link		22w11a			Changed the pack format version to 10.
الگو:Version link		22w42a			Added a subsection called chat_type.
					Added a subsection called datapacks.
					The Vanilla world generation data pack is now visible within the game's jar.
الگو:Version link		23w03a			Changed the pack format version to 11.
		23w06a			Added damage types.
					Changed the pack format version to 12.
الگو:Version link		23w12a			Changed the pack format version to 13, accounting for sign data format changes.
		23w16a			Changed the pack format version to 14.
		23w18a			Changed the pack format version to 15, accounting for predicate/loot table and advancement changes.
Upcoming Java Edition
الگو:Version link		23w31a			Changed the pack format version to 16, accounting for sign data format changes.
		23w32a			The version is now 17.
		1.20.2 Pre-release 1			The version is now 18.

Issues

الگو:Issue list

Gallery

World-type-custom.png

Example of a custom world created with a data pack.

See also

• Add-on
• Advancements
• Biome
• Dimension
• Function
• Item modifier
• Loot table
• Recipe
• Structure
• Tag
• Predicates
• Tutorials/Installing a data pack
• Tutorials/Creating a data pack
• Resource Pack
• Tutorials/Creating a resource pack

الگو:Java Edition الگو:Data Packs pt:Pacote de dados