建立物品
建立自訂物品
什麼是自訂物品?
自訂物品是 EliteMobs 透過設定檔所定義的物品。你可以自訂這些物品的多個面向,例如物品的等級、附魔、名稱、物品說明、材質等等!
網頁應用程式
你可以在這裡輕鬆快速地建立自訂戰利品!
開始之前
自訂物品放在哪裡?
自訂物品檔案要放入設定資料夾 ~/plugins/EliteMobs/customitems
可以建立子資料夾,例如 ~/plugins/EliteMobs/customitems/myitems。建議這麼做以保持整潔。
檔案以 .yml 檔案格式儲存,而 Notepad++ 是建議用於設定工作的檔案編輯軟體。一個檔案定義一個 BOSS,不過同一個 BOSS 可以被多次生成,甚至可以為同一個 BOSS 檔案設定多個生成位置。
你可以使用網頁應用程式快速且輕鬆地建立自訂 BOSS 及更多內容。
最小的可能設定
請注意,自訂物品最小的可能設定檔為:
注意這就只是一個空檔案。這會預設使用一把名為「Default name」的木劍。本頁所有的一切都是可選的!
範例物品
讓我們看看一個物品檔案長什麼樣子的範例。
範例
isEnabled: true
material: WOODEN_AXE
name: '&4Test item'
lore:
- This is a cool item
- It has cool lore
enchantments:
- DAMAGE_ALL,4
- FLAMETHROWER,1
potionEffects:
- FAST_DIGGING,0,self,onHit
- POISON,0,target,onHit
- GLOWING,0,self,continuous
dropWeight: dynamic
scalability: scalable
itemType: custom
自訂物品設定
以下是一份你可以為自訂物品設定的所有項目的列表:
isEnabled
設定物品是否啟用。不影響已經產生的物品。
| Key | Values | Default |
|---|---|---|
isEnabled | true / false | true |
範例
isEnabled: true
material
設定物品的材質。
| Key | Values | Default |
|---|---|---|
material | 從這個列表挑選! | WOODEN_SWORD |
範例
material: DIAMOND_SWORD
level
設定物品的等級。
| Key | Values | Default |
|---|---|---|
level | Integer | 0 |
請注意,如果你將物品的 scalability 設為 scalable,則此設定無關緊要。如果你將它設為 limited,這將是物品的最高可能等級。
此外,材質有最低等級。鐵製材質為等級 6,鑽石材質為等級 7。你無法強制讓物品的等級低於材質的等級。
範例
level: 100
name
設定物品的顯示名稱。
| Key | Values | Default |
|---|---|---|
name | 含 color codes 的 String | "Default name" |
範例
name: "&2Cool item"
lore
設定物品的物品說明。
| Key | Values | Default |
|---|---|---|
lore | 含 color codes 的 List | none |
範例
lore:
- "&2This is the coolest sword"
- "&2of all time!"
enchantments
設定物品上的附魔。
| Key | Values | Default |
|---|---|---|
enchantments | 含 Minecraft 附魔或 EliteMobs 自訂附魔的 List | none |
請注意,這些條目遵循 enchantmentName:enchantmentLevel 格式。請查看下方的範例!
範例
enchantments:
- "DAMAGE_UNDEAD,8"
- "DURABILITY,4"
- "DAMAGE_ALL,7"
- "LOUD_STRIKES,3"
另請注意,當等級開始超過原版 Minecraft 上限時,像鋒利這類附魔預設會變成精英鋒利。
potionEffects
設定物品將擁有的藥水效果。這些可以套用到玩家身上,或套用到被玩家所傷害的實體身上。
| Key | Values | Default |
|---|---|---|
potionEffects | 含 Minecraft 藥水效果的 List | none |
此外,藥水效果使用一種特定格式,讓管理員能選擇誰會受到影響以及何時受影響:
| Setting | Description | Values | Default |
|---|---|---|---|
| 藥水效果等級 | 設定藥水效果的等級。藥水效果從等級 0 開始! | Integer | none |
| 受影響的實體 | 設定誰會受到藥水效果影響。 | self(玩家)/ target(被擊中的實體) | none |
| 施加方式 | 設定藥水效果何時施加。 | onHit / continuous(持續重新施加) | none |
藥水效果的格式為 potionEffectName,potionEffectLevel,affectedEntity,applicationMethod。最後兩個參數(affectedEntity 與 applicationMethod)是可選的,若未指定則分別預設為 self 與 continuous。請查看下方的範例!
藥水效果持續時間:
- 持續性效果在物品被持有或裝備時每秒重新整理(每次施加持續 2 秒,因此效果永不中斷)
- 夜視獲得 15 秒的特殊持續時間
- 受擊時效果使用基於伺服器設定的持續時間
當你檢視帶有藥水效果的物品時,你會看到指示效果如何施加的圖示:
- ☠️ 骷髏頭 – 鎖定敵人。
- 🛡️ 盾牌 – 鎖定使用者/玩家。
- ⚔️ 劍 – 受擊時啟動。
- 🔄 循環圈 – 在物品被穿戴或持有時持續施加。
EliteMobs 也具備作為護身符運作的自訂物品。這些物品不做別的,只在物品被持有或裝備在某個欄位時為玩家提供藥水效果。
警告:使用 INSTANT_DAMAGE 藥水效果會在命中時治療亡靈怪物,因為這是原版 Minecraft 的預設機制。
範例
potionEffects:
- "POISON,0,target,onHit"
- "HEAL,1,self,onHit"
- "NIGHT_VISION,0,self,continuous"
有了這組藥水效果,將會發生以下情況:
受擊時,中毒藥水效果(等級 1)會施加到被玩家擊中的實體身上。此外,玩家會受到等級 2 的瞬間治療藥水效果。
持續性地,玩家會被給予夜視。這表示只要玩家穿戴或持有該物品,他們就會擁有夜視。
scalability
設定物品的等級如何隨掉落它的 BOSS 的等級而成長。
| Key | Values | Default |
|---|---|---|
scalability | fixed、limited 或 scalable。請看下方! | scalable |
請查看這個列表以了解不同選項的作用!
| Setting | Description |
|---|---|
fixed | 物品等級將永遠是設定檔中所設定的等級。 |
limited | 物品的最高等級將受限於設定檔中所設定的等級或 BOSS 的等級,取兩者中較低者。 |
scalable | 物品的等級將完全基於掉落它的 BOSS 的等級。 |
請注意,帶有 dropWeight 的物品永遠會是 fixed 縮放方式。
範例
scalability: "scalable"
itemType
設定你可以從哪裡取得該物品。
| Key | Values | Default |
|---|---|---|
itemType | custom、unique 或 droppable。請看下方! | custom |
有三種物品類型:
| Setting | Description |
|---|---|
custom | 該物品將能從任何可掉落戰利品的 EliteMobs 怪物掉落,並會出現在自訂商店中。 |
unique | 該物品不會被任何 BOSS 掉落,也不會出現在自訂商店中。取得它的唯一方法是設定一個自訂 BOSS,透過其 uniqueLootList 來掉落它! |
droppable | 該物品會像 custom 一樣進入隨機精英掉落池,但會被排除在商店之外——玩家可以將它作為一般的精英掉落物找到,但永遠無法直接購買。對於應感覺像是努力獲得、但不需要鎖定在特定 BOSS 的物品很有用。 |
範例
itemType: "unique"
dropWeight
設定物品將歸入的戰利品表。
| Key | Values | Default |
|---|---|---|
dropWeight | dynamic 或一個 Double 數值。 | dynamic |
EliteMobs 為自訂物品設有 5 種不同的戰利品表,不包括像自訂 BOSS 上的 uniqueLootList 那樣直接設定的戰利品表。
它們如下:
| Loot table | Description | Default weight |
|---|---|---|
| 程序化產生的物品 | 基於伺服器設定檔隨機產生的物品 | 90.0 |
| 加權物品 | 擁有非 dynamic 權重的物品 | 1.0 |
| 固定物品 | 擁有固定縮放方式的物品 | 10.0 |
| 受限物品 | 擁有受限縮放方式的物品 | 3.0 |
| 可縮放物品 | 可縮放的物品 | 6.0 |
當一隻 BOSS 死亡時,系統會根據 ItemSettings.yml 設定檔從這些表中選出一件物品。權重的預設值列於上方的 Default weight 中。權重越高,物品掉落的可能性就越高。
加權物品 的 Default weight 很小,意思是它們不會很常掉落。dropWeight 為非 dynamic 的物品旨在做為稀有物品,且僅用於 BOSS 掉落的護身符的預設——這些物品不直接用於戰鬥,而是用來以藥水效果增益玩家。
你在此設定的 dropWeight 設定的是特定 加權物品 從 加權物品 列表中掉落的機率。它不會提高 加權物品 掉落的機率。
如果你感到困惑,而你只是想製作武器與護甲,請跳過此設定,因為它正確地預設為 dynamic。
加權物品 通常擁有 1.0 的權重。
範例
dropWeight: "dynamic"
customModelID
**註:**此設定已被移除。它不再從設定檔中讀取。請改用 customModelV2,它是自 Minecraft 1.21.4+(EliteMobs 9.1.13+)以來唯一被識別的模型 ID 設定。你設定檔中任何既有的 customModelID 條目都將被忽略。
設定物品的材質。需要使用資源包中的有效材質!
| Key | Values | Default |
|---|---|---|
customModelID |
範例(已不再運作)
material: DIAMOND_SWORD
customModelID: 1
此設定已不再運作。請改為遷移到 customModelV2。
customModelV2
自 Minecraft 版本 1.21.4(EM 9.1.13)起,這是用來設定自訂物品模型 ID 的新必要設定。 設定物品的材質。需要使用資源包中的有效材質!
| Key | Values | Default |
|---|---|---|
customModelV2 | String | none |
範例
customModelV2: elitemobs:equipment/magmaguys_toothpick
此設定會為物品指派特定材質。其運作方式如下:
elitemobs:是資源包assets資料夾中的主目錄。equipment是assets/elitemobs/models內的一個子目錄。magmaguys_toothpick是位於資源包assets/elitemobs/models/equipment中的模型檔案。
在此範例中,模型檔案的完整路徑為:
\.minecraft\resourcepacks\elitemobs_resource_pack\assets\elitemobs\models\equipment\magmaguys_toothpick.json
這將使用玩家所使用的 EliteMobs 資源包中的自訂材質 magmaguys_toothpick。如果你想正確使用此功能,建議你將伺服器設定為在玩家登入時提供資源包。
equipmentModelID
設定物品在裝備或穿戴時要使用的另一個獨立模型。需要使用資源包中的有效材質!
| Key | Values | Default |
|---|---|---|
equipmentModelID | String | none |
範例
equipmentModelID: elitemobs:equipment/helmet_texture
這設定一個在物品被穿戴時出現的特定材質,與物品在背包中的外觀分開。
scriptedItem
將物品連結到一個 FreeMinecraftModels 腳本化物品。設定後,物品會獲得 FMM 的 3D 模型與 Lua 腳本行為,同時保留 EliteMobs 所有的名稱、物品說明、附魔、等級與靈魂綁定系統。
這需要在伺服器上安裝 FreeMinecraftModels。如果未安裝 FMM,此設定會被靜默忽略,物品會在沒有模型或腳本的情況下正常運作。
該數值是 FMM 物品 ID——也就是該模型在 FMM 模型資料夾中的 YML 設定檔的檔名,不含 .yml 副檔名。例如,如果 FMM 在 plugins/FreeMinecraftModels/models/flame_blade.yml 有一個模型設定,其中包含 material: IRON_SWORD 與 scripts: [flame_blade.lua],你就會將它引用為 flame_blade。
當設定了 scriptedItem 時,它的優先度高於 customModelV2 與 equipmentModelID——EliteMobs 會跳過它自己的模型系統,改用 FMM 的模型。
| Key | Values | Default |
|---|---|---|
scriptedItem | String(FMM 物品 ID) | none |
範例
material: IRON_SWORD
name: "&cFlame Blade"
lore:
- "&7Burns with eternal fire"
enchantments:
- "FIRE_ASPECT,2"
- "DAMAGE_ALL,5"
scalability: scalable
scriptedItem: flame_blade
在此範例中:
- EliteMobs 控制物品的名稱、物品說明、附魔、等級縮放與靈魂綁定行為
- FMM 提供 3D 物品模型並執行
flame_blade.lua腳本(例如裝備時的粒子效果、自訂攻擊行為) material: IRON_SWORD被 EliteMobs 用作基底物品類型
showSource
設定物品是否在物品說明中顯示其來源或出處資訊。
| Key | Values | Default |
|---|---|---|
showSource | Boolean | true |
範例
showSource: false
設為 false 時,物品將不會顯示它是從哪裡取得的。
permission
設定取得該物品所需的權限。
| Key | Values | Default |
|---|---|---|
permission | String | none |
你會需要一個權限管理外掛來給予玩家權限。這只有在你沒有停用靈魂綁定附魔的情況下才能正確運作。
範例
permission: "elitemobs.cool.permission"
採用此設定後,只有擁有 elitemobs.cool.permission 權限的玩家才能取得此物品。
soulbound
設定物品在掉落時是否應為靈魂綁定。
| Key | Values | Default |
|---|---|---|
soulbound | Boolean | true |
範例
soulbound: true