宝箱の作成

宝箱は、管理者がルートをドロップしたり、ミミック（敵対的）ボスをスポーンしたりするチェストを作成できる機能です。

値

isEnabled

宝箱を有効にするかどうかを設定します。

無効なチェストは完全にスキップされます。ワールドに設置されず、/em place treasureChest の対象にもなりません（提示もされず、受け付けもされません）。チェストを設置する前に、これを true にしてください。

Key	Values	Default
isEnabled	Boolean	false

例

isEnabled: true

---

chestType

チェストの素材タイプを設定します。

Key	Values	Default
chestType	Material	CHEST

例

chestType: CHEST

CHESTやBARRELのような有効なチェスト素材である必要があります。

---

facing

チェストの向きを設定します。

Key	Values	Default
facing	Special [1]	NORTH

例

facing: NORTH

チェストが向く方向を設定します。有効な値はNORTH、SOUTH、EAST、WESTです。

Special [1]

テーブルを展開

Facing
NORTH
SOUTH
WEST
EAST

---

dropStyle

チェストが1人のプレイヤー用か複数のプレイヤー用かを設定します。

SINGLE チェストは最初に開封したプレイヤーによって消費されます。ブロックは空気に置き換えられ、restockTime が書き込まれ、restockTimer 分が経過するとブロックが再出現します。プレイヤーごとの追跡はないため、最初にたどり着いた者がすべてを持っていきます。

GROUP チェストはワールドから取り除かれることがありません。代わりに、開封した各プレイヤーがそれぞれのクールダウンに入るため、すべてのプレイヤーが補充期間ごとに 1 回ずつルートを得られます。それらのクールダウンは restockTimers フィールドに保存され、プラグインがファイルに書き込みます。

Key	Values	Default
dropStyle	SINGLE / GROUP	SINGLE

例

dropStyle: SINGLE

---

lootList

開封時に宝箱がドロップすべきルートを列挙します。

Key	Values	Default
lootList	EM Loot Table	none

例

lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=1.0

リスト内のどのエントリも chance の判定に通らなかった場合、チェストが何も与えずに終わらないよう、プレイヤーには config.yml の treasureChestNoDropMessage が送られます。クールダウンは消費されます。

---

mimicChance

ルートをドロップする代わりに敵対的なボスがスポーンする確率を設定します。

判定はインタラクションごとに、ルートが生成される前に行われます。判定に成功すると、ルートがドロップされる代わりにミミックがスポーンします — チェストが両方を行うことはありません。いずれの場合もチェストのクールダウンは消費されます。

Key	Values	Default
mimicChance	Double	0

例

mimicChance: 0.5

---

mimicCustomBossesList

スポーンに利用可能な敵対的なボスのリストを指定します。スポーン用に1体のボスがこのリストからランダムに選択されます。

このリストは、特定のボスが他のボスよりも頻繁に選ばれるようにするためのウェイトシステムにも対応しています。

Key	Values	Default
mimicCustomBossesList	String List	none

例

mimicCustomBossesList:
- my_cool_mimic_boss.yml
- weak_mimic_boss.yml

ボスにウェイトを割り当てたい場合は、リストを次のようにフォーマットする必要があります：

mimicCustomBossesList:
- my_cool_mimic_boss.yml:60
- weak_mimic_boss.yml:40

この設定では、my_cool_mimic_boss.ymlがweak_mimic_boss.ymlよりもスポーンに選ばれやすくなります。

重みのサフィックスがないエントリと、重みが数値として読めないエントリは、どちらも重み 1 にフォールバックします。

ミミックはどのレベルでスポーンするのか？

それはチェストではなく、指定したボスファイルによって決まります。

ミミックボスの level	スポーン時のレベル
固定の数値	chestTier × 10 に、ランダムな 0〜10 を加えたもの
ダイナミックダンジョン内での dynamic（-1）	そのダンジョンの選択レベル ±1
それ以外の場所での dynamic（-1）	開封したプレイヤーの自然スポーンレベル ±1

リストに指定されたボスファイルが見つからない場合、ミミックはスポーンせず警告がログに出力されます — プレイヤーはルートではなく、何も得られません。

---

restockTimer

チェストがルートで補充されるまでの時間を分単位で設定します。

SINGLE チェストではブロックが元に戻るまでの時間、GROUP チェストでは各プレイヤーが再びルートを得られるようになるまでの待ち時間です。

デフォルトの 0 のままにすると実質的にクールダウンがなくなり、チェストを繰り返しファームできてしまいます。価値のあるものをドロップするチェストには、必ず実際の値を設定してください。

Key	Values	Default
restockTimer	Integer	0

例

restockTimer: 30

---

effects

