Criando 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 multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
name | String | none |
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 (ex: 1.2). Para tornar a entidade menor, diminua o valor (ex: 0.8).
Exemplo
scale: 1.2
role
Define a função do NPC, abaixo do nome. Apenas visual. Suporta Códigos de Cor e chaves de tradução para servidores multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
role | String | none |
Exemplo
role: "&c<Red Fellow>"
profession
Define a profissão do NPC, que define sua aparência 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 multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
greetings | String List | none |
Exemplo
greetings:
- Hi there!
- Good day.
dialog
Define o diálogo que o NPC dirá enquanto um jogador estiver por perto (No caso do DIALOG interactionType, este seria o diálogo). Suporta chaves de tradução para servidores multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
dialog | String List | none |
Exemplo
dialog:
- I like apples!
- Sure is hot.
farewell
Define a mensagem de despedida do NPC. Suporta chaves de tradução para servidores multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
farewell | String List | none |
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 um jogador se aproximando.
| Chave | Valores | Padrão |
|---|---|---|
activationRadius | Double | 3.0 |
Exemplo
activationRadius: 3.0
interactionType
Define o tipo de interação que o NPC fará.
| Chave | Valores | Padrão |
|---|---|---|
interactionType | Special [1] | none |
Exemplo
interactionType: TELEPORT_BACK
noPreviousLocationMessage
Quando um NPC Teleportador não tem uma localização anterior para a qual possa teletransportar um jogador, ele exibirá esta mensagem. Aceita Códigos de Cor e chaves de tradução para servidores multi-idioma.
| Chave | Valores | Padrão |
|---|---|---|
noPreviousLocationMessage | String | none |
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 | Integer | 0 (nunca) |
Exemplo
timeout: 0
questFileName
Define as missões que o NPC oferece.
| Chave | Valores | Padrão |
|---|---|---|
questFileName | String List | none |
Exemplo
questFileName:
- my_quest_one.yml
- my_quest_two.yml
disguise
Define o disfarce LibsDisguises que o NPC possui.
| Chave | Valores | Padrão |
|---|---|---|
disguise | LibsDisguises format | none |
Exemplo
disguise: SKELETON
customDisguiseData
Define os dados para um disfarce LibsDisguises personalizado.
| Chave | Valores | Padrão |
|---|---|---|
customDisguiseData | LibsDisguises format | none |
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 personalizado ModelEngine que o NPC usará.
| Chave | Valores | Padrão |
|---|---|---|
customModel | String | none |
Exemplo
customModel: MY_MODEL_ONE
arena
Define o nome do arquivo da arena para a qual o NPC abrirá um menu (requer o ARENA_MASTER interactionType).
| Chave | Valores | Padrão |
|---|---|---|
arena | Filename | none |
Exemplo
arena: my_arena.yml
command
Define o comando que o NPC executará (requer COMMAND interactionType). Os comandos são executados como comandos de console, não como o jogador. Não inclua a barra inicial (/).
| Chave | Valores | Padrão |
|---|---|---|
command | String | none |
Exemplo
command: say Look at me running a command, how cool!
spawnLocation
Define a localização de spawn dos NPCs. Você deve configurar isso através do comando /em spawnnpc <npcfilename.yml>.
| Chave | Valores | Padrão |
|---|---|---|
spawnLocation | String | none |
Exemplo
spawnLocation: my_world,10,50,10,0,0
spawnLocations
Define as localizações de spawn dos NPCs. Você deve configurar isso através do comando /em spawnnpc <npcfilename.yml>.
| Chave | Valores | Padrão |
|---|---|---|
spawnLocations | String List | none |
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
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
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.
Special [1]
A seguir está a lista de tipos de interação de NPC válidos:
| Tipo | Descrição |
|---|---|
GUILD_GREETER | Abre o menu da guilda de aventureiros |
CHAT | Clicar com o botão direito percorre o dialog |
CUSTOM_SHOP | Abre o menu de loja personalizada |
PROCEDURALLY_GENERATED_SHOP | Abre a loja gerada proceduralmente |
BAR | Abre o menu do bar |
ARENA | Abre o menu da arena |
QUEST_GIVER | Abre o menu de missões geradas proceduralmente |
CUSTOM_QUEST_GIVER | Abre o menu de missão para uma missão específica definida em questFileName |
NONE | Sem interações |
SELL | Abre o menu de venda |
TELEPORT_BACK | Teletransporta jogadores de volta para a última localização de mundo não-elitemobs em que estavam |
SCRAPPER | Abre o menu de sucata |
REPAIRMAN | Abre o menu de reparo |
ENCHANTER | Abre o menu de encantamento |
REFINER | DESCONTINUADO - Recurso removido, não use |
UNBINDER | Abre o menu de desvincular |
ARENA_MASTER | Abre o menu de arena para a arena definida em arenaFilename |
COMMAND | Executa o comando definido em command |
SCROLL_APPLIER | Aplica pergaminhos de itens elite aos itens |
Para mais informações sobre o que os tipos de interação SCRAPPER e similares fazem, clique aqui.
Notas sobre Comportamento de NPCs
Os NPCs têm vários comportamentos codificados que não podem ser configurados:
- IA Desabilitada: Os NPCs não podem se mover autonomamente. Eles permanecem na localização de spawn.
- Exibição de Função: O texto da função é exibido em um suporte de armadura invisível acima do NPC em uma altura fixa.
- Tempo de Recarga 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 é recarregado.