建立 NPC

設定

isEnabled

設定 NPC 是否啟用。

Key	Values	Default
`isEnabled`	Boolean	`true`

範例

isEnabled: true

name

設定 NPC 的顯示名稱。支援 Color Codes 與多語言伺服器的翻譯鍵。

Key	Values	Default
`name`	String	none

範例

name: "&aEnn Peecee"

scale

設定 NPC 的尺度(大小)。

Key	Values	Default
`scale`	Multiplier	`1.0`

縮放時,1.0 代表預設大小。若要讓實體變大,請增加數值(例如 1.2)。若要讓實體變小,請減少數值(例如 0.8)。

範例

scale: 1.2

role

設定 NPC 的角色定位,顯示在名稱下方。僅供視覺呈現。支援 Color Codes 與多語言伺服器的翻譯鍵。

Key	Values	Default
`role`	String	none

範例

role: "&c<Red Fellow>"

profession

設定 NPC 的職業,它會在未使用偽裝時設定其外觀。

Key	Values	Default
`profession`	Profession	`NITWIT`

範例

profession: NITWIT

greetings

設定 NPC 在玩家靠近時所說的問候語列表。支援多語言伺服器的翻譯鍵。

Key	Values	Default
`greetings`	String List	none

範例

greetings:
- Hi there!
- Good day. 

dialog

設定 NPC 在玩家附近時會說的對話(若為 DIALOG 互動類型,這就是對話)。支援多語言伺服器的翻譯鍵。

Key	Values	Default
`dialog`	String List	none

範例

dialog:
- I like apples!
- Sure is hot.

farewell

設定 NPC 的告別訊息。支援多語言伺服器的翻譯鍵。

Key	Values	Default
`farewell`	String List	none

範例

farewell: 
- Until next time!
- Bye!

canTalk

設定 NPC 是否能說話。

Key	Values	Default
`canTalk`	Boolean	`true`

範例

canTalk: true

activationRadius

設定 NPC 能偵測到玩家靠近的半徑。

Key	Values	Default
`activationRadius`	Double	`3.0`

範例

activationRadius: 3.0

scripts

設定附加到此 NPC 的 Lua 腳本。腳本檔案從 plugins/EliteMobs/npc_scripts/ 載入,且檔名必須完全相符,包括 .lua 副檔名。

Key	Values	Default
`scripts`	String List	none

NPC 腳本可以對生命週期、互動與鄰近掛鉤(例如 on_npc_proximity_enter)作出反應。完整的 API 與範例請參閱 Lua NPC 腳本。

範例

scripts:
- wave.lua

interactionType

設定 NPC 將執行的互動類型。

Key	Values	Default
`interactionType`	特殊 [1]	none

範例

interactionType: TELEPORT_BACK

noPreviousLocationMessage

當傳送員 NPC 沒有可傳送玩家過去的先前位置時,它會顯示此訊息。接受 Color Codes 與多語言伺服器的翻譯鍵。

Key	Values	Default
`noPreviousLocationMessage`	String	none

範例

noPreviousLocationMessage: '&8[EliteMobs] &cCouldn''t send you back to your previous location - no previous location found!'

timeout

設定 NPC 永久消失前的時間量(以分鐘計)。

Key	Values	Default
`timeout`	Double	`0`(永不)

範例

timeout: 0

questFileName

設定 NPC 發放的任務。

Key	Values	Default
`questFileName`	String List	none

範例

questFileName:
- my_quest_one.yml
- my_quest_two.yml

disguise

設定 NPC 擁有的 LibsDisguises 偽裝。

Key	Values	Default
`disguise`	LibsDisguises 格式	none

範例

disguise: SKELETON

customDisguiseData

設定自訂 LibsDisguises 偽裝的資料。

Key	Values	Default
`customDisguiseData`	LibsDisguises 格式	none

範例

