データパック

この記事では、データパックについて説明しています。コマンドについては「コマンド/datapack」を、リソースパックについては「リソースパック」をご覧ください。

データパック (英：Data Pack) は、プレイヤーが Minecraft をカスタマイズすることができるシステムである。データパックを使用することで、コードを変更しなくても進捗、関数、ルートテーブル、構造物、レシピ、タグを上書きしたり、新しく追加できる。

使用法

データパックは、.minecraft/saves/(ワールド)/datapacks フォルダに配置する。各データパックは、datapacks フォルダ内のサブフォルダまたは .zip ファイルとなる。データパックをフォルダに入れ、/reloadコマンドを実行するか再ログインすることで、そのワールドでデータパックが有効化される。

データパックは、読み込み順に基づいてデータが読み込まれる。/datapack コマンドを使用することでこの順序の表示や変更を行うことができる。読み込み順はlevel.datファイルに保存される。

内容

フォルダの構造

(データパックの名前) pack.mcmeta data (名前空間) advancements (進捗).json functions (関数).mcfunction loot_tables (ルートテーブル).json recipes (レシピ).json structures (構造物).nbt tags blocks (タグ).json entity_types (タグ).json items (タグ).json fluids (タグ).json functions (タグ).json

pack.mcmeta

データパックは、JSON 形式で記述された pack.mcmeta ファイルに基づいて、Minecraft に識別されている。

• •  pack: データパックの情報を記述する。
    •  pack_format: パックのバージョン（この数が対応バージョンに必要な数と一致しない場合、データパックは警告を表示し、そのままではゲームを開始することができない。4→1.13–1.14.4,　5→1.15–1.16.1,　6→1.16.2–1.16.3）
    •  description: パックの説明（記述する必要はあるが、空白にしてもよい）。この説明は、データパックの一覧にあるデータパックをホバリングすると表示される。
    •  description: データパックの一覧でパックの説明として表示される生のJSONテキスト。string型のdescriptionと同じ振る舞いをするが、いずれか一方だけしか記述できない^[いつ？]。

data

「名前空間ID § 名前空間」も参照

このフォルダには、1つまたは複数の名前空間の下にあるすべてのデータが格納される。これには、advancements、functions、loot_tables、structures、recipes、 tags のフォルダを格納することができる。

各進捗、関数、ルートテーブル、構造物、レシピ、タグはそれぞれのフォルダに直接配置することができ、サブフォルダに配置することも可能である。

歴史

Java Edition
1.13		17w43a			データパックが追加された。
		17w46a			/datapack コマンドが追加された。このコマンドは、読み込まれたデータパックを操作するためのコマンドである。
		17w48a			データパックから自分のオリジナルのレシピを読み込めるようになった。
		17w49a			データパックでタグが使えるようになった。
		17w49b			関数をタグでタグ付けできるようになった。
					minecraft:tickでタグ付けされた関数が、毎ティック開始時に実行されるようになった。
		18w01a			set_name関数がルートテーブルに追加された。
					minecraft:loadでタグ付けされた関数が、読み込まれた時（もしくは再読み込みされた時）に一度実行されるようになった。
					クラッシュレポートに、有効になっているデータパックの一覧が表示されるようになった。
1.14		18w43a			エンティティ種別をタグ付けできるようになった。
1.15		19w38a			Added predicates folder where predicates can be defined.
1.16		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.
1.16.2		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.
					Datapacks can now customize world generation in the worldgen folder

問題点

「データパック」に関する問題点は、バグトラッカーにて管理されている。問題点の報告はそちらで行ってほしい。

関連項目

• 進捗
• 関数
• ルートテーブル
• レシピ
• 構造物
• タグ
• チュートリアル/データパックの読み込み（英語版）
• チュートリアル/データパックの作成（英語版）