ダメージの種類のソースを表示

{{about|データパックの内容物|ゲームの仕様|ダメージ}}
{{wip}}
{{exclusive|java}}
'''ダメージの種類'''（{{en|Damage Type}}）とは、[[死亡メッセージ]]やエンティティの耐性、再生されるサウンドといったダメージの振る舞いを定義したファイルである。

これに加え、ビルトインの[[タグ#ダメージの種類|ダメージの種類タグ]]もダメージの様々な振る舞いを定義している。

カスタマイズしたダメージの種類に関しては、現在{{cmd|damage}}を用いてのみ与えることができる。

== ファイルのフォーマット ==
ダメージの種類は、[[データパック]]内の<code>data/<名前空間>/damage_type/<ダメージの種類名>.json</code>に、[[JSON]]形式で保存されている。

<div class="treeview">
*{{nbt|compound}}：上位のオブジェクト。
**{{nbt|string|message_id}}：別の文字列と組み合わせて[[死亡メッセージ]]の翻訳キーとなり、このダメージが原因で死んだ場合に表示される死亡メッセージを指定する文字列。組み合わせる文字列は、{{nbt|string|death_message_type}}によって[[#死亡メッセージ|後述]]のように決定される。 
**{{nbt|float|exhaustion}}：この種類のダメージを受けた時に、[[満腹度#満腹度の消耗|満腹度消費度]]が増大する程度を決定する。
**{{nbt|string|scaling}}：この種類のダメージのダメージ量が、[[難易度]]によってどのように変化するかを決定する。<br>取りうる値は{{cd|never}}、{{cd|always}}、{{cd|when_caused_by_living_non_player}}である。詳細は[[#倍率|後述]]。
**{{nbt|string|effects}}：被ダメージ時の演出を決定する任意のフィールド。<br>取りうる値はは{{cd|hurt}}（通常のダメージ、デフォルト）、{{cd|thorns}}（棘の鎧）、{{cd|drowning}}（溺没）、{{cd|burning}}（炎上）、{{cd|poking}}（ベリーの棘）、{{cd|freezing}}（凍傷）。詳細は[[#演出|後述]]。
**{{nbt|string|death_message_type}}：{{nbt|string|message_id}}から死亡メッセージの翻訳キーを生成する際に、どのような文字列を組み合わせるかを決定する値。<br>取りうる値は、{{cd|default}}（デフォルト）、{{cd|fall_variants}}（落下ダメージ）、{{cd|intentional_game_design}}（'''<nowiki>[ゲームの仕様]</nowiki>'''）である。それぞれの値に対応する生成方式は、[[#死亡メッセージ|後述]]を参照のこと。
</div>

例：{{cd|minecraft:arrow}}（矢によるダメージ）:<syntaxhighlight lang="json">
{
	"exhaustion": 0.1,
 	"message_id": "arrow",
	"scaling": "when_caused_by_living_non_player"
}
</syntaxhighlight>

== 倍率 ==
ダメージの種類は、そのダメージ量が[[難易度]]によってどのように変化するかを定義している{{info needed|ダメージ倍率の厳密な値}}。

{{nbt|string|scaling}}が取りうる値：
*{{cd|never}}：ダメージは常に一定。
*{{cd|always}}：ダメージが常に難易度によって変化する。
*{{cd|when_caused_by_living_non_player}}：攻撃者<ref group="注釈" name="attacker">厳密には、そのダメージの原因となったエンティティを指す。例えば、通常の攻撃なら攻撃したエンティティが該当するが、スケルトンに撃たれた場合には矢ではなくスケルトンがこれに該当する。但し、[[ディスペンサー]]によって撃たれた場合など発射者が存在しない等の場合は矢自身がこれに相当する。サボテンの棘など、該当するエンティティが存在しないダメージも存在する。</ref>が生物エンティティ<ref group="注釈" name="living">[[防具立て]]もこれに該当する。</ref>且つプレイヤー以外である場合のみ、ダメージが難易度によって変化する。

== 演出 ==
ダメージの種類は、そのダメージをプレイヤーが喰らった際にどのような演出がなされるかを決定している。

{{nbt|string|effects}}が取りうる値：
*{{cd|hurt}}（デフォルト）：{{Sound||Player hurt1.ogg|Player hurt2.ogg|Player hurt3.ogg}}
*{{cd|thorns}}：[[棘の鎧]]およびガーディアンの棘のダメージ音。{{Sound||Thorns1.ogg|Thorns2.ogg|Thorns3.ogg|Thorns4.ogg}}
*{{cd|drowning}}：[[溺没]]の音。{{Sound||Player hurt drowning1.ogg|Player hurt drowning2.ogg|Player hurt drowning3.ogg|Player hurt drowning4.ogg}}
*{{cd|burning}}：[[炎]]によるダメージ音。{{Sound||Player hurt fire1.ogg|Player hurt fire2.ogg|Player hurt fire3.ogg}}
*{{cd|poking}}: [[スイートベリーの低木]]の棘が刺さる音。{{Sound||Player hurt sweet berry bush1.ogg|Player hurt sweet berry bush2.ogg}}
*{{cd|freezing}}: [[粉雪#凍結|凍結]]ダメージの音。{{Sound||Player hurt freeze1.ogg|Player hurt freeze2.ogg|Player hurt freeze3.ogg|Player hurt freeze4.ogg|Player hurt freeze5.ogg}}

== 死亡メッセージ ==
ダメージの種類は、そのダメージが原因で死亡した際に表示する死亡メッセージを決定している。

{{nbt|string|death_message_type}}が取りうる値：
*{{cd|default}}（デフォルト）：通常の死亡メッセージ翻訳キー生成方式を使用する。
*{{cd|fall_variants}}：落下ダメージの死亡メッセージ<code>death.fell.assist.item</code>を生成する。
*{{cd|intentional_game_design}}：「ゲームの仕様に殺された」の死亡メッセージを表示する。

===デフォルトのメッセージ===
通常の死亡メッセージ翻訳キー生成方式が使用されている場合、{{nbt|string|message_id}}を用いて次のように死亡メッセージの翻訳キーを生成する。

* 死因となったダメージが攻撃者<ref group="注釈" name="attacker" />の直接攻撃に因り、さらに攻撃者が名前の付いた[[アイテム]]を持っていた場合は、「<攻撃者>の<アイテム>で～」の死亡メッセージが表示をするために<code>death.attack.<message_id>.item</code>の形式で翻訳キーを作成し、次の挿入文字列を{{nbt|list|with}}として伴う[[Raw JSONテキストフォーマット#被翻訳テキスト|被翻訳テキスト]]を生成する。
*# 死亡したエンティティ
*# 攻撃者の名前
*# アイテムの名前
* 死因となったダメージが攻撃者<ref group="注釈" name="attacker" />に因らないが、死亡したエンティティが直近{{info needed|どの程度の時間？}}に生物エンティティから<ref group="注釈" name="living" />ダメージを受けていた場合には、「<攻撃者>と戦いながら～」の死亡メッセージを表示するために<code>death.attack.<message_id>.player</code>の形式で翻訳キーを作成し、次の挿入文字列を{{nbt|list|with}}として伴う[[Raw JSONテキストフォーマット#被翻訳テキスト|被翻訳テキスト]]を生成する。
*# 死亡したエンティティ
*# 直近の攻撃者
* 上記のどちらにも当てはまらない場合、通常の死亡メッセージを表示するために<code>death.attack.<message_id></code>の形式で翻訳キーを作成し、次の挿入文字列を{{nbt|list|with}}として伴う[[Raw JSONテキストフォーマット#被翻訳テキスト|被翻訳テキスト]]を生成する。
*# 死亡したエンティティ
*# 直近の攻撃者<ref group="注釈" name="attacker" />（いた場合のみ）
<!-- この項は、英語版には~~~~~当時では存在しますが、訳者がその内容は本記事ではなくむしろ[[死亡メッセージ]]に記述されるべき内容であると判断したため省略されています。 = デザイン ==
Because of how the default death messages are set up, most vanilla damage types are divided into ones that will always have an attacker<ref group="注釈" name="attacker" /> and ones that will never have an attacker. Depending on whether there was an attacker, the translation for normal deaths (<code>death.attack.<message_id></code>) will have either one or two available insertions. Translations have no safe way to access an insertion that may or may not be there, so the primary options are:

The death type is planned to always have an attacker.
* The translation looks like<syntaxhighlight lang="json">
"death.attack.mob": "%s was slain by %s",
"death.attack.mob.item": "%s was slain by %s using %s",
</syntaxhighlight>
* The translation key <code>death.attack.<message_id>.player</code> is not provided, since assisted deaths are impossible.

The death type is planned to never have an attacker.
* The translation looks like<syntaxhighlight lang="json">
"death.attack.drown": "%s drowned",
"death.attack.drown.player": "%s drowned whilst trying to escape %s",
</syntaxhighlight>
* The translation key <code>death.attack.<message_id>.item</code> is not provided, since item deaths are impossible.

The death type may or may not have an attacker.
* The translation looks like<syntaxhighlight lang="json">
"death.attack.electricity": "%s was electrocuted",
"death.attack.electricity.item": "%s was electrocuted by %s using %s",
"death.attack.electricity.player": "%s was electrocuted whilst trying to escape %s",
</syntaxhighlight>
* The translation key <code>death.attack.<message_id></code> avoids using the second insertion, since it may or may not be present.
* The translation is a little awkward, since the death message when killed by a player will only mention them if they're holding a named weapon.

To avoid the awkwardness of the third option you can have two different damage types, one for use with an attacker, and one for use without an attacker:<syntaxhighlight lang="json">
"death.attack.active_electricity": "%s was electrocuted by %s",
"death.attack.active_electricity.item": "%s was electrocuted by %s using %s",
"death.attack.passive_electricity": "%s was electrocuted",
"death.attack.passive_electricity.player": "%s was electrocuted whilst trying to escape %s",
</syntaxhighlight>-->

== 歴史 ==
{{History|java}}
{{History||1.19.4|snap=23w06a|[[データパック]]にダメージの種類が追加された。}}
{{History||1.20|snap=1.20 Pre-release 1|新しいダメージの種類、{{cd|outside_border}}と{{cd|generic_kill}}が追加された。}}

{{History|java upcoming}}
{{History||Update 1.21<br>（実験的）|link=Java Edition 1.20.5|snap=23w51a|新しいダメージの種類、{{cd|wind_charge}}が追加された。}}
{{History|foot}}

==注釈==
{{Notelist}}

{{Data packs}}
{{デフォルトソートキー:ためえしのしゆるい}}
[[de:Schadensarten]]
[[en:Damage type]]
[[zh:伤害类型/JSON格式]]