disguise: custom:my_cool_disguise_name
customDisguiseData: player my_cool_disguise_name setskin {"id":"364acb6d-9050-46f7-b5fb-f8c3fd83a6fc","name":"Unknown","properties":[{"name":"textures","value":"ewogICJ0aW1lc3RhbXAiIDogMTYxMTk4ODA4Nzc1NSwKICAicHJvZmlsZUlkIiA6ICJkZGVkNTZlMWVmOGI0MGZlOGFkMTYyOTIwZjdhZWNkYSIsCiAgInByb2ZpbGVOYW1lIiA6ICJEaXNjb3JkQXBwIiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzliYmVkODQzNWY4YmYyNzhhZmUyNmU2NGZkOTI2YjhiMzc3MzJkODhlMzM0ODk3ZGJkNTI3ZDU2ZmY5MTk5MGUiCiAgICB9CiAgfQp9","signature":"ujLq1joYVktuQAp1xpFKlxQFUVinSePiDBiVCAxxix/mA5vP86i/eAOfb1mtGjaAZ6sO0l2olbzvycnGXNBtbAxgqprguROXY4tpWiePVTDmy3iD4GdOCxHAkYLoyMV5qTT4SNsldUFFuND8GSEgbNMltKDLmhNKwzm08iCigPfpeuYpwljgJPxu6ka54PKNaQu4doI0ZDZXKqq4hPhR3Bs2Sz9MI0SmdmQWwcCzUz3DFdVno27fmQ6LwqmT+eSoOv0EttVG/XMaTYQ5lhBY61mqf6WlJyYVUSfjJk1AbYsctu7dWM+sbY8jFq5ljvXJGGr5TyKi+fs8vHy06Z2go20QgTYOw+caFxFijAS6fgm3oY57VEO/+/9OLHdD+Z9BrWqQWcIIrVeIfxjue/yt4pyeVv9jX59hjNFjhcPEwotkxJ+vZ96WlTLWDG4BiqauDr2VeGyLlVaygO9ZU0wwsN65iSh91GI3tMIA5wbDR0Hts/9ABvt9eafHbowS+4SZXN0i9mYnKg7op1eiB8nMEAGsPJg3DwsmUrh3ACAapQ6eYHiJpo59RXDqKlRcXwo7wsEFp//5LgQWbPj0NP3nxnywdpozqSAeq6236qlhE9BT9eiyJ41V9sMelYFEWMlUAltR40NdbIrHB0J3nmfuLJz44/sTwWf6P1khOy//XX0="}],"legacy":false}

customModel

設定 NPC 將使用的 ModelEngine 自訂模型。

Key	Values	Default
`customModel`	String	none

範例

customModel: MY_MODEL_ONE

arena

設定 NPC 將為其開啟選單的競技場檔名(需要 ARENA_MASTER 互動類型)。

Key	Values	Default
`arena`	Filename	none

範例

arena: my_arena.yml

command

設定 NPC 將執行的指令(需要 COMMAND 互動類型)。指令以玩家身分執行,而非控制台。請勿包含開頭的斜線(/)。

Key	Values	Default
`command`	String	none

範例

command: say Look at me running a command, how cool!

spawnLocation

設定 NPC 的生成位置。你應透過 /em place npc <npcfilename.yml> 指令來設定這個。

Key	Values	Default
`spawnLocation`	String	none

範例

spawnLocation: my_world,10,50,10,0,0

spawnLocations

設定 NPC 的生成位置。你應透過 /em place npc <npcfilename.yml> 指令來設定這個。

Key	Values	Default
`spawnLocations`	String List	none

範例

spawnLocations: 
- my_world,10,50,10,0,0
- my_world,-10,50,-10,0,0

instanced

設定 NPC 是否應被實例化(供實例副本使用)。設為 true 時,NPC 會自動為每個副本實例複製一份,每個副本各自存在於對應的實例世界中。

Key	Values	Default
`instanced`	Boolean	`false`

範例

instanced: false

syncMovement

設定 NPC 是否應同步其移動。用於控制 NPC 的位置更新是否同步。

Key	Values	Default
`syncMovement`	Boolean	`true`

