建立寶箱

寶箱是一項讓管理員能製作寶箱的功能，這些寶箱可以掉落戰利品，也可以生成擬態怪（敵對）Boss。

數值

isEnabled

設定某個寶箱是否啟用。

Key	Values	Default
isEnabled	Boolean	false

已停用的寶箱會被完全略過：它們不會被放置到世界中，也不會被 /em place treasureChest 提供或接受。請先把此項設為 true，再嘗試放置該寶箱。

範例

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。

特殊 [1]

展開表格

面向
NORTH
SOUTH
WEST
EAST

---

dropStyle

設定該寶箱是要給單一玩家還是多位玩家掉落。

SINGLE 寶箱會被第一位開啟它的玩家消耗掉：該方塊會被替換成空氣、寫入一個 restockTime，並在經過 restockTimer 分鐘後重新出現。它沒有任何每玩家追蹤，因此先到的人就拿走整箱。

GROUP 寶箱永遠不會從世界中被移除。取而代之的是，每位開啟它的玩家都會有自己的冷卻時間，因此每位玩家在每個補貨週期都能取得一次戰利品。這些冷卻時間會被儲存在 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

設定生成敵對 Boss 而非掉落戰利品的機率。

Key	Values	Default
mimicChance	Double	0

此擲骰在每次互動時進行，且在產生任何戰利品之前。當擲骰成功時，擬態怪會生成而取代戰利品掉落——寶箱絕不會兩者都給。無論結果如何，寶箱的冷卻時間都會被消耗。

範例

mimicChance: 0.5

---

mimicCustomBossesList

指定可用於生成的敵對 Boss 清單。系統會從這份清單中隨機選出一個 Boss 來生成。

這份清單也支援權重系統，你可以運用它來確保某些 Boss 比其他 Boss 更常被選中。

Key	Values	Default
mimicCustomBossesList	String List	none

範例

mimicCustomBossesList:
- my_cool_mimic_boss.yml
- weak_mimic_boss.yml

如果你想為這些 Boss 指定權重，清單應以下列方式編寫：

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

在這個設定中，my_cool_mimic_boss.yml 比 weak_mimic_boss.yml 更有可能被選中生成。

沒有權重後綴的項目，以及權重無法被解讀為數字的項目，都會退回使用權重 1。

擬態怪會以什麼等級生成？

這取決於你指向的 Boss 檔案，而不是寶箱：

擬態怪 Boss 的 level	生成等級
固定數字	chestTier × 10，再加上隨機的 0-10
dynamic（-1）且位於動態副本中	該副本所選的等級，±1
dynamic（-1）位於其他任何地方	開啟者的自然生成等級，±1

若清單中指名的 Boss 檔案找不到，就不會生成擬態怪並記錄一則警告——玩家什麼都拿不到，也拿不到戰利品。

---

restockTimer

設定寶箱重新填入戰利品之前的時間，以分鐘為單位。

Key	Values	Default
restockTimer	Integer	0

對於 SINGLE 寶箱，這是方塊在被放回之前會消失多久。對於 GROUP 寶箱，這是每位玩家在能再次取得戰利品之前必須等待多久。

把此項保持在預設的 0，實際上等於完全沒有冷卻，因此該寶箱可以被反覆刷取。凡是會掉落有價值物品的寶箱，都請設定一個實際的值。

範例

restockTimer: 30

---

effects

注意： 此設定目前沒有任何作用。該鍵仍會從設定檔中被讀取而不報錯，也仍會與其他預設值一起被寫出，但外掛中沒有任何部分會消費解析後的值，因此寶箱永遠不會產生任何粒子。

如果你想在寶箱周圍產生粒子，目前請改用其他來源來產生。

Key	Values	Default
effects	String List	none

---

locations

設定該寶箱會生成的位置。

你可以站在想要的位置上，使用 /em place treasureChest <treasurechestfilename.yml> 來新增位置。這個指令會自動把你目前的座標加入該寶箱的位置清單，並更新設定檔。

Key	Values	Default
locations	String List	none

每個項目使用 worldName,x,y,z,yaw,pitch 格式。也接受較短的 worldName,x,y,z 形式，此時 yaw 與 pitch 會被視為 0。

項目可以帶有 :unixTimestamp 後綴，這是 EliteMobs 用來儲存該個別寶箱擺放點補貨時間的方式。當 SINGLE 寶箱被取走時，外掛會自行寫入此後綴——你不需要自己加，也可以刪除它讓該寶箱立即可用。

一個檔案可以容納任意多個位置，而每個位置都會成為擁有自己補貨計時器的獨立寶箱。

範例

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。

Key	Values	Default
chestTier	Integer	0

chestTier 實際上有多重要，取決於寶箱在哪裡，以及戰利品表中是哪一類物品：

情境	戰利品掉落的等級
在任何實例之外開啟的寶箱	scalable 精英物品會跟隨開啟者的等級，±1。其餘皆使用 chestTier * 10。
位於動態副本內的寶箱	所有物品都使用該副本所選的等級，scalable 精英物品則有 ±1。chestTier 會被忽略。
位於其他任何實例內的寶箱	所有物品都使用 chestTier * 10。

因此在一般生存世界中，chestTier 大致上只決定你的 fixed 與 limited 物品的等級，而 scalable 物品則跟隨開啟寶箱的玩家。請注意擬態怪使用的是不同的公式——請參閱 mimicCustomBossesList。

把此項保持在預設的 0 會讓戰利品的基準等級為 0。

範例

chestTier: 3

---

instanced

設定該寶箱是否應為實例化（用於副本地城）。 當寶箱被放置在地城中時，所有補貨計時器都會被停用。

請勿手動設定此數值。

Key	Values	Default
instanced	Boolean	false

範例

instanced: true

---

restockTime

在寶箱被取走戰利品之後，外掛會寫入此鍵以追蹤補貨時間。

此鍵只會被舊式的單一寶箱格式使用，也就是寶箱位置存放在 location 鍵而非 locations 清單中的情況。一旦檔案中有任何 locations 項目，補貨時間就會改以 :unixTimestamp 後綴寫在對應的 locations 項目上，而此鍵則不會被動用。

請勿手動設定此數值。

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
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 並不是數字，因此該項目會在每次啟動時記錄一則解析警告。