Ver código fonte para NPC Dialogue/es

Los '''diálogos de NPCs''' te permiten darles a los NPCs maestros conversaciones ramificadas solo con JSON, sin Java. Un árbol de diálogo es un conjunto de '''nodos''': cada nodo es una línea que dice el NPC, más las '''opciones''' con las que el jugador puede responder. Las opciones pueden llevar a otro nodo, quedar ocultas tras '''condiciones''' y ejecutar '''acciones''' como cambiar el alineamiento, dar TP, ejecutar un comando o iniciar una misión.

Los diálogos son datos de cada mundo, como las misiones y los deseos.

<span id="Where_files_go"></span>
== Dónde van los archivos ==

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

La carpeta se crea la primera vez que arranca el servidor, junto con un <code>_example.json</code> que puedes copiar. Cada archivo <code>.json</code> de la carpeta (sin subcarpetas) contiene '''un árbol para un NPC'''. Los archivos se cargan en orden alfabético; si dos archivos apuntan al mismo NPC, gana el último.

Los diálogos se cargan al iniciar el servidor y se recargan con <code>/dmzreload story</code> (o <code>/dmzreload all</code>); consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].

Código fuente: <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>
== Qué NPCs pueden usarlos ==
Los árboles de diálogo funcionan con los '''NPCs maestros''': los entrenadores colocados por [[Special:MyLanguage/NPC Placement and Alignment|Ubicación y alineamiento de NPCs]], como Roshi o Goku. El campo <code>npc</code> es el id del maestro. Los maestros que DragonMineZ coloca por defecto usan estos 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|Kaiosama]]), <code>toribot</code>, <code>enma</code>, <code>baba</code>, <code>grandkai</code>, <code>otherworld_announcer</code>

Cuando un maestro tiene un árbol, al hacer clic derecho sobre él se muestra el árbol '''en lugar de''' las opciones habituales del maestro (Misiones, Habilidades, Entrenar y servicios; consulta [[Special:MyLanguage/Masters|Maestros]]). El árbol usa la misma ventana de diálogo: la línea aparece en el centro de la franja inferior y las opciones se listan a la derecha. Dale a una de tus opciones la acción <code>OPEN_QUESTS</code> para que los jugadores puedan seguir llegando a las misiones del maestro. El jugador tiene que haber creado un personaje antes. El requisito de alineamiento de un maestro no impide la conversación; solo bloquea Habilidades, Entrenar y las misiones nuevas (consulta [[Special:MyLanguage/Masters|Maestros]]).

Los NPCs de misiones por defecto (<code>dragonminez:quest_npc</code>, por ejemplo Bulma) conservan su lista de misiones y no usan árboles de diálogo.

<span id="File_format"></span>
== Formato del archivo ==

<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>
=== Árbol ===

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>npc</code> || Texto || '''Obligatorio.''' El id del maestro al que pertenece el árbol (sin distinguir mayúsculas y minúsculas). Un id que empieza por <code>_</code> deja el archivo inactivo; así es como <code>_example.json</code> queda desactivado.
|-
| <code>start</code> || Texto || Id del primer nodo. Por defecto <code>"start"</code>.
|-
| <code>nodes</code> || Objeto || '''Obligatorio.''' Mapa de id de nodo a nodo.
|}

Un árbol se omite (y se registra el motivo) cuando falta <code>npc</code> o <code>nodes</code>, o cuando el nodo <code>start</code> no existe.

<span id="Node"></span>
=== Nodo ===

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>line</code> || Texto || '''Obligatorio.''' Lo que dice el NPC. Una clave de traducción o texto simple; admite [[Special:MyLanguage/NPC Dialogue#Placeholders|marcadores]]. Un nodo sin <code>line</code> se omite.
|-
| <code>choices</code> || Array || Las respuestas del jugador, listadas como opciones. Un nodo sin opciones solo muestra su línea; el jugador sale con '''Cerrar''' o {{Key|Esc}}.
|}

<span id="Choice"></span>
=== Opción ===

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>text</code> || Texto || '''Obligatorio.''' Texto del botón. Una clave de traducción o texto simple; admite marcadores. Una opción sin <code>text</code> se omite.
|-
| <code>goto</code> || Texto || Nodo que se muestra a continuación. Omítelo (o apúntalo a un nodo que no existe) para terminar la conversación.
|-
| <code>conditions</code> || Objeto || Opcional. La opción solo se muestra cuando se cumplen las condiciones. Mismo formato que los <code>prerequisites</code> de las misiones (ver abajo). Si el bloque no se puede leer, se descarta toda la opción en lugar de mostrarse a todos.
|-
| <code>actions</code> || Array || Opcional. Acciones que se ejecutan en orden al elegir la opción (ver abajo).
|}