範例

syncMovement: true

NPC 設定範例

isEnabled: true
name: "&cRed Rubin"
role: "&a<Generic NPC>"
profession: NITWIT
greetings:
- Hiya!
- Hello!
dialog:
- Great conversation!
- Pleasure talking with you!
farewell:
- Goodbye!
- Laters!
canTalk: true
activationRadius: 4
interactionType: CHAT
timeout: 0
questFileName: 
- my_quest.yml #npc interactionType must be set to CUSTOM_QUEST_GIVER
disguise: SKELETON
customDisguiseData: #used when a custom libsdisguise is being set
customModel: MODEL_ONE
arena: my_arena.yml #npc interactionType must be set to ARENA_MASTER
command: say Hello World! #npc interactionType must be set to COMMAND (do not include the leading slash)
spawnLocation: my_world,584,55,127,90,10 #remember that NPCs use pitch and yaw to set where they are looking at. this is also automatically set when running the /em place npc <npcfilename.yml> command, so make sure you pose where you want the NPC to be facing when running the command.

特殊 [1]

以下是有效的 NPC 互動類型列表:

Type	Description
`GUILD_GREETER`	開啟武器技能加成選擇選單
`CHAT`	右鍵點擊會循環切換 `dialog`
`CUSTOM_SHOP`	開啟自訂商店選單
`PROCEDURALLY_GENERATED_SHOP`	開啟程序化產生的商店
`BAR`	尚未實作。告知玩家該功能即將推出。
`ARENA`	無作用。請改用 `ARENA_MASTER`。
`QUEST_GIVER`	開啟程序化產生的任務選單
`CUSTOM_QUEST_GIVER`	開啟在 `questFileName` 中所設定特定任務的任務選單
`NONE`	無互動
`SELL`	開啟販售選單
`TELEPORT_BACK`	將玩家傳送回他們所在過的最後一個非 elitemobs 世界位置
`SCRAPPER`	開啟拆解選單
`REPAIRMAN`	開啟修理選單
`ENCHANTER`	開啟附魔選單
`REFINER`	已取代 - 告知玩家該功能已被取代;管理員被告知要移除該 NPC
`SMELTER`	已取代 - 告知玩家該功能已被取代;管理員被告知要移除該 NPC
`ENHANCER`	已取代 - 告知玩家該功能已被取代;管理員被告知要移除該 NPC
`UNBINDER`	開啟解綁選單
`ARENA_MASTER`	開啟在 `arena` 中所設定競技場的競技場選單
`COMMAND`	執行在 `command` 中所設定的指令
`SCROLL_APPLIER`	將精英物品卷軸施用於物品
`ARROW_SHOP`	開啟箭矢商店選單
`GAMBLING_BLACKJACK`	開啟二十一點賭博遊戲
`GAMBLING_COINFLIP`	開啟擲幣賭博遊戲
`GAMBLING_SLOTS`	開啟吃角子老虎賭博遊戲
`GAMBLING_HIGHERLOWER`	開啟猜大小賭博遊戲

有關 SCRAPPER 及類似互動類型作用的更多資訊,請點擊這裡。

NPC 行為注意事項

NPC 有數種無法設定的硬編碼行為:

AI 已停用:NPC 無法自主移動。它們會停留在它們的生成位置。
角色定位顯示:角色定位文字顯示在 NPC 上方固定高度的隱形盔甲座上。
對話冷卻:NPC 在說話事件之間會等待 3 秒,以防止訊息重疊。
區塊生命週期:NPC 在其區塊卸載時消失,並在區塊重新載入時重新生成。

設定​

isEnabled​

name​

scale​

role​

profession​

greetings​

dialog​

farewell​

canTalk​

activationRadius​

scripts​

interactionType​

noPreviousLocationMessage​

timeout​

questFileName​

disguise​

customDisguiseData​

customModel​

arena​

command​

spawnLocation​

spawnLocations​

instanced​

syncMovement​

特殊 [1]​

NPC 行為注意事項​

設定