ルートテーブルのソースを表示

'''ルートテーブル'''（{{en|Loot Table}}）とは、ゲーム内の様々な場面においてどのようにアイテムを生成するかを決定している技術的な[[JSON]]ファイルである。具体的には、[[チェストの戦利品|自然生成された収納ブロックの中身]]、[[ドロップ|Mobからのドロップアイテム]]、[[釣り|釣りで得られるアイテム]]などの場面で使用されている。なお、ルートテーブルはMobからドロップする経験値や、アイテム以外のドロップするエンティティ（[[虫食いブロック]]からの[[シルバーフィッシュ]]や分裂した[[スライム]]など）には関与しない。

== 定義方法 ==
カスタムデータパックでは、自然生成される収納ブロックの中身やMobのドロップアイテムを変更する目的でルートテーブルを使用することができる。但し、岩盤やネザーポータルなどサバイバルでは破壊できないブロックはルートテーブルを持たないこと、また看板と壁にかけられた看板など一部のブロックはルートテーブルを共有していること、および特定のドロップアイテム（帯電クリーパーに巻き込まれたMobの頭のドロップ、ウィザーのネザースターなど）はルートテーブルを使用していないこと<ref>{{bug|MC-94610}}</ref> に注意が必要である。

ルートテーブルは、データパックの次の位置に配置することで機能する。

<div class="treeview">
* '''''（データパック名）'''''
** '''data'''
*** '''''（名前空間名）'''''
**** '''loot_tables'''
***** '''''（ルートテーブル名）''.json'''およびルートテーブルの下位フォルダ
</div>

バニラの''Minecraft''で使用されるルートテーブルは5つの下位グループに分類される。その4グループとは、
* {{cd|archeology}} - [[怪しげなブロック]]に埋まっているアイテム
* {{cd|blocks}} - ブロック破壊時のドロップアイテム
* {{cd|chests}} - [[構造物]]などのチェストの戦利品
* {{cd|entities}} - エンティティのドロップ品
* {{cd|gameplay}} - [[釣り]]、[[ネコ|猫の贈り物]]、[[物々交換|ピグリンの物々交換]]など

である。例えば<code>zombie.json</code>は<code>''data pack name''/data/minecraft/loot_tables/entities</code>に配置し、これを編集したデータパックを使用することで通常のドロップ品ではなくここで設定したアイテムをゾンビにドロップさせることができる。

== 呼び出し方 ==
ルートテーブルを召喚する際は、ルートテーブルを使用するエンティティおよびブロックエンティティのNBTタグに{{nbt|string|使用するルートテーブル}}と{{nbt|long|使用するシード値}}を設定する必要がある。同じルートテーブルとシード値を使用した場合、必ず同じアイテムが生成される。なおルートテーブルはどのスロットにアイテムを配置するかまでは決定しておらず、これはシード値によってランダムに決定される。

実際のNBTタグの記述方法は次の通り。

{{#vardefineecho:containers|{{BlockLink|barrel}}、{{BlockLink|chest}}、{{BlockLink|trapped chest}}、{{BlockLink|hopper}}、{{EntityLink|minecart with chest}}、{{EntityLink|boat with chest}}、{{EntityLink|minecart with hopper}}、{{BlockLink|dispenser}}、{{BlockLink|dropper}}、{{BlockLink|shulker box}}、{{BlockLink|Suspicious Sand}}、{{BlockLink|Suspicious Gravel}}、{{BlockLink|Decorated Pot}}の場合：
}}
<div class="treeview">
* {{nbt|compound}} 上位のオブジェクト。
** {{nbt|string|LootTable}}: 収納ブロックが何らかの操作（開く、および破壊・ホッパーでのアイテムの移動など）を受けた時に中身のアイテムを生成するために使用するルートテーブル。ラージチェストに関しては、このタグが付いている方のチェストに該当するスロットのみが影響する。サブフォルダの中のルートテーブルを使用する場合は、サブフォルダ名から書き始める必要がある。
** {{nbt|long|LootTableSeed}}: ルートテーブルが使用するシード値。指定しない場合及び0を指定した場合は、ランダムなシード値を使用する。
</div>
これらのタグは、アイテムが生成されるとともに即座に削除される。

