Criar NPCs
Configurações
isEnabled
Define se um NPC está ativado.
| Chave | Valores | Padrão |
|---|---|---|
isEnabled | Boolean | true |
Exemplo
isEnabled: true
name
Define o nome de exibição de um NPC. Suporta Códigos de Cor e chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
name | String | nenhum |
Exemplo
name: "&aEnn Peecee"

scale
Define a escala (tamanho) do NPC.
| Chave | Valores | Padrão |
|---|---|---|
scale | Multiplier | 1.0 |
Ao escalar, 1.0 representa o tamanho padrão. Para tornar a entidade maior, aumente o valor (por exemplo, 1.2). Para tornar a entidade menor, diminua o valor (por exemplo, 0.8).
Exemplo
scale: 1.2
role
Define o cargo (role) do NPC, sob o nome. Apenas visual. Suporta Códigos de Cor e chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
role | String | nenhum |
Exemplo
role: "&c<Red Fellow>"

profession
Define a profissão do NPC, que define sua skin quando não está usando um disfarce.
| Chave | Valores | Padrão |
|---|---|---|
profession | Profession | NITWIT |
Exemplo
profession: NITWIT

greetings
Define a lista de saudações que o NPC diz quando um jogador se aproxima. Suporta chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
greetings | String List | nenhum |
Exemplo
greetings:
- Hi there!
- Good day.

dialog
Define o diálogo que o NPC dirá enquanto um jogador estiver por perto (no caso do interactionType DIALOG, este seria o diálogo). Suporta chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
dialog | String List | nenhum |
Exemplo
dialog:
- I like apples!
- Sure is hot.

farewell
Define a mensagem de despedida do NPC. Suporta chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
farewell | String List | nenhum |
Exemplo
farewell:
- Until next time!
- Bye!

canTalk
Define se o NPC pode falar.
| Chave | Valores | Padrão |
|---|---|---|
canTalk | Boolean | true |
Exemplo
canTalk: true
activationRadius
Define o raio no qual um NPC pode detectar a aproximação de um jogador.
| Chave | Valores | Padrão |
|---|---|---|
activationRadius | Double | 3.0 |
Exemplo
activationRadius: 3.0
scripts
Define os scripts Lua anexados a este NPC. Os arquivos de script são carregados de plugins/EliteMobs/npc_scripts/ e os nomes de arquivo devem corresponder exatamente, incluindo a extensão .lua.
| Chave | Valores | Padrão |
|---|---|---|
scripts | String List | nenhum |
Os scripts de NPC podem reagir a hooks de ciclo de vida, interação e proximidade, como on_npc_proximity_enter. Consulte Scripts Lua de NPC para a API completa e exemplos.
Exemplo
scripts:
- wave.lua
interactionType
Define o tipo de interação que o NPC fará.
| Chave | Valores | Padrão |
|---|---|---|
interactionType | Especial [1] | nenhum |
Exemplo
interactionType: TELEPORT_BACK
noPreviousLocationMessage
Quando um NPC Transportador não tem uma localização anterior para a qual possa teleportar um jogador, ele exibirá esta mensagem. Aceita Códigos de Cor e chaves de tradução para servidores multilíngues.
| Chave | Valores | Padrão |
|---|---|---|
noPreviousLocationMessage | String | nenhum |
Exemplo
noPreviousLocationMessage: '&8[EliteMobs] &cCouldn''t send you back to your previous location - no previous location found!'

timeout
Define a quantidade de tempo, em minutos, antes de um NPC desaparecer permanentemente.
| Chave | Valores | Padrão |
|---|---|---|
timeout | Double | 0 (nunca) |
Exemplo
timeout: 0
questFileName
Define as quests que o NPC oferece.
| Chave | Valores | Padrão |
|---|---|---|
questFileName | String List | nenhum |
Exemplo
questFileName:
- my_quest_one.yml
- my_quest_two.yml
disguise
Define o disfarce do LibsDisguises que o NPC tem.
| Chave | Valores | Padrão |
|---|---|---|
disguise | LibsDisguises format | nenhum |
Exemplo
disguise: SKELETON

