宝箱の作成

宝箱は、戦利品を渡すか、敵対的なミミックボスを出現させるチェストです。設定ファイルは plugins/EliteMobs/customtreasurechests に配置します。

値

isEnabled

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

キー	値	初期値
isEnabled	Boolean	true

このキーがないファイルは有効として読み込まれます。無効なチェストは完全にスキップされます。ワールドに設置されず、/em place treasureChest の対象にもなりません（提示もされず、受け付けもされません）。

例

isEnabled: true

---

chestType

ブロックの素材を指定します。CHEST や BARREL のように向きを持つ容器を使用してください。通常の容器インベントリに中身を入れる設定ではなく、操作時に lootList から戦利品を生成します。

キー	値	初期値
chestType	Material	CHEST

例

chestType: CHEST

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

---

facing

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

キー	値	初期値
facing	補足 [1]	NORTH

例

facing: NORTH

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

補足 [1]

テーブルを展開

向き
NORTH
SOUTH
WEST
EAST

---

dropStyle

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

SINGLE は最初に操作したプレイヤーが消費します。ブロックは空気に変わり、再補充の期限が保存されます。restockTimer 分が経過し、チャンクが読み込まれていると再出現します。プレイヤー別の管理はありません。左クリックでも右クリックでも作動します。

GROUP はワールドに残り、プレイヤーごとにクールダウンを管理します。インスタンス外では、同じ設定ファイルの全配置が restockTimers を通じてそのプレイヤーの期限を共有します。別々に取得可能にするには設定ファイルを分けてください。インスタンス内では、各実行中の宝箱が個別に取得済みプレイヤーを記録します。

どちらの方式も操作した本人に個人用の戦利品を渡します。GROUP はパーティーの戦利品投票を開始せず、周囲の全員に報酬を配ることもありません。他のプラグインが既にキャンセルした操作は無視され、通常のブロック破壊も防止されます。開封にギルドランクは不要です。

キー	値	初期値
dropStyle	SINGLE / GROUP	SINGLE

例

dropStyle: SINGLE

---

lootList

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

条件を満たす各エントリは独立して抽選されるため、1回で複数の報酬を得られます。権限、個数、該当するダンジョン難易度の条件も適用されます。ItemSettings.yml の putLootDirectlyIntoPlayerInventory で、インベントリへの直接配布か宝箱の位置へのドロップを選びます。直接配布で入りきらないエリートアイテムはプレイヤーの足元に落ち、そのプレイヤーが所有者に設定されます。

キー	値	初期値
lootList	EM戦利品テーブル	なし

例

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

どのエントリも報酬を渡せなかった場合、config.yml の treasureChestNoDropMessage を表示します。抽選に外れた場合だけでなく、報酬を生成できなかった場合も対象です。クールダウンは消費されます。

---

mimicChance

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

条件を満たす操作ごとに、戦利品生成前に抽選します。当選すると戦利品の代わりにミミックの出現を試み、両方を与えることはありません。0～1 を指定し、0.5 は50%です。選ばれたボスが見つからない場合や出現に失敗した場合も、クールダウンは消費されます。

キー	値	初期値
mimicChance	Double	0

例

mimicChance: 0.5

---

mimicCustomBossesList

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

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

キー	値	初期値
mimicCustomBossesList	文字列リスト	なし

例

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

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

±1の計算結果は最低レベル 1 です。ダイナミックダンジョン外でプレイヤーのインベントリ情報が取得できない場合、dynamicミミックはボスの通常の出現処理を使います。ダンジョン内で生成されたミミックは、その戦闘に所属します。

---

restockTimer

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

インスタンス外では、SINGLE はこの時間が経過してチャンクが読み込まれているとブロックを復元します。GROUP はプレイヤー別の待ち時間に使います。期限は再起動後も保持されます。インスタンス固有の動作は instanced を参照してください。

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

キー	値	初期値
restockTimer	整数	0

例

restockTimer: 30