[[Mob]]の場合：

<div class="treeview">
* {{nbt|compound}} 上位のオブジェクト。
** {{nbt|string|DeathLootTable}}: このエンティティが死んだときのドロップアイテムを生成するのに使用するルートテーブル。サブフォルダの中のルートテーブルを使用する場合は、サブフォルダ名から書き始める必要がある。
** {{nbt|long|DeathLootTableSeed}}: ルートテーブルが使用するシード値。指定しない場合及び0を指定した場合は、ランダムなシード値を使用する。 
</div>

Mobおよび収納ブロックのルートテーブルは、{{cmd|execute store}}または{{cmd|data}}を用いて変更することができる。またプレイヤーは、{{cmd|loot}}を用いることでもルートテーブルを召喚することができる。

== 構造 ==
本項では、ルートテーブルの記述方法を解説する。ルートテーブルは[[JSON]]形式によって記述され、以下の構造をもつ。

<div class="treeview">
* {{nbt|compound}} ルートテーブルの最上位のオブジェクト。
** {{nbt|string|type}}: 任意の要素。ルートテーブルを呼び出す状況を指定する。アイテム関数、プレディケート、ナンバープロバイダーは、使用されているパラメータにこのルート状況が対応しているかどうかを検証したうえで使用され、対応していない状況パラメータが検出された場合には警告メッセージが出力される。有効な値の一覧は[[#ルート状況|後項]]を参照。
** {{nbt|list|functions}}: このルートテーブルによって生成されたすべてのアイテムスタックに使用する[[ルートテーブル#アイテム関数|アイテム関数]]のリスト。施したい順序に従ってリスト内に指定する。使用範囲を限定したい場合はここではなく、プールや項目の階層の{{nbt|list|functions}}を用いる。
*** {{nbt|compound}} それぞれのアイテム関数。このオブジェクトのJSON構造は、[[アイテム修飾子#アイテム関数のJSONフォーマット|アイテム修飾子]]のページを参照されたい。
** {{nbt|list|pools}}: このルートテーブル内のすべてのプールのリスト。それぞれのプールはアイテムのスタックをその試行回数だけ生成する。プールは記述されている順番通りに使用される。
*** {{nbt|compound}}それぞれのプール。この部分のJSON構造は、[[#プール|次項]]を参照。
** {{nbt|string|random_sequence}}：このルートテーブルがアイテムの生成に使用するランダム配列。これとシード値の組み合わせによりアイテム配列が生成される。同じパラメータと同じシード値を用いた場合は、同じアイテム配列が生成される。任意の要素であり、配列のIDが与えらなかった場合は、非決定的なランダム配列を使用する。
</div>

=== プール ===
<div class="treeview">
* {{nbt|compound}} 最上位のオブジェクト
** {{nbt|list|conditions}}: このプールが使用されるために通過が必要な[[#プレディケート|プレディケート]]のリスト。
*** {{nbt|compound}} それぞれのプレディケート。この部分のJSON構造は[[プレディケート|当該記事]]を参照。
** {{nbt|list|functions}}: このプールが生成したアイテムスタックに作用する[[#アイテム関数|アイテム関数]]のリスト。作用させたい順番通りに記述する。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は[[アイテム修飾子]]の記事を参照。
** {{nbt|int}}{{nbt|compound|rolls}}: このプールの試行回数（抽選回数）を指定する。後述する[[#ナンバープロバイダー|ナンバープロバイダー]]で指定する。
** {{nbt|float}}{{nbt|compound|bonus_rolls}}: 属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）1ポイント当たりの追加の生成試行回数を指定する。乗算の後四捨五入される。[[#ナンバープロバイダー|ナンバープロバイダー]]で指定する。デフォルトでは0.0。
** {{nbt|list|entries}}: ルートテーブルの「中身」にあたる、「設定項目」。1回の試行で、この中のどれか1つがランダムに抽選される。後述する{{nbt|int|weight}}で抽選を偏らせることができるが、この処理は個々のオブジェクトに対して行われる。
*** {{nbt|compound}} それぞれのエントリプロバイダー。そのJSON構造は[[#エントリプロバイダー|次項]]を参照のこと。
</div>

=== エントリプロバイダー ===
{{nbt|list|entries}}に記述する項目で、次のJSON構造によって記述される。

<div class="treeview">
* {{nbt|compound}} エントリプロバイダーの最上位のオブジェクト。
** {{nbt|list|conditions}}: この項目が、自身の属するプールに項目を生成する為に通過する必要のある[[#プレディケート|プレディケート]]のリスト。
*** {{nbt|compound}} 個々のプレディケート。この部分のJSON構造は[[プレディケート]]のページを参照のこと。
** {{nbt|string|type}}: entriesのタイプを[[名前空間ID]]で指定する。この種類に応じて以降の項目が変化する。
</div>

有効な{{nbt|string|type}}の値によって、それ以降の項目が以下のように変化する。

<div class="treeview">

* '''item''' - 1スロット分のアイテムをルート項目に追加する。
** {{nbt|list|functions}}: アイテムのスロットに作用させる[[#アイテム関数|アイテム関数]]のリスト。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は、[[アイテム修飾子]]を参照のこと。
** {{nbt|int|weight}}: エントリが、どの程度の確率でプールから選出されるかを決定する比重。選ばれる確率は、<code>この項目の比重/プール内に生成されるすべての項目の比重</code>となる。
** {{nbt|int|quality}}: [[#ルート状況|ルート状況]]によって与えられたエンティティの属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）に準じて、この項目の{{nbt|int|weight}}の値を補正する。属性値を参照するエンティティはルート状況の種類によって異なり、{{cd|entity}}の場合は{{cd|killer_entity}}のエンティティを、それ以外のルート状況の種類においては{{cd|this}}のエンティティの属性値が参照される。補正公式は、{{cd|floor(weight + (quality &times; generic.luck))}}である。
** {{nbt|string|name}}: {{cd|minecraft:diamond}}など、生成するアイテムの名前空間IDを指定する。アイテム関数によって編集を受けていない場合、ここで指定したアイテムが1つ、生成される。


* '''tag''' - 特定の[[タグ#アイテム|アイテムタグ]]に含まれる一つ一つのアイテムをそれぞれすべてプール内の項目に追加するか、またはタグに含まれるすべてのアイテムの中から一つアイテムを選出する項目を一つだけプールに追加する。
** {{nbt|list|functions}}: アイテムのスロットに作用させる[[#アイテム関数|アイテム関数]]のリスト。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は、[[アイテム修飾子]]を参照のこと。
** {{nbt|int|weight}}: 生成されたそれぞれの項目が、どの程度の確率でプールから選出されるかを決定する比重。選ばれる確率は、<code>この項目の比重/プール内に生成されるすべての項目の比重</code>となる。
** {{nbt|int|quality}}: [[#ルート状況|ルート状況]]によって与えられたエンティティの属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）に準じて、この項目の{{nbt|int|weight}}の値を補正する。属性値を参照するエンティティはルート状況の種類によって異なり、{{cd|entity}}の場合は{{cd|killer_entity}}のエンティティを、それ以外のルート状況の種類においては{{cd|this}}のエンティティの属性値が参照される。補正公式は、{{cd|floor(weight + (quality &times; generic.luck))}}である。
** {{nbt|string|name}}: 参照するアイテムタグの名前空間ID（例：{{cd|minecraft:arrows}}）
** {{nbt|boolean|expand}}: {{cd|true}}の場合はタグ内のすべてのアイテムについて一つずつ、指定された比重と比重補正値で項目を生成する。{{cd|false}}の場合はタグ内のすべてのアイテムを生成しうる項目を一つだけ生成する。アイテム関数によって編集を受けていない場合、アイテムは1つ生成される。


* '''loot_table''' - プールの項目として、別のルートテーブルを与える。
** {{nbt|list|functions}}: アイテムのスロットに作用させる[[#アイテム関数|アイテム関数]]のリスト。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は、[[アイテム修飾子]]を参照のこと。
** {{nbt|int|weight}}: 生成されたそれぞれの項目が、どの程度の確率でプールから選出されるかを決定する比重。選ばれる確率は、<code>この項目の比重/プール内に生成されるすべての項目の比重</code>となる。
** {{nbt|int|quality}}: [[#ルート状況|ルート状況]]によって与えられたエンティティの属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）に準じて、この項目の{{nbt|int|weight}}の値を補正する。属性値を参照するエンティティはルート状況の種類によって異なり、{{cd|entity}}の場合は{{cd|killer_entity}}のエンティティを、それ以外のルート状況の種類においては{{cd|this}}のエンティティの属性値が参照される。補正公式は、{{cd|floor(weight + (quality &times; generic.luck))}}である。
** {{nbt|string|name}}: 使用するルートテーブルの名前空間ID（例：{{cd|minecraft:gameplay/fishing/junk}}）。


* '''dynamic''' - チェストを破壊した際など、それぞれのブロック特有のドロップアイテムを生成する項目を生成する。
** {{nbt|list|functions}}: アイテムのスロットに作用させる[[#アイテム関数|アイテム関数]]のリスト。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は、[[アイテム修飾子]]を参照のこと。
** {{nbt|int|weight}}: 生成されたそれぞれの項目が、どの程度の確率でプールから選出されるかを決定する比重。選ばれる確率は、<code>この項目の比重/プール内に生成されるすべての項目の比重</code>となる。
** {{nbt|int|quality}}: [[#ルート状況|ルート状況]]によって与えられたエンティティの属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）に準じて、この項目の{{nbt|int|weight}}の値を補正する。属性値を参照するエンティティはルート状況の種類によって異なり、{{cd|entity}}の場合は{{cd|killer_entity}}のエンティティを、それ以外のルート状況の種類においては{{cd|this}}のエンティティの属性値が参照される。補正公式は、{{cd|floor(weight + (quality &times; generic.luck))}}である。
** {{nbt|string|name}}: <code>contents</code>に指定すると、ブロックエンティティの中身のアイテムが生成される。


* '''empty''' - 選択された際に何もアイテムを生成しない項目を作成するための項目。
** {{nbt|list|functions}}: アイテムのスロットに作用させる[[#アイテム関数|アイテム関数]]のリスト。
*** {{nbt|compound}} それぞれのアイテム関数。この部分のJSON構造は、[[アイテム修飾子]]を参照のこと。
** {{nbt|int|weight}}: 生成されたそれぞれの項目が、どの程度の確率でプールから選出されるかを決定する比重。選ばれる確率は、<code>この項目の比重/プール内に生成されるすべての項目の比重</code>となる。
** {{nbt|int|quality}}: [[#ルート状況|ルート状況]]によって与えられたエンティティの属性値「[[属性#プレイヤーの属性|運]]」（{{cd|minecraft:generic.luck}}）に準じて、この項目の{{nbt|int|weight}}の値を補正する。属性値を参照するエンティティはルート状況の種類によって異なり、{{cd|entity}}の場合は{{cd|killer_entity}}のエンティティを、それ以外のルート状況の種類においては{{cd|this}}のエンティティの属性値が参照される。補正公式は、{{cd|floor(weight + (quality &times; generic.luck))}}である。


* '''group''' - グループ化する。1個の条件を複数のエントリに適用したい場合などに便利。
** {{nbt|list|children}}: エントリプロバイダーのリスト。
*** {{nbt|compound}} それぞれの項目。 


* '''alternatives''' - リスト内を順番に参照していき、最初に条件を通過したエントリプロバイダーのみを適用する。
** {{nbt|list|children}}: エントリプロバイダーのリスト。
*** {{nbt|compound}} エントリプロバイダー。


* '''sequence''' - リスト内を順番に参照していき、条件を通過できないエントリプロバイダーが出現するまですべての項目を適用する。条件を通過出来なくなった時点で試行は終了となる。
** {{nbt|list|children}}: 項目のリスト。
*** {{nbt|compound}} エントリプロバイダー。
</div>

== ルートテーブルおよびその他のデータパックファイルで繰り返し使用されるJSON構造 ==

=== プレディケート ===
{{main|プレディケート}}
'''プレディケート'''は、ルートテーブル内においてはドロップの発生、アイテムの生成、プールの使用、関数の使用に条件を設定するために使用される。

プレディケートはルートテーブル内に直接組み込んで記述する以外にも個別のJSONファイルとして定義することができ、この場合にはルートテーブル以外にも様々な場面で使用することができる。

プレディケートのJSON構造については[[プレディケート|当該記事]]を参照のこと。

=== アイテム関数 ===
{{main|アイテム修飾子}}
'''アイテム関数'''および'''ルート関数'''は、ルートテーブル内においては生成されたアイテムのスタックに個数の変更やエンチャントの追加など様々な変更を施すために使用される。

アイテム関数はルートテーブルに直接記述される以外にも、一つまたは複数のアイテム関数のセットであり'''アイテム修飾子'''と呼ばれる個別のファイルで定義することが可能であり、この場合はルートテーブル以外の場面においても{{cmd|item}}を介してインベントリや収納ブロック内のアイテムに変更を加えることができる。

アイテム関数のJSON構造は[[アイテム修飾子|当該記事]]を参照のこと。

=== ナンバープロバイダー ===
ナンバープロバイダーは、ルートテーブルやアイテム関数などの随所で整数や単精度浮動小数点数を指定するのに使用されている。

定数を指定する場合と、オブジェクトで指定する場合がある。

;定数型
<div class="treeview">
* {{nbt|int}}{{nbt|float}}: 使用する定数。
</div>

;範囲型
<div class="treeview">
* {{nbt|compound}}: ナンバープロバイダーの最上位のタグ。
** {{nbt|string|type}}: ナンバープロバイダーの形式。この値に従って、ナンバープロバイダーは対応する追加のプロパティと機能を持つ。
</div>

{{nbt|string|type}}の取り得る値と対応する追加のプロパティは次の通り。

<div class="treeview">

* '''constant''' - 定数を生成する。
** {{nbt|int}}{{nbt|float|value}}: 指定したい値。


* '''uniform''' - 指定した数値間の範囲（閉区間）から、均一な確率で数値を生成する。
** {{nbt|int}}{{nbt|float}}{{nbt|compound|min}}: 最小値を生成するナンバープロバイダー。
** {{nbt|int}}{{nbt|float}}{{nbt|compound|max}}: 最大値を生成するナンバープロバイダー。


* '''binomial''' - 指定したnとpに拠る二項分布に従った確率で数値を生成する。
** {{nbt|int}}{{nbt|compound|n}}: ナンバープロバイダー。二項分布の試行回数の値。
** {{nbt|float}}{{nbt|compound|p}}: ナンバープロバイダー。二項分布の確率の値。


* '''score''' - 数値をスコアボードの値から取得する。
** {{nbt|compound|target}}: スコアボードの値の参照先となるエンティティやプレイヤーを指定するコンパウンド。
*** {{nbt|string|type}}: プレイヤー名やエンティティのUUIDで指定する場合は{{cd|fixed}}を、ルート状況によって与えられるエンティティを使用する場合は{{cd|context}}を指定する。
*** {{nbt|string|name}}: {{nbt|string|type}}が{{cd|fixed}}の場合のみ使用される。スコアボードの値を参照するプレイヤーの名前またはエンティティの [[UUID]]<small>(ハイフン付き16進形式)</small>を指定する。
*** {{nbt|string|target}}: {{nbt|string|type}}が{{cd|context}}の場合のみ使用される。スコアボードの値を参照するエンティティを、[[#ルート条件の種類|ルート条件]]によって与えられる引数で指定する。取りうる値は、{{cd|this}}、{{cd|killer}}、{{cd|direct_killer}}、{{cd|killer_player}}のいずれかである。
** {{nbt|string|score}}: 値を取得するスコアボードのオブジェクト。
** {{nbt|float|scale}}: 任意の要素。スコアボードの値を何倍にしてルートテーブル内で使用するかを決定する倍率。
</div>

== ルート状況 ==
<!--編者註：英語版より文章構成をやや改めています。~~~~ -->
'''ルート状況'''（{{en|Loot context}}）とは、ルートテーブルが召喚された状況に対応したさまざまなパラメータをプレディケート、ルート関数、ナンバープロバイダーに与えるための仕組みである。ルート状況はフィールド{{nbt|string|type}}を用いて指定する。

データパックの読み込み時には、ルートテーブル内で使用されている状況パラメータが指定されているルート状況に対応しているかどうかを検証することができ、ゲーム内で実際にルートテーブルを使用する前にエラーを検出することができる。状況パラメータの中には、そのルート状況において必ず値を提供するものと場合によって提供しないものがあり、ルートテーブルが召喚された際にはルートテーブルが今回提供されていない状況パラメータが使用されていないか改めて確認される。

有効なルート状況の値とその用途、対応している状況パラメータは下表の通り。

{| class="wikitable" data-description="Invocation methods for predicates and loot functions"
! scope="col" | ルート状況の値
! scope="col" | 用途
! scope="col" | 必ず提供される状況パラメータ
! scope="col" | 場合によって提供される状況パラメータ
|-
| {{cd|empty}} || 
* 使用されていないルート状況。特に状況パラメータを与えない。 
* {{cd|"type":"empty"}}を指定した場合、このルートテーブル内では状況パラメータが一切使用できないことを示す。
| なし || なし
|-
| {{cd|chest}} ||
* ルートテーブルを伴う収納ブロック（{{#var:containers}}）を開いたとき。
* {{cmd|loot &hellip; loot &lt;loot_table&gt;}}の実行時。
|
* '''{{cd|Origin}}''' ブロックの座標。
|
* '''{{cd|this}}''' 収納ブロックを開いたエンティティ
|-
| {{cd|command}} ||
* ルートテーブルでは使用されないため、ルートテーブル内で{{cd|"type":"command"}}を指定しても意味を為さない。
* {{cmd|item modify}}や{{cmd|execute (if{{!}}unless) predicate}}のコマンドを実行した際には、内部的にこのルート状況が使用されている。
| 
* '''{{cd|Origin}}'''：コマンドの実行地点
|
* '''{{cd|this}}'''：コマンドの実行時の文脈上で{{cd|@s}}に設定されているエンティティ。
|-
| {{cd|selector}} ||
* ルートテーブルでは使用されないため、ルートテーブル内で{{cd|"type":"selector"}}を指定しても意味を為さない。
* {{cd|predicate}}の[[ターゲットセレクター]]の引数として内部的に使用される。
|
* '''{{cd|Origin}}'''：エンティティがプレディケートによって確認を受けた地点。
* '''{{cd|this}}'''：確認を受けたエンティティ。
|
|-
| {{cd|fishing}} ||
* [[釣り]]。
* コマンド{{cmd|loot &hellip; fish &lt;loot_table&gt;}}の実行時。
|
* '''{{cd|Origin}}'''：釣り竿の浮きの座標。
* '''Tool'''：プレイヤーが手に持っている釣り竿。
|
* '''{{cd|this}}'''：釣り竿の浮き（エンティティ）。
|-
| {{cd|entity}} ||
* 生物エンティティからのドロップ時。
* コマンド{{cmd|loot &hellip; kill &lt;target&gt;}}の実行時。
|
* '''{{cd|this}}'''：死亡したエンティティ。 
* '''Origin'''：死亡位置。
* '''Damage source'''：致命打のダメージ源。
|
* '''{{cd|killer}}'''：致命打の根本的な原因 となったエンティティ。例えばエンティティが矢などの飛翔体によって死亡した場合、これを発射したエンティティが{{cd|killer}}に該当する。
* '''{{cd|direct_killer}}'''：致命打を直接与えたエンティティ。例えばエンティティが飛翔体によって死亡した場合、発射者ではなく飛翔体自身がこれに該当する。
* '''{{cd|killer_player}}'''：死亡したエンティティを最も直近で攻撃したプレイヤー。
|-
| {{cd|archaeology}} ||
* [[Brush]]を[[Suspicious Sand]]/[[Suspicious Gravel|Gravel]]に使用した際。
|
* '''Origin'''：Suspicious Sand/Gravelの座標。
|
* '''{{cd|this}}'''：Suspicious Sand/GravelにBrushを使用したエンティティ。
|-
| {{cd|gift}} || 
* ネコの朝の贈り物、[[スニッファー]]が地面から古代の種を発掘した際、または襲撃撃破時の村人からの贈り物を生成する際。
|
* '''Origin'''：村人及びネコの位置。
* '''{{cd|this}}'''：贈り物の対象となるエンティティ。
|
|-
| {{cd|barter}} ||
* [[ピグリン]]との[[物々交換]]時。
|
* '''{{cd|this}}'''：物々交換をしたピグリン。
|
|-
| {{cd|advancement_reward}} ||
* [[進捗/JSONフォーマット|進捗達成報酬]]のアイテム生成に使用するように設定されたルートテーブル内。
|
* '''{{cd|this}}'''：進捗を達成したプレイヤー。
* '''Origin'''：進捗達成時のプレイヤーの位置。
|
|-
| {{cd|advancement_entity}} ||
* ルートテーブル内では使用されないため、ルートテーブル上で{{cd|"type":"advancement_entity"}}を指定しても意味を為さない。
* 進捗が、エンティティに関する達成要件の確認などの目的でプレディケートを呼び出す際に内部的に用いられる。
|-
| {{cd|advancement_location}} ||
* ルートテーブル内では使用されないため、ルートテーブル上で{{cd|"type":"advancement_location"}}を指定しても意味を為さない。
* 進捗が、ブロックに関する達成要件の確認などの目的でプレディケートを呼び出す際に内部的に用いられる。
|
* '''{{cd|this}}'''：プレディケートによる確認を受けたエンティティ。
* '''Origin'''：この達成要件トリガーを発生させたプレイヤーの座標。
* '''Block state'''：設置・操作を受けたブロック及びそのブロック状態。
* '''Tool'''：操作・設置に使用された道具。
|-
| {{cd|generic}} || 
* 使用されていない。これを使用する場合、データパック読み込み時状況パラメータの確認を行わない。
| なし || なし
|-
| {{cd|block}} ||
* 破壊されたブロックからのドロップ時。
* コマンド{{cmd|loot &hellip; mine &lt;pos&gt;}}の実行時。
|
* '''Block state'''：破壊されたブロック及びそのブロック状態。
* '''Origin'''：破壊されたブロックの座標。
* '''Tool'''：破壊に使用された道具。
|
* '''{{cd|this}}'''：ブロックを破壊したプレイヤー。
* '''Block entity'''：破壊されたブロックがブロックエンティティであった場合のみ与えられる、ブロックエンティティデータ。
* '''Explosion radius'''：ブロックが爆風によって破壊された場合にのみ与えられる、幕臣からの半径。
|}

== 歴史 ==

{{History|java}}
{{history||1.9|snap=2015年10月19日|slink={{tweet|Dinnerbone|656102828595920896}}|[[Dinnerbone]] がルートテーブルについて発表した。}}
{{history|||snap=15w43a|ルートテーブルが追加された。}}
{{history|||snap=15w43b|'''entity_scores''' の条件が追加された。}}
{{history|||snap=15w43c|「villager_golem.json」が「iron_golem.json」に改名された。
|釣り、羊毛をドロップしないヒツジ、ゾンビおよびスケルトンホースのルートテーブルが追加された。
|{{nbt|string|item:}} タグが {{nbt|string|name:}} に、{{nbt|compound|items:}} タグが {{nbt|compound|entries:}} に改名された。
|{{nbt|string|type:}} タグとアイテムの代わりにルートテーブルを読み込むサポートが追加された。
|{{nbt|int|luck:}} タグのデフォルトファイルとして追加された。当時は特に機能を持たなかった。
|'''set_damage''' の関数が追加された。
}}
{{history|||snap=15w44a|'''enchant_randomly''' と '''set_attributes''' の関数が追加された。}}
{{history|||snap=15w44b|{{nbt|int|quality}} タグが追加された。
|{{nbt|int|luck}} と {{nbt|float|luck_multiplier}} タグが削除された。
|{{nbt|compound|bonus_rolls}} タグが追加された。}}
{{history|||snap=15w51a|[[スペクテイター]]モードのプレイヤーが収納ブロックの中身を閲覧しようとした際に、ルートテーブルによって中身が生成されなくなった。}}
{{History||1.9.1|snap=1.9.1-pre1|[[ディスペンサー]]と[[ドロッパー]]で使用可能になった。
|デフォルトのルートテーブル<code>chests/jungle_temple_dispenser</code> が追加された。}}
{{History||1.11|snap=16w32a|ロバ、ラバ、ハスク、村人ゾンビは、ウマやゾンビで使用されるルートテーブルではなく、それぞれ個別のルートテーブルを持つようになった。}}
{{History|||snap=16w43a|村人、ヴェックス、エンダードラゴンが自身のルートテーブルを持つようになった。}}
{{History||1.13|snap=17w43a|カスタマイズしたルートテーブルの格納場所が、[[データパック]]内に移動した。}}
{{History||1.14|snap=18w43a|破壊したブロックからのドロップに、ルートテーブルが使用されるようになった。
|ルートテーブルに様々な設定項目が追加された。
|チェスト及びブロックのルートテーブルにおいて、エンティティを指定するところでルート状況パラメータ{{cd|this}}を使用すると、プレイヤーを指定できるようになった。}}
{{History|||snap=18w44a|ネコの贈り物用のルートテーブル{{cd|cat_morning_gift}}と、プレイヤーおよびウィザーのルートテーブルが追加された。
|新しいブロック用のルートテーブルが追加された。|アイテム関数{{cd|set_lore}}が追加された。}}
{{History|||snap=18w46a|イリュージョナーのルートテーブルが追加された。}}
{{History|||snap=18w48a|村のチェスト用の{{tooltip|様々なルートテーブル|village_cartographer, village_desert_house, village_plains_house, village_savanna_house, village_snowy_house, village_taiga_house, village_tannery, village_weaponsmith}}が追加されたが、一部は当時は使用されていなかった。
|ルートテーブル{{cd|village_blacksmith}}が削除された。}}
{{History|||snap=18w49a|{{cd|d=and|village_savanna_house|village_snowy_house}}が実際に使用されるようになった。
|村のチェスト用の{{tooltip|追加のルートテーブル|village_armorer, village_butcher, village_mason, village_shepherd}}が追加された。}}
{{History|||snap=18w50a|{{cd|village_desert_house|village_taiga_house}}が使用されるようになった。これにより、未使用だったルートテーブルがすべて実装された。}}
{{History|||snap=?|空のルートテーブルがハードコード化された。}}
{{History||1.15|snap=19w34a|アイテム関数{{cd|copy_state}}が追加された。}}
{{History||1.16|snap=20w12a|釣り竿の浮きのプロパティを確認するため、サブプレディケート fishing_hook が追加された。}}
{{History||1.20|snap=Pre-release 1|ルートテーブルからアイテムを生成する際に、名前付きの乱数列を使用するようになった。|各ランダム配列は、ワールドのシード値と配列IDに従って特有のアイテムの配列を生成する。これにより、同じワールド・同じパラメータでルートテーブルを機能させた場合には同じ結果が帰って来る。
|ルートテーブルが使用する乱数列のIDを指定する新しいフィールド{{cd|random_sequence}}が追加された。}}
{{History|||snap=Pre-release 6|ランダム配列のID（{{nbt|string|random_sequences}}）の指定が任意になった。配列のIDが与えらなかった場合は、非決定的な乱数列を使用する。}}
{{History||1.20.2|snap=23w32a|アイテム関数を使用する際に、ルートテーブル上からでもJSON配列形式を使用することで複数のルート関数をアイテム関数{{cd|sequence}}と同様の振る舞いで実行することができるようになった。
|プレディケートを使用する際に、ルートテーブル上からでもJSON配列形式を使用することで条件の種類{{cd|all_of}}と同様の振る舞いで実行することができるようになった。}}

{{History|foot}}

== 問題点 ==
{{issue list}}

== 脚注 ==
{{Reflist}}

{{Data packs}}

[[de:Beutetabellen]]
[[en:Loot Tables]]
[[es:Tabla de botín]]
[[fr:Table de butin]]
[[ko:노획물 목록]]
[[nl:Buittabel]]
[[pl:Tabela łupów]]
[[pt:Tabela de itens]]
[[ru:Таблицы добычи]]
[[zh:战利品表]]

{{デフォルトソート:るうとてえふる}}