注: この設定は現在何も行いません。キーは設定ファイルからエラーなく読み取られ、他のデフォルトと一緒に書き出されもしますが、解析された値をプラグインのどの部分も消費しないため、宝箱がパーティクルを発生させることはありません。

チェストの周りにパーティクルが欲しい場合は、当面は別のソースから発生させてください。

Key	Values	Default
effects	String List	none

---

locations

宝箱がスポーンする場所を設定します。

希望する場所に立ちながら/em place treasureChest <treasurechestfilename.yml>を使用して場所を追加できます。このコマンドは自動的に現在の位置をチェストの場所リストに追加し、設定ファイルを更新します。

各エントリの形式は worldName,x,y,z,yaw,pitch です。短縮形の worldName,x,y,z も受け付けられ、その場合 yaw と pitch は 0 として扱われます。

エントリには :unixTimestamp のサフィックスが付くことがあります。これは EliteMobs が個々のチェスト設置ごとの補充時刻を保存する方法です。SINGLE チェストがルートされたときにプラグインがこのサフィックスを自分で書き込むため、自分で追加する必要はなく、削除すればそのチェストを即座に利用可能にできます。

1 つのファイルにいくつでも位置を持たせることができ、それぞれが独自の補充タイマーを持つ個別のチェストになります。

Key	Values	Default
locations	String List	none

例

locations:
- my_world,10,50,10,0,0
- my_nether_world,12,58,12,0,0

---

chestTier

チェストのティアを設定します。これはドロップされるルートのレベルの基準値です。基準レベルは chestTier * 10 です。

chestTier が実際にどれだけ影響するかは、チェストの場所とルートテーブル内のアイテムの種類によって変わります。

状況	ルートがドロップするレベル
インスタンス外で開封されたチェスト	scalable のエリートアイテムは開封したプレイヤーのレベル ±1 に従います。それ以外は chestTier * 10 を使用します。
ダイナミックダンジョン内のチェスト	すべてにそのダンジョンの選択レベルが使われ、scalable のエリートアイテムには ±1 が付きます。chestTier は無視されます。
それ以外のインスタンス内のチェスト	すべてに chestTier * 10 が使われます。

したがって通常のサバイバルワールドでは、chestTier は主に fixed と limited のアイテムのレベルを決め、scalable のアイテムは開封したプレイヤーに追従します。ミミックは別の計算式を使う点に注意してください — mimicCustomBossesListを参照してください。

デフォルトの 0 のままにすると、基準のルートレベルは 0 になります。

Key	Values	Default
chestTier	Integer	0

例

chestTier: 3

---

instanced

チェストがインスタンス化されるべきかを設定します（インスタンスダンジョンでの使用向け）。 チェストがダンジョンに配置されると、すべての補充タイマーは無効になります。

この値を手動で設定しないでください。

Key	Values	Default
instanced	Boolean	false

例

instanced: true

---

restockTime

チェストからルートが取られた後、プラグインは補充時間を追跡するためにこのキーを書き込みます。

これは、チェストの位置が locations リストではなく location キーに入るレガシーな単一チェスト形式でのみ使われます。ファイルに locations のエントリが 1 つでもある場合、補充時刻は代わりに該当する locations エントリの :unixTimestamp サフィックスとして書き込まれ、このキーは変更されません。

この値を手動で設定しないでください。

Key	Values	Default
restockTime	Unix Timestamp	0

例

restockTime: 1707394380

---

restockTimers

GROUP モードのチェストのプレイヤーごとのクールダウンデータを格納します。プラグインがこれを自動的に書き込み、読み取り時に期限切れのエントリを削除します。

インスタンス内のチェストはこのリストを使いません — インスタンス内では、プレイヤーごとのクールダウンはそのインスタンスが存続する間だけメモリ上に保持されます。

この値を手動で設定しないでください。

Key	Values	Default
restockTimers	String List	none

例

restockTimers:
- '1234567890-abcd-efgh-ijkl-123456789012:1707394380'
- '0987654321-zyxw-vutr-sqpo-098765432109:1707395000'

各エントリには、プレイヤーUUIDとUnixタイムスタンプがコロンで区切られて含まれています。

---

宝箱の設定例

isEnabled: true
chestType: CHEST
facing: NORTH
dropStyle: GROUP
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- magmaguys_toothpick.yml:chance=0.95
mimicChance: 0.50
mimicCustomBossesList:
- balrog.yml
- killer_rabbit_of_caerbannog.yml
restockTimer: 1
locations:
- world,0.0,-60.0,-14.0,0.0,0.0

上記のルートエントリがすべて filename= の接頭辞を使っている点に注意してください。代わりに magmaguys_toothpick.yml:chance=0.95 と書くとレガシーの filename.yml:chance 形式として読まれ、chance=0.95 は数値ではないため、起動のたびに解析警告がログに出力されます。