---

effects

注: この設定には効果がありません。設定の読み込みは行われますが、宝箱の処理では使用されず、パーティクルも生成しません。

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

キー	値	初期値
effects	文字列リスト	なし

---

locations

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

目的のブロック上で /em place treasureChest <treasurechestfilename.yml> を実行します。elitemobs.place.admin を持つプレイヤーと、読み込み済みで有効な宝箱設定が必要です。ファイルにブロック座標を保存し、宝箱をすぐに設置します。既に登録されているブロックで実行すると、2つ目のエントリを追加する代わりに、その配置の補充期限をリセットします。

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

任意の接尾辞 :unixTimestamp は、その配置の補充期限をUnix時刻の秒で保存します。SINGLE の取得時にEliteMobsが書き込みます。手動で期限を削除する前にサーバーを停止してください。変更は設定の読み込み時に反映され、既に動作中の宝箱をリセットするものではありません。

1つのファイルに複数の位置を保存できます。SINGLE は位置ごとに期限を持ち、インスタンス外の GROUP はプレイヤー別の待ち時間リストを共有します。

小数の座標は、その座標が含まれるブロックに切り捨てられます。旧形式の location と locations は併用しないでください。読み込みでは location が優先されますが、空でない locations があると期限の保存先はそちらになります。/em remove で宝箱を削除すると、クリックした配置だけがファイルから削除され、他の配置はそのまま残ります。

キー	値	初期値
locations	文字列リスト	なし

例

locations:
- my_world,10,50,10,0,0
- my_nether_world,12,58,12,0,0
- my_world,80,64,-30,0,0:1707394380

---

chestTier

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

キー	値	初期値
chestTier	整数	0

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

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

これらはアイテム生成に渡すレベルです。fixed は作者が設定した能力値を保持し、limited は設定された上限に従います。宝箱がこの拡張ルールを上書きすることはありません。通常のサバイバルでは scalable が開封者に追従します。ミミックは別の式を使うため、mimicCustomBossesList を参照してください。

±1の計算結果は最低レベル 1 です。インスタンス外でプレイヤーのインベントリ情報がない場合は、chestTier * 10 に戻ります。

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

例

chestTier: 3

---

instanced

インスタンス用の宝箱かどうかを指定します。取得後に通常の補充処理は予約されず、SINGLE はブロックを削除し、GROUP はその宝箱をプレイヤーごとに1回だけ取得可能にします。同時に存在するインスタンスは別々の状態を保持します。

ただし SINGLE では、チャンクをアンロードして再読み込みすると、動作中の補充期限で再び補充が予約されます。その期限後に同じインスタンス内で再出現する場合があります。インスタンス中ずっとプレイヤーごとに1回という制限を保つには GROUP を使ってください。

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

キー	値	初期値
instanced	Boolean	false

例

instanced: true

---

restockTime

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

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

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

キー	値	初期値
restockTime	Unixタイムスタンプ（秒）	0

例

restockTime: 1707394380

---

restockTimers

GROUP モードのチェストのプレイヤーごとのクールダウンデータを格納します。プレイヤーが宝箱を開けるとプラグインがこれを自動的に書き込み、書き込むたびに期限切れのエントリを削除します。クールダウンは戦利品を渡す前に保存されます。保存に失敗した場合、プレイヤーには後でもう一度試すよう伝えられ、何も受け取りません。

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

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

キー	値	初期値
restockTimers	文字列リスト	なし

例

restockTimers:
- '12345678-abcd-4ef0-8123-123456789012:1707394380'
- '09876543-abcd-4ef0-8123-098765432109:1707395000'

各エントリは、プレイヤーUUIDと秒単位のUnixタイムスタンプをコロンで区切ったものです。

---

宝箱の設定例

isEnabled: true
chestType: CHEST
facing: NORTH
chestTier: 3
dropStyle: GROUP
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=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 は数値ではないため、起動のたびに解析警告がログに出力されます。