customDisguiseData
Define os dados para um disfarce customizado do LibsDisguises.
| Chave | Valores | Padrão |
|---|---|---|
customDisguiseData | LibsDisguises format | nenhum |
Exemplo
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
Define o modelo customizado do ModelEngine que o NPC usará.
| Chave | Valores | Padrão |
|---|---|---|
customModel | String | nenhum |
Exemplo
customModel: MY_MODEL_ONE
arena
Define o nome do arquivo da arena para a qual o NPC abrirá um menu (requer o interactionType ARENA_MASTER).
| Chave | Valores | Padrão |
|---|---|---|
arena | Filename | nenhum |
Exemplo
arena: my_arena.yml
command
Define o comando que o NPC executará (requer o interactionType COMMAND). Os comandos são executados como o jogador, não como o console. Não inclua a barra inicial (/).
| Chave | Valores | Padrão |
|---|---|---|
command | String | nenhum |
Exemplo
command: say Look at me running a command, how cool!
![]()
spawnLocation
Define a localização de spawn dos NPCs. Você deve definir isto através do comando /em place npc <npcfilename.yml>.
| Chave | Valores | Padrão |
|---|---|---|
spawnLocation | String | nenhum |
Exemplo
spawnLocation: my_world,10,50,10,0,0
spawnLocations
Define as localizações de spawn dos NPCs. Você deve definir isto através do comando /em place npc <npcfilename.yml>.
| Chave | Valores | Padrão |
|---|---|---|
spawnLocations | String List | nenhum |
Exemplo
spawnLocations:
- my_world,10,50,10,0,0
- my_world,-10,50,-10,0,0
instanced
Define se o NPC deve ser instanciado (para uso em dungeons instanciadas). Quando definido como true, o NPC é automaticamente clonado para cada instância de dungeon, com cada clone existindo no mundo de instância correspondente.
| Chave | Valores | Padrão |
|---|---|---|
instanced | Boolean | false |
Exemplo
instanced: false
syncMovement
Define se o NPC deve ter seu movimento sincronizado. Usado para controlar se as atualizações de posição do NPC são sincronizadas.
| Chave | Valores | Padrão |
|---|---|---|
syncMovement | Boolean | true |
Exemplo
syncMovement: true
Exemplo de Configuração de 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.

Especial [1]
A seguir está a lista de tipos de interação de NPC válidos:
| Tipo | Descrição |
|---|---|
GUILD_GREETER | Abre o menu de seleção de bônus de habilidade de arma |
CHAT | Clicar com o botão direito alterna pelo dialog |
CUSTOM_SHOP | Abre o menu da loja customizada |
PROCEDURALLY_GENERATED_SHOP | Abre a loja gerada proceduralmente |
BAR | Não implementado. Informa ao jogador que o recurso virá em breve. |
ARENA | Não faz nada. Use ARENA_MASTER em vez disso. |
QUEST_GIVER | Abre o menu de quests geradas proceduralmente |
CUSTOM_QUEST_GIVER | Abre o menu de quest para uma quest específica definida em questFileName |
NONE | Sem interações |
SELL | Abre o menu de venda |
TELEPORT_BACK | Teleporta os jogadores de volta para a última localização em que estiveram em um mundo que não seja do elitemobs |
SCRAPPER | Abre o menu de sucata |
REPAIRMAN | Abre o menu de reparo |
ENCHANTER | Abre o menu de encantamento |
REFINER | SUBSTITUÍDO - Informa ao jogador que o recurso foi substituído; os administradores são instruídos a remover o NPC |
SMELTER | SUBSTITUÍDO - Informa ao jogador que o recurso foi substituído; os administradores são instruídos a remover o NPC |
ENHANCER | SUBSTITUÍDO - Informa ao jogador que o recurso foi substituído; os administradores são instruídos a remover o NPC |
UNBINDER | Abre o menu de desvinculação |
ARENA_MASTER | Abre o menu da arena para a arena definida em arena |
COMMAND | Executa o comando definido em command |
SCROLL_APPLIER | Aplica pergaminhos de item de elite aos itens |
ARROW_SHOP | Abre o menu da loja de flechas |
GAMBLING_BLACKJACK | Abre o jogo de apostas de blackjack |
GAMBLING_COINFLIP | Abre o jogo de apostas de cara ou coroa |
GAMBLING_SLOTS | Abre o jogo de apostas de caça-níquel |
GAMBLING_HIGHERLOWER | Abre o jogo de apostas de maior/menor |
Para mais informações sobre o que o SCRAPPER e tipos de interação semelhantes fazem, clique aqui.
Notas sobre o Comportamento dos NPCs
Os NPCs têm vários comportamentos codificados que não podem ser configurados:
- IA Desativada: Os NPCs não podem se mover de forma autônoma. Eles permanecem em sua localização de spawn.
- Exibição do Cargo: O texto do cargo (role) é exibido em um suporte de armadura (armor stand) invisível acima do NPC a uma altura fixa.
- Cooldown de Diálogo: Os NPCs esperam 3 segundos entre eventos de fala para evitar mensagens sobrepostas.
- Ciclo de Vida do Chunk: Os NPCs desaparecem quando seu chunk é descarregado e reaparecem quando ele é recarregado.
