View source for NPC Placement and Alignment/pt

'''Posicionamento e índole de NPCs''' trata dos arquivos que decidem onde ficam os NPCs mestres e treinadores e como a índole de um jogador muda a forma como cada NPC o trata. Isso é feito por dois arquivos JSON relacionados de cada mundo, ambos em <code><world save>/dragonminez/npcs/</code>, além de um formato de datapack para os NPCs que vivem dentro de estruturas.

{| class="wikitable"
! Arquivo !! O que controla
|-
| <code>placements.json</code> || Onde os NPCs mestres e treinadores aparecem (posição, dimensão, índole ou relação inicial).
|-
| <code>alignment_rules.json</code> || Como a índole do '''jogador''' afeta a hostilidade, a simpatia e a disponibilidade para interação de cada NPC.
|}

Os dois arquivos são carregados quando o servidor inicia e recarregados com <code>/dmzreload config</code> (ou <code>/dmzreload all</code>); veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]. Uma recarga também reaplica os posicionamentos em todas as dimensões carregadas.

{{Note|type=warning|title=Mundos antigos mantêm seus arquivos antigos|text=Os dois arquivos só são criados com os valores padrão do DragonMineZ quando '''não existem'''. Um mundo criado com uma versão anterior do DragonMineZ mantém seus arquivos antigos, então não recebe as novas entradas padrão (por exemplo, os NPCs do Outro Mundo da v2.2 e suas novas coordenadas). Para obter os padrões atuais, apague o arquivo (faça backup antes se você o editou) e execute <code>/dmzreload config</code>.}}

<span id="NPC_placement"></span>
== Posicionamento de NPCs ==
<code>placements.json</code> lista todos os NPCs que o DragonMineZ coloca e onde.

Código-fonte: <code>src/main/java/com/dragonminez/server/world/npc/NPCPlacementManager.java</code>.

<syntaxhighlight lang="json">
{
  "schema": 1,
  "placements": [
    {
      "id": "master_roshi",
      "entity": "dragonminez:master_roshi",
      "dimension": "minecraft:overworld",
      "structure": "roshi_house",
      "x": 0.0,
      "y": 0.0,
      "z": 0.0,
      "yaw": 225.0,
      "pitch": 0.0,
      "surface": true,
      "relative_to_spawn": false,
      "enabled": true,
      "override": false
    }
  ]
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>id</code> || Texto || Id único do posicionamento. Ele é marcado na entidade gerada para que o DragonMineZ possa encontrá-la e atualizá-la depois. Se dois posicionamentos têm o mesmo id, vale o último do arquivo (um aviso é registrado no log).
|-
| <code>entity</code> || Texto || Id de registro do tipo de entidade.
|-
| <code>dimension</code> || Texto || Padrão: <code>minecraft:overworld</code>.
|-
| <code>npc_id</code> || Texto || Só tem efeito para entidades <code>dragonminez:quest_npc</code>: liga ao id de NPC do sistema de missões.
|-
| <code>model</code> / <code>texture</code> || Texto || Usado apenas para entidades <code>quest_npc</code>.
|-
| <code>structure</code> || Texto || Se definido, <code>x</code>, <code>y</code> e <code>z</code> passam a ser um '''deslocamento''' a partir da origem dessa estrutura, em vez de coordenadas do mundo. Valores válidos: <code>roshi_house</code>, <code>goku_house</code>, <code>elder_guru</code>, <code>timechamber</code>, <code>kamilookout</code>, <code>gero_lab</code>. Um valor não reconhecido faz <code>x</code>, <code>y</code> e <code>z</code> serem tratados como coordenadas brutas do mundo (com um aviso no log).
|-
| <code>x</code>, <code>y</code>, <code>z</code> || Número || Coordenadas do mundo, ou o deslocamento a partir da estrutura (veja acima). Padrões: <code>0.5</code>, <code>64.0</code>, <code>0.5</code>.
|-
| <code>yaw</code>, <code>pitch</code> || Número || Direção para onde olha, em graus.
|-
| <code>surface</code> || Booleano || Se for <code>true</code>, ajusta o Y à superfície do terreno ao carregar, em vez de usar o Y informado.
|-
| <code>relative_to_spawn</code> || Booleano || Se for <code>true</code>, soma o ponto de spawn do mundo a <code>x</code> e <code>z</code> (aplicado depois de qualquer deslocamento de estrutura).
|-
| <code>enabled</code> || Booleano || Se for <code>false</code>, este posicionamento é totalmente ignorado.
|-
| <code>override</code> || Booleano || Se for <code>true</code>, a entidade é sempre gerada de novo, mesmo que já exista uma para este <code>id</code>. Caso contrário, a entidade existente é só atualizada no lugar.
|-
| <code>alignment</code> || Inteiro (0–100) || Índole opcional para este NPC específico: acima de 60 ele é amigável, de 41 a 60 neutro e com 40 ou menos hostil (a menos que uma regra de índole o torne hostil antes, veja abaixo).
|-
| <code>relation</code> || Texto || Substituição opcional para esta instância (<code>HOSTILE</code>, <code>NEUTRAL</code> ou <code>FRIENDLY</code>), guardada na própria entidade em vez de ser consultada nas regras de índole.
|}

