Ver código fonte para NPC Dialogue/pt

Os '''diálogos de NPCs''' permitem dar aos NPCs mestres conversas ramificadas apenas com JSON, sem Java. Uma árvore de diálogo é um conjunto de '''nós''': cada nó é uma fala do NPC, mais as '''opções''' com que o jogador pode responder. As opções podem levar a outro nó, ficar ocultas atrás de '''condições''' e executar '''ações''' como mudar a índole, dar TP, executar um comando ou iniciar uma missão.

Os diálogos são dados de cada mundo, assim como as missões e os desejos.

<span id="Where_files_go"></span>
== Onde ficam os arquivos ==

<syntaxhighlight lang="text">
<world save>/dragonminez/dialogues/*.json
</syntaxhighlight>

A pasta é criada na primeira vez que o servidor inicia, junto com um <code>_example.json</code> que você pode copiar. Cada arquivo <code>.json</code> da pasta (sem subpastas) contém '''uma árvore para um NPC'''. Os arquivos são carregados em ordem alfabética; se dois arquivos apontam para o mesmo NPC, vale o último.

Os diálogos são carregados quando o servidor inicia e recarregados com <code>/dmzreload story</code> (ou <code>/dmzreload all</code>); veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].

Código-fonte: <code>src/main/java/com/dragonminez/common/dialogue/</code> (<code>DialogueRegistry</code>, <code>DialogueParser</code>, <code>DialogueService</code>, <code>DialogueAction</code>).

<span id="Which_NPCs_can_use_it"></span>
== Quais NPCs podem usá-los ==
As árvores de diálogo funcionam com os '''NPCs mestres''': os treinadores colocados por [[Special:MyLanguage/NPC Placement and Alignment|Posicionamento e índole de NPCs]], como o Mestre Kame ou o Goku. O campo <code>npc</code> é o id do mestre. Os mestres que o DragonMineZ coloca por padrão usam estes ids:
<code>roshi</code>, <code>goku</code>, <code>karin</code>, <code>dende</code>, <code>popo</code>, <code>gero</code>, <code>guru</code>, <code>kingkai</code> ([[Special:MyLanguage/King Kai|Rei Kai]]), <code>toribot</code>, <code>enma</code>, <code>baba</code>, <code>grandkai</code>, <code>otherworld_announcer</code>

<div class="mw-translate-fuzzy">
Quando um mestre tem uma árvore, clicar nele com o botão direito mostra a árvore '''em vez das''' opções habituais do mestre (Missões, Habilidades, Treinar e serviços; veja [[Special:MyLanguage/Masters|Mestres]]). A árvore usa a mesma janela de diálogo: a fala aparece no centro da faixa inferior e as opções são listadas à direita. Dê a uma das suas opções a ação <code>OPEN_QUESTS</code> para que os jogadores ainda consigam chegar às missões do mestre. O jogador precisa ter criado um personagem antes. O requisito de índole de um mestre não impede a conversa; ele só bloqueia Habilidades, Treinar e as missões novas (veja [[Special:MyLanguage/Masters|Mestres]]).
</div>

Os NPCs de missões padrão (<code>dragonminez:quest_npc</code>, por exemplo a Bulma) mantêm sua lista de missões e não usam árvores de diálogo.

<span id="File_format"></span>
== Formato do arquivo ==

<syntaxhighlight lang="json">
{
  "npc": "roshi",
  "start": "greet",
  "nodes": {
    "greet": {
      "line": "Well, if it isn't %player%! What brings you here?",
      "choices": [
        {
          "text": "I want to get stronger.",
          "goto": "training",
          "conditions": { "operator": "AND", "conditions": [ { "type": "LEVEL", "minLevel": 5 } ] }
        },
        {
          "text": "Give me your money!",
          "goto": "angry",
          "actions": [ { "type": "ALIGNMENT", "amount": -5 } ]
        },
        { "text": "Show me your quests.", "actions": [ { "type": "OPEN_QUESTS" } ] },
        { "text": "Goodbye." }
      ]
    },
    "training": {
      "line": "Ha! I like your spirit. Take these training points and come back later.",
      "choices": [
        { "text": "Thank you!", "actions": [ { "type": "TPS", "amount": 50 } ] }
      ]
    },
    "angry": {
      "line": "How dare you! Leave my sight at once!"
    }
  }
}
</syntaxhighlight>

<span id="Tree"></span>
=== Árvore ===

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>npc</code> || Texto || '''Obrigatório.''' O id do mestre ao qual a árvore pertence (sem diferenciar maiúsculas e minúsculas). Um id que começa com <code>_</code> deixa o arquivo inativo; é assim que o <code>_example.json</code> fica desligado.
|-
| <code>start</code> || Texto || Id do primeiro nó. Padrão: <code>"start"</code>.
|-
| <code>nodes</code> || Objeto || '''Obrigatório.''' Mapa de id de nó para nó.
|}

Uma árvore é ignorada (e o motivo é registrado no log) quando falta <code>npc</code> ou <code>nodes</code>, ou quando o nó <code>start</code> não existe.

<span id="Node"></span>
=== Nó ===

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>line</code> || Texto || '''Obrigatório.''' O que o NPC diz. Uma chave de tradução ou texto simples; aceita [[Special:MyLanguage/NPC Dialogue#Placeholders|marcadores]]. Um nó sem <code>line</code> é ignorado.
|-
| <code>choices</code> || Array || As respostas do jogador, listadas como opções. Um nó sem opções só mostra sua fala; o jogador sai com '''Fechar''' ou {{Key|Esc}}.
|}

<span id="Choice"></span>
=== Opção ===

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>text</code> || Texto || '''Obrigatório.''' Texto do botão. Uma chave de tradução ou texto simples; aceita marcadores. Uma opção sem <code>text</code> é ignorada.
|-
| <code>goto</code> || Texto || Nó a ser mostrado em seguida. Omita-o (ou aponte para um nó que não existe) para encerrar a conversa.
|-
| <code>conditions</code> || Objeto || Opcional. A opção só aparece quando as condições são atendidas. Mesmo formato dos <code>prerequisites</code> das missões (veja abaixo). Se o bloco não puder ser lido, a opção inteira é descartada em vez de aparecer para todos.
|-
| <code>actions</code> || Array || Opcional. Ações executadas em ordem quando a opção é escolhida (veja abaixo).
|}

<span id="Conditions"></span>
=== Condições ===
<code>conditions</code> usa o formato de árvore de condições das missões: um <code>operator</code> (<code>AND</code> ou <code>OR</code>) e uma lista de <code>conditions</code>, que podem ser aninhadas. Qualquer tipo de condição de missão funciona, por exemplo:

<syntaxhighlight lang="json">
{ "operator": "OR", "conditions": [
    { "type": "RACE", "race": "saiyan" },
    { "type": "SAGA_QUEST", "sagaId": "saiyan_saga", "questId": 12 },
    { "type": "ALIGNMENT", "max": 40 }
] }
</syntaxhighlight>

Os tipos disponíveis são <code>SAGA_QUEST</code>, <code>QUEST</code>, <code>LEVEL</code>, <code>STAT</code>, <code>RACE</code>, <code>CLASS</code>, <code>SKILL</code>, <code>BIOME</code>, <code>DIMENSION</code>, <code>STRUCTURE</code>, <code>ALIGNMENT</code> e <code>TIME</code>. Os nomes dos campos são os mesmos das missões (por exemplo, <code>LEVEL</code> usa <code>minLevel</code>); veja [[Special:MyLanguage/Custom Quests#Prerequisites and requirements|Missões personalizadas]].

As condições são verificadas de novo no servidor quando o jogador escolhe a opção, então não dá para forçar uma opção oculta.

<span id="Actions"></span>
=== Ações ===

{| class="wikitable"
! <code>type</code> !! Campos !! O que faz
|-
| <code>ALIGNMENT</code> || <code>amount</code> || Soma <code>amount</code> à índole do jogador (valores negativos a diminuem).
|-
| <code>TPS</code> || <code>amount</code> || Dá <code>amount</code> pontos de treino (apenas quantidades positivas).
|-
| <code>COMMAND</code> || <code>command</code> || Executa um comando pelo servidor com permissões de operador. <code>%player%</code> é substituído pelo nome do jogador.
|-
| <code>START_QUEST</code> || <code>quest</code> || Inicia uma missão com as mesmas regras de quando ela é iniciada pelo registro de missões (pré-requisitos, requisitos de início, grupo). Use o id da missão secundária (por exemplo, <code>"bulma_gero_blueprints"</code>) ou <code>sagaId:questId</code> para uma missão de saga (por exemplo, <code>"saiyan_saga:3"</code>). Se a missão não puder ser iniciada, nada acontece.
|-
| <code>OPEN_QUESTS</code> || Nenhum || Troca a mesma janela para a lista de missões do NPC (aceitar, entregar, ver missões bloqueadas) e encerra a árvore (<code>goto</code> é ignorado).
|}

<code>value</code> é aceito como alias genérico de <code>command</code> e <code>quest</code>. Uma ação com um <code>type</code> desconhecido é ignorada e registrada no log.

<span id="Placeholders"></span>
== Marcadores ==
As falas e os textos das opções podem conter estes marcadores; eles são preenchidos para o jogador que os lê:

{| class="wikitable"
! Marcador !! Valor
|-
| <code>%player%</code> || Nome do jogador
|-
| <code>%race%</code> || Id da raça
|-
| <code>%class%</code> || Id da classe
|-
| <code>%level%</code> || Nível do jogador
|-
| <code>%alignment%</code> || Índole
|-
| <code>%deaths%</code> || Número de mortes
|-
| <code>%form%</code> || Forma ativa (<code>base</code> quando não transformado)
|-
| <code>%dimension%</code> || Nome da dimensão (por exemplo, <code>overworld</code>)
|}

Os marcadores também funcionam dentro das suas próprias traduções. Addons em Java podem adicionar mais com <code>DMZTextPlaceholders.register(...)</code>; veja [[Special:MyLanguage/Implementation and Events#Custom text placeholders|Implementação e eventos]].

<span id="Translations"></span>
== Traduções ==
<code>line</code> e <code>text</code> aparecem traduzidos quando correspondem a uma chave de tradução de um arquivo de idioma, e como foram escritos caso contrário. A aba de nome acima da fala mostra o nome habitual do NPC (o nome da entidade, por exemplo <code>entity.dragonminez.master_roshi</code>). As traduções próprias se combinam com as do Crowdin da mesma forma que nas [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|raças personalizadas]].

<span id="Reload_and_validate"></span>
== Recarregar e validar ==
# Salve seu arquivo em <code><world save>/dragonminez/dialogues/</code>.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute <code>/dmzreload story</code>; veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]].
# Confira o console do servidor: ele registra quantas árvores foram carregadas e aponta qualquer nó, opção ou ação que tenha sido ignorado.
# Fale com o NPC e percorra todos os ramos, incluindo as opções que dependem de condições.

{{Navbox Modding}}