<span id="Conditions"></span>
=== Condiciones ===
<code>conditions</code> usa el formato de árbol de condiciones de las misiones: un <code>operator</code> (<code>AND</code> u <code>OR</code>) y una lista de <code>conditions</code>, que se pueden anidar. Sirve cualquier tipo de condición de misión, por ejemplo:

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

Los tipos disponibles son <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> y <code>TIME</code>. Los nombres de los campos son los mismos que en las misiones (por ejemplo, <code>LEVEL</code> usa <code>minLevel</code>); consulta [[Special:MyLanguage/Custom Quests#Prerequisites and requirements|Misiones personalizadas]].

Las condiciones se vuelven a comprobar en el servidor cuando el jugador elige la opción, así que no se puede forzar una opción oculta.

<span id="Actions"></span>
=== Acciones ===

{| class="wikitable"
! <code>type</code> !! Campos !! Qué hace
|-
| <code>ALIGNMENT</code> || <code>amount</code> || Suma <code>amount</code> al alineamiento del jugador (los valores negativos lo bajan).
|-
| <code>TPS</code> || <code>amount</code> || Da <code>amount</code> puntos de entrenamiento (solo cantidades positivas).
|-
| <code>COMMAND</code> || <code>command</code> || Ejecuta un comando desde el servidor con permisos de operador. <code>%player%</code> se reemplaza por el nombre del jugador.
|-
| <code>START_QUEST</code> || <code>quest</code> || Inicia una misión con las mismas reglas que al iniciarla desde el registro de misiones (prerrequisitos, requisitos de inicio, grupo). Usa el id de la misión secundaria (por ejemplo <code>"bulma_gero_blueprints"</code>) o <code>sagaId:questId</code> para una misión de saga (por ejemplo <code>"saiyan_saga:3"</code>). Si la misión no se puede iniciar, no pasa nada.
|-
| <code>OPEN_QUESTS</code> || Ninguno || Cambia la misma ventana a la lista de misiones del NPC (aceptar, entregar, ver misiones bloqueadas) y termina el árbol (<code>goto</code> se ignora).
|}

<code>value</code> se acepta como alias genérico de <code>command</code> y <code>quest</code>. Una acción con un <code>type</code> desconocido se omite y se registra en el log.

<span id="Placeholders"></span>
== Marcadores ==
Las líneas y los textos de las opciones pueden contener estos marcadores; se rellenan para el jugador que los lee:

{| class="wikitable"
! Marcador !! Valor
|-
| <code>%player%</code> || Nombre del jugador
|-
| <code>%race%</code> || Id de la raza
|-
| <code>%class%</code> || Id de la clase
|-
| <code>%level%</code> || Nivel del jugador
|-
| <code>%alignment%</code> || Alineamiento
|-
| <code>%deaths%</code> || Número de muertes
|-
| <code>%form%</code> || Forma activa (<code>base</code> sin transformarse)
|-
| <code>%dimension%</code> || Nombre de la dimensión (por ejemplo <code>overworld</code>)
|}

Los marcadores también funcionan dentro de tus propias traducciones. Los addons en Java pueden añadir más con <code>DMZTextPlaceholders.register(...)</code>; consulta [[Special:MyLanguage/Implementation and Events#Custom text placeholders|Implementación y eventos]].

<span id="Translations"></span>
== Traducciones ==
<code>line</code> y <code>text</code> se muestran traducidos cuando coinciden con una clave de traducción de un archivo de idioma, y tal cual están escritos en caso contrario. La pestaña de nombre sobre la línea muestra el nombre habitual del NPC (su nombre de entidad, por ejemplo <code>entity.dragonminez.master_roshi</code>). Las traducciones propias se combinan con las de Crowdin igual que en las [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|razas personalizadas]].

<span id="Reload_and_validate"></span>
== Recarga y validación ==
# Guarda tu archivo en <code><world save>/dragonminez/dialogues/</code>.
# Valida la sintaxis JSON (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
# Ejecuta <code>/dmzreload story</code>; consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].
# Revisa la consola del servidor: registra cuántos árboles se cargaron e indica cualquier nodo, opción o acción que se haya omitido.
# Habla con el NPC y recorre todas las ramas, incluidas las opciones que dependen de condiciones.

{{Navbox Modding}}