カスタム戦利品テーブル

汎用の戦利品フォーマットです。EliteMobsでいくつかの異なる場所で使用されます。

これは最新のフォーマットであり、使用することが推奨されるものですが、いくつかの代替となる古いフォーマットも存在することに注意してください。

注意： レガシーフォーマットのサポートは、コロン区切りの構文filename.yml:chance:permissionを使用して引き続き利用できます。ただし、新しい設定には以下に示す最新フォーマットが推奨されます。

設定を追加する前に、必ず戦利品テーブルをuniqueLootList:で始めてください。そうしないと .yml 設定でエラーが発生します。

エリートアイテムをドロップする：

Key	Details	Values	Default
filename	使用するカスタムアイテムのファイル名を設定します。	Filename	none

例

uniqueLootList:
  - filename: magmaguys_toothpick.yml

これにより、Mobは MagmaGuy's Toothpick を1個、100%のドロップ確率でドロップします。

一般設定：

Key	Details	Values	Default
chance	戦利品がドロップする確率を設定します。1.0 が100%です。	Double	1.0
amount	この戦利品エントリをドロップする数量を設定します。通貨エントリでは無視されます — その場合は currencyAmount を使ってください。	Integer	1
permission	プレイヤーがこの戦利品を受け取るために必要なパーミッションノードを設定します。エリートアイテム、通貨、コマンドの各エントリでサポートされます。バニラアイテムのエントリは、どちらのフォーマットでもこれを読みません。	String	none

例

uniqueLootList:
  - filename: magmaguys_toothpick.yml
    chance: 0.5
    amount: 10
    permission: elitemobs.loot.rare

これにより、Mobは MagmaGuy's Toothpick を10個、50%のドロップ確率でドロップしますが、elitemobs.loot.rareパーミッションを持つプレイヤーに対してのみです。

エリートコインをドロップする：

Key	Details	Values	Default
currencyAmount	ドロップされるコインの量を設定します。	Integer	none

例

uniqueLootList:
  - currencyAmount: 344
    chance: 0.5

これにより、Mobは Elite Coins を344枚、50%のドロップ確率でドロップします。

バニラアイテムをドロップする：

Key	Details	Values	Default
material	ドロップされるアイテムのマテリアルを設定します。Minecraftのマテリアル名を受け入れます（大文字小文字を区別しません）。materialの代わりにtypeを使用することもできます。	Material	none

例

uniqueLootList:
  - material: APPLE
    chance: 0.3
    amount: 5

これにより、Mobは リンゴ を5個、30%のドロップ確率でドロップします。

戦利品ドロップ時にコマンドを実行する：

戦利品がドロップしたときにコンソールコマンドを実行できます。これは、他のプラグインと統合したり、カスタム報酬を提供したりするのに便利です。コマンドエントリはコロン区切りの文字列フォーマットのみを使用します。

コマンド自体に : や 2 つ目の = を含めることはできません。エントリの解析時に、その両方の文字で分割されるためです。

How chance behaves for commands

コマンドのエントリは chance を2 回判定し、2 回目は反転されます。そのため、コマンドが実際に実行されるのは chance × (1 - chance) の割合です。

• chance=1.0（省略時のデフォルト）では、コマンドはまったく実行されません。
• chance=0.5 が達成可能な最大値で、25% になります。
• chance=0.9 では 9% になります。

コマンドのエントリには必ず 1.0 未満の明示的な chance を設定し、実際の発動率は書いた数値より低くなることを見込んでください。

Key	Details	Values	Default
command	実行するコンソールコマンドを設定します。プレイヤー名のプレースホルダーとして%player%を使用します。	String	none

例

uniqueLootList:
  - command=give %player% diamond 1:chance=0.5:amount=1:permission=elitemobs.loot.command

これにより、Mobが倒されたときにコンソールからコマンドgive <player> diamond 1が、およそ25%の割合で実行されます（上記の警告を参照）。%player%プレースホルダーは実際のプレイヤー名に置き換えられます。elitemobs.loot.commandパーミッションを持つプレイヤーのみがこのコマンドをトリガーします。

アリーナ報酬：

アリーナの戦利品テーブルを作成する際は、必ず戦利品テーブルをuniqueLootList:ではなくrawArenaReward:で始めてください。

Key	Details	Values	Default
wave	この戦利品エントリがドロップするウェーブを設定します。アリーナでのみ使用します。バニラアイテムエントリではマップフォーマットでサポートされますが、エリートアイテム（filename）エントリでは文字列フォーマットでのみサポートされます。	Integer	-1
itemLevel	戦利品ドロップのレベルを設定します。アリーナでのみ使用し、エリートアイテム（filename）エントリでのみ読み取られます。マップフォーマットではなく、文字列フォーマットでのみ利用できます。	Integer	1

Both of these have traps

• ウェーブ報酬として登録されるのは、wave が 1 以上のエントリだけです。wave のないアリーナ報酬エントリは解析され受け付けられますが、どのウェーブからも配られることはありません。
• itemLevel のデフォルトはアリーナやプレイヤーのレベルではなく 1 です。したがって、明示的な itemLevel なしにアリーナが与える scalable のエリートアイテムは、レベル 1 のアイテムとしてドロップします。

例

rawArenaReward:
  - material: BREAD
    wave: 1
    amount: 10
    chance: 0.5
  - filename=magmaguys_toothpick.yml:wave=1:itemLevel=2

プレイヤーが最初のウェーブを突破すると、アリーナは パン を10個、50%のドロップ確率でドロップし、レベル2の MagmaGuy's Toothpick を1個、100%のドロップ確率でドロップします。

ここではエリートアイテム（filename）エントリが文字列フォーマットを使用していることに注意してください。waveとitemLevelは、文字列フォーマットのエリートアイテムエントリでのみ解析されるためです。バニラアイテムエントリ（上記のmaterial: BREADのような）は、マップフォーマットでwaveを受け入れます。

インスタンスダンジョン：

Key	Details	Values	Default
difficultyID	この戦利品がドロップするインスタンスダンジョンの難易度を設定します。インスタンスダンジョンでのみ使用します。	String	none

difficultyID は、下記のマップフォーマットで書かれたエリートアイテム（filename）のエントリでのみ読み取られます。コロン区切りの文字列フォーマットでは解析されず、バニラ、通貨、コマンドの各エントリでも読み取られません。

また、効果を持つのはカスタムボスの戦利品に対してのみです。宝箱、クエスト、アリーナの戦利品がこれを評価することはありません。

インスタンスダンジョン内では、エントリは次のように振る舞います。

• ダンジョンの難易度が difficultyID と一致する場合：アイテムはキルしたプレイヤーへ直接渡されるのではなく、ボスの共有グループ戦利品テーブルに入り、パーティ全体がそこから受け取れます。
• ダンジョンの難易度が一致しない場合：そのエントリはスキップされます。
• プレイヤーがそもそもインスタンスダンジョン内にいない場合：difficultyID は無視され、アイテムは通常どおりドロップします。

例

uniqueLootList:
  - filename: magmaguys_toothpick.yml
    chance: 0.5
    difficultyID: 1

これにより、プレイヤーが難易度1でボスを倒した場合、Mobは MagmaGuy's Toothpick を1個、50%のドロップ確率でドロップします。