跳到主要内容

创建 NPC

webapp_banner.jpg

配置设置​

isEnabled​

设置 NPC 是否启用。

键值默认值
isEnabledBooleantrue
示例
isEnabled: true

name​

设置 NPC 的显示名称。支持颜色代码和多语言服务器的翻译键。

键值默认值
nameStringnone
示例
name: "&aEnn Peecee"

create_npc_name.jpg

scale​

设置 NPC 的缩放比例(大小)。

键值默认值
scaleMultiplier1.0

缩放时,1.0 代表默认大小。要使实体变大,请增加数值(例如 1.2)。要使实体变小,请减少数值(例如 0.8)。

示例
scale: 1.2

role​

设置 NPC 的角色,显示在名称下方。仅用于视觉效果。支持颜色代码和多语言服务器的翻译键。

键值默认值
roleStringnone
示例
role: "&c<Red Fellow>"

create_npc_role.jpg

profession​

设置 NPC 的职业,当未使用伪装时,这会设置其皮肤。

键值默认值
professionProfessionNITWIT
示例
profession: NITWIT

create_npc_profession.jpg

greetings​

设置当玩家接近时 NPC 所说的问候语列表。支持多语言服务器的翻译键。

键值默认值
greetingsString Listnone
示例
greetings:
- Hi there!
- Good day.

create_npc_greetings.jpg

dialog​

设置当玩家在附近时 NPC 会说的对话(如果是 DIALOG interactionType,这将是对话内容)。支持多语言服务器的翻译键。

键值默认值
dialogString Listnone
示例
dialog:
- I like apples!
- Sure is hot.

create_npc_dialog.jpg

farewell​

设置 NPC 的告别消息。支持多语言服务器的翻译键。

键值默认值
farewellString Listnone
示例
farewell:
- Until next time!
- Bye!

create_npc_farewell.jpg

canTalk​

设置 NPC 是否可以说话。

键值默认值
canTalkBooleantrue
示例
canTalk: true

activationRadius​

设置 NPC 可以检测到玩家接近的半径。

键值默认值
activationRadiusDouble3.0
示例
activationRadius: 3.0

interactionType​

设置 NPC 将执行的交互类型。

键值默认值
interactionTypeSpecial [1]none
示例
interactionType: TELEPORT_BACK

noPreviousLocationMessage​

当传送 NPC 没有可以传送玩家的先前位置时,它将显示此消息。接受颜色代码和多语言服务器的翻译键。

键值默认值
noPreviousLocationMessageStringnone
示例
noPreviousLocationMessage: '&8[EliteMobs] &cCouldn''t send you back to your previous location - no previous location found!'

create_npc_noteleportlocation.jpg

timeout​

设置 NPC 永久消失前的时间量,单位为分钟。

键值默认值
timeoutInteger0 (never)
示例
timeout: 0

questFileName​

设置 NPC 提供的任务。

键值默认值
questFileNameString Listnone
示例
questFileName:
- my_quest_one.yml
- my_quest_two.yml

disguise​

设置 NPC 拥有的 LibsDisguises 伪装。

键值默认值
disguiseLibsDisguises formatnone
示例
disguise: SKELETON

create_npc_disguise.jpg

customDisguiseData​

设置自定义 LibsDisguises 伪装的数据。

键值默认值
customDisguiseDataLibsDisguises formatnone
示例
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}

create_npc_custom_disguise.jpg

customModel​

设置 NPC 将使用的 ModelEngine 自定义模型。

键值默认值
customModelStringnone
示例
customModel: MY_MODEL_ONE

arena​

设置 NPC 将打开菜单的竞技场文件名(需要 ARENA_MASTER interactionType)。

键值默认值
arenaFilenamenone
示例
arena: my_arena.yml

command​

设置 NPC 将运行的命令(需要 COMMAND interactionType)。命令以控制台命令的形式执行,而不是以玩家身份执行。请勿包含前导斜杠 (/)。

键值默认值
commandStringnone
示例
command: say Look at me running a command, how cool!

create_npc_command.jpg

spawnLocation​

设置 NPC 的生成位置。您应该通过 /em spawnnpc <npcfilename.yml> 命令来设置此项。

键值默认值
spawnLocationStringnone
示例
spawnLocation: my_world,10,50,10,0,0

spawnLocations​

设置 NPC 的多个生成位置。您应该通过 /em spawnnpc <npcfilename.yml> 命令来设置此项。

键值默认值
spawnLocationsString Listnone
示例
spawnLocations:
- my_world,10,50,10,0,0
- my_world,-10,50,-10,0,0

instanced​

设置 NPC 是否应该是实例化的(用于实例化地下城)。当设置为 true 时,NPC 会自动为每个地下城实例克隆,每个克隆存在于相应的实例世界中。

键值默认值
instancedBooleanfalse
示例
instanced: false
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
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 spawnnpc <npcfilename.yml> command, so make sure you pose where you want the NPC to be facing when running the command.

create_npc_npc.jpg

Special [1]​

以下是有效的 NPC 交互类型列表:

类型描述
GUILD_GREETER打开冒险者公会菜单
CHAT右键单击循环显示 dialog
CUSTOM_SHOP打开自定义商店菜单
PROCEDURALLY_GENERATED_SHOP打开程序生成的商店
BAR打开酒吧菜单
ARENA打开竞技场菜单
QUEST_GIVER打开程序生成的任务菜单
CUSTOM_QUEST_GIVER打开在 questFileName 中设置的特定任务的任务菜单
NONE无交互
SELL打开出售菜单
TELEPORT_BACK将玩家传送回他们上次所在的非 elitemobs 世界位置
SCRAPPER打开拆解菜单
REPAIRMAN打开修理菜单
ENCHANTER打开附魔菜单
REFINER已弃用 - 功能已移除,请勿使用
UNBINDER打开解绑菜单
ARENA_MASTER打开在 arenaFilename 中设置的竞技场的竞技场菜单
COMMAND运行在 command 中设置的命令
SCROLL_APPLIER将精英物品卷轴应用于物品

有关 SCRAPPER 和类似交互类型的更多信息,请点击此处。

NPC 行为说明​

NPC 具有几种无法配置的硬编码行为:

  • AI 已禁用: NPC 无法自主移动。它们会停留在生成位置。
  • 角色显示: 角色文本显示在 NPC 上方固定高度的隐形盔甲架上。
  • 对话冷却: NPC 在语音事件之间等待 3 秒,以防止消息重叠。
  • 区块生命周期: NPC 在其区块卸载时消失,并在重新加载时重生。