Chaves desconhecidas são indicadas no relatório de carregamento do JSON.

<span id="Default_placements"></span>
=== Posicionamentos padrão ===
O arquivo padrão gera ativamente estes NPCs:

{| class="wikitable"
! Id do posicionamento !! Entidade !! Onde
|-
| <code>master_roshi</code> || <code>dragonminez:master_roshi</code> || Casa do Kame
|-
| <code>master_goku</code> || <code>dragonminez:master_goku</code> || Casa do Goku
|-
| <code>master_karin</code>, <code>master_dende</code>, <code>master_popo</code> || <code>dragonminez:master_karin</code>, <code>master_dende</code>, <code>master_popo</code> || Mirante de Kami
|-
| <code>master_gero</code> || <code>dragonminez:master_gero</code> || Laboratório do Dr. Gero
|-
| <code>master_guru</code> || <code>dragonminez:master_guru</code> || Casa do Grande Ancião (Namekusei)
|-
| <code>master_kaiosama</code> || <code>dragonminez:master_kaiosama</code> || Outro Mundo, <code>54.5 299 1031.5</code>
|-
| <code>master_toribot</code> || <code>dragonminez:master_toribot</code> || Outro Mundo, <code>50.5 298 1030.5</code>
|-
| <code>master_enma</code> || <code>dragonminez:master_enma</code> || Outro Mundo, <code>0.5 150 17.5</code>
|-
| <code>master_baba</code> || <code>dragonminez:master_uranai</code> || Outro Mundo, <code>9.5 150 3.5</code>
|-
| <code>master_grandkai</code> || <code>dragonminez:master_grandkai</code> || Outro Mundo, <code>-30.5 150 12.5</code>
|-
| <code>npc_hell_ogre</code> || <code>dragonminez:quest_npc</code> (<code>npc_id</code> <code>hell_ogre</code>) || Outro Mundo, <code>9.5 150 16.5</code>
|-
| <code>master_otherworld_announcer</code> || <code>dragonminez:master_otherworld_announcer</code> || Arena do [[Special:MyLanguage/Otherworld Tournament|Torneio do Outro Mundo]], <code>-25.5 352 -1164.5</code> (só é colocado depois que a arena do torneio é construída)
|}

<span id="Quest_NPCs_and_master_NPCs"></span>
=== NPCs de missões e NPCs mestres ===
Os NPCs de missões (Bulma, Kuririn, Yamcha, Tenshinhan, Piccolo, Gohan, Vegeta, Trunks, Chi-Chi, Videl, Shin e o Ancião Namekuseijin) também aparecem no arquivo padrão, mas com <code>"enabled": false</code>: eles não são mais gerados durante o jogo por este sistema. Eles estão embutidos diretamente no NBT da estrutura, então ficam em pontos fixos colocados à mão, em vez de se amontoarem no spawn do mundo. As entradas deles aqui são apenas para referência. Os NPCs adicionados a uma estrutura depois que o NBT dela foi feito vêm dos [[Special:MyLanguage/NPC Placement and Alignment#Structure NPCs|arquivos de NPCs de estruturas]] (a Chi-Chi na Casa do Goku é um deles).

Os NPCs do Outro Mundo (<code>master_kaiosama</code>, <code>master_enma</code>, <code>master_baba</code>, <code>master_toribot</code>, <code>master_grandkai</code>, <code>master_otherworld_announcer</code> e <code>npc_hell_ogre</code>) sempre forçam <code>override: true</code> internamente, independentemente do que diz o arquivo, já que precisam existir de forma confiável em uma dimensão gerada. Veja [[Special:MyLanguage/Otherworld|Outro Mundo]].

<span id="Structure_NPCs"></span>
== NPCs de estruturas ==
Os arquivos de NPCs de estruturas colocam NPCs '''dentro''' de uma estrutura do DragonMineZ sem editar o arquivo <code>.nbt</code> dela. Diferente dos arquivos acima, estes são arquivos de '''datapack''': <code>data/<namespace>/structure_npcs/*.json</code>, um por estrutura, carregados com os datapacks (e pelo <code>/reload</code>).

<syntaxhighlight lang="json">
{
  "structure": "dragonminez:goku_house",
  "npcs": [
    {
      "id": "npc_chi_chi",
      "entity": "dragonminez:quest_npc",
      "npc_id": "chi_chi",
      "model": "saga_videl",
      "texture": "saga_chichi",
      "pos": [67.5, 5.0, 50.5],
      "yaw": 90.0
    }
  ]
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Obrigatório !! O que faz
|-
| <code>structure</code> || Sim || Id da estrutura à qual os NPCs pertencem.
|-
| <code>id</code> || Sim || Id único deste NPC dentro da estrutura. Ele também é a chave de rastreamento, então não o renomeie depois que mundos já o usarem.
|-
| <code>entity</code> || Sim || Tipo de entidade a ser gerada (por exemplo, <code>dragonminez:quest_npc</code> ou o id de entidade de um mestre).
|-
| <code>npc_id</code> || Não || Id do NPC de missões, para <code>dragonminez:quest_npc</code>.
|-
| <code>model</code>, <code>texture</code> || Não || Nomes de modelo e textura para os NPCs de missões.
|-
| <code>template</code> || Não || O template da estrutura ao qual a posição é relativa, para estruturas formadas por várias peças.
|-
| <code>pos</code> || Sim || Posição '''relativa ao template da estrutura''', então ela fica certa qualquer que seja a rotação com que a estrutura foi gerada.
|-
| <code>yaw</code> || Não || Orientação, também relativa ao template (padrão <code>0</code>).
|-
| <code>alignment</code>, <code>relation</code> || Não || Índole e relação iniciais, como em <code>placements.json</code>.
|}

Cada NPC aparece '''uma vez''' por estrutura gerada quando o chunk dela carrega, incluindo estruturas geradas antes de o arquivo existir, e o spawn fica registrado: um NPC que morre não volta.

Para obter as coordenadas, fique onde o NPC deve estar e execute <code>/dmzstructure here</code>: ele mostra a estrutura, o template dela e sua posição e yaw relativos ao template, com um botão '''Copy NPC JSON''' que copia uma entrada pronta. <code>/dmzstructure npcs</code> lista os NPCs da estrutura em que você está e se cada um já apareceu. Os dois comandos exigem a permissão <code>dragonminez.dmzstructure</code> (veja [[Special:MyLanguage/Permissions|Permissões]]).

<span id="NPC_alignment_rules"></span>
== Regras de índole de NPCs ==
{{See also|Alignment|Masters}}
<code>alignment_rules.json</code> decide como cada NPC reage à índole do jogador.

Código-fonte: <code>src/main/java/com/dragonminez/common/alignment/NpcAlignmentRules.java</code>.

<syntaxhighlight lang="json">
{
  "npcs": {
    "goku": {
      "default_relation": "FRIENDLY",
      "interaction": { "min_alignment": 61 },
      "hostile_below": 25
    },
    "gero": {
      "default_relation": "NEUTRAL",
      "interaction": { "max_alignment": 60 }
    }
  }
}
</syntaxhighlight>

As chaves em <code>npcs</code> são ids de NPC '''sem nenhum namespace''' (<code>dragonminez:roshi</code> vira a chave <code>roshi</code>).

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>default_relation</code> || <code>HOSTILE</code> / <code>NEUTRAL</code> / <code>FRIENDLY</code> || Relação base quando nenhum dos limites abaixo a substitui. Padrão: <code>NEUTRAL</code>.
|-
| <code>hostile_below</code> || Inteiro || Se a índole do jogador estiver abaixo deste valor, o NPC fica hostil independentemente de <code>default_relation</code>.
|-
| <code>hostile_above</code> || Inteiro || O mesmo, mas para uma índole acima deste valor.
|-
| <code>interaction.min_alignment</code> || Inteiro || Abaixo desta índole o NPC continua falando com o jogador, mas o cumprimenta com frieza, e as missões secundárias dele aparecem bloqueadas (missões de saga, missões com a própria condição de índole e missões já em andamento continuam disponíveis). Também pode ser escrito direto na regra, sem o invólucro <code>interaction</code>.
|-
| <code>interaction.max_alignment</code> || Inteiro || O mesmo, mas como limite superior.
|}

Os quatro campos de limite são opcionais: omita os que não se aplicam. Usando a entrada <code>goku</code> acima como exemplo: com índole abaixo de 25, o Goku é hostil; de 25 a 60 ele continua falando com você, mas com frieza, e as missões secundárias dele continuam bloqueadas (a índole está abaixo do <code>min_alignment</code> de 61); com 61 ou mais ele é amigável e tudo fica disponível.

<code>NpcDispositionService.getRelation()</code> verifica a relação nesta ordem:
# Uma <code>relation</code> definida no posicionamento (<code>placements.json</code>) tem prioridade.
# Os limites <code>hostile_below</code> e <code>hostile_above</code> da regra.
# Um <code>alignment</code> definido no posicionamento.
# O <code>default_relation</code> da regra.

<span id="Master_NPCs"></span>
=== NPCs mestres ===
Para os '''NPCs mestres e treinadores''', o arquivo de regras decide a hostilidade, mas o filtro de índole deles é uma regra fixa em vez de <code>interaction</code>: sempre dá para falar com os mestres, mas [[Special:MyLanguage/Goku|Goku]], [[Special:MyLanguage/Gohan|Gohan]], [[Special:MyLanguage/King Kai|Rei Kai]], [[Special:MyLanguage/Old Kai|Velho Kaioshin]], [[Special:MyLanguage/Master Roshi|Mestre Kame]] e [[Special:MyLanguage/Krillin|Kuririn]] só liberam '''Habilidades''', '''Treinar''' e as missões novas com uma índole de pelo menos '''61''', e [[Special:MyLanguage/Cell|Cell]] e [[Special:MyLanguage/Frieza|Freeza]] com '''40 ou menos'''. Nenhum outro mestre tem filtro de índole. Veja [[Special:MyLanguage/Masters|Mestres]].

<span id="NPC_ids_covered_by_default"></span>
=== Ids de NPC incluídos por padrão ===
O arquivo padrão inclui <code>goku</code>, <code>roshi</code>, <code>karin</code>, <code>guru</code>, <code>dende</code>, <code>popo</code>, <code>kingkai</code>, <code>gero</code>, <code>enma</code>, <code>baba</code>, <code>toribot</code>, <code>grandkai</code>, <code>otherworld_announcer</code>, <code>bulma</code>, <code>krillin</code>, <code>yamcha</code>, <code>tien</code>, <code>chiaotzu</code>, <code>gohan</code>, <code>trunks</code>, <code>chi_chi</code>, <code>videl</code>, <code>namek_elder</code>, <code>shin</code>, <code>piccolo</code> e <code>vegeta</code>.
* A maioria usa por padrão <code>FRIENDLY</code> com <code>min_alignment: 41</code> (ou <code>61</code> para Goku, Guru, Dende, Rei Kai e o Ancião Namekuseijin) e <code>hostile_below: 25</code>.
* <code>gero</code> usa por padrão <code>NEUTRAL</code> com <code>max_alignment: 60</code>.
* <code>enma</code>, <code>baba</code>, <code>toribot</code>, <code>grandkai</code>, <code>otherworld_announcer</code> e <code>vegeta</code> usam por padrão <code>NEUTRAL</code> sem limites.
* <code>piccolo</code> usa por padrão <code>NEUTRAL</code> com limites próprios (<code>min_alignment: 41</code>, <code>hostile_below: 20</code>).

<span id="Reload_and_validate"></span>
== Recarregar e validar ==
# Edite os arquivos em <code><world save>/dragonminez/npcs/</code>.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute <code>/dmzreload config</code> (ou <code>/dmzreload all</code>); veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].
# Confira se o NPC apareceu ou se moveu como esperado, e se a hostilidade e a interação conforme a índole se comportam como configurado (teste com alguns valores de índole, se puder).

{{Navbox Modding}}