NPC Dialogue/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-22T01:37:17Z

Translation sync from dragonminez-wiki repository

← Older revision		Revision as of 01:37, 22 October 2026
Line 21:		Line 21:
	<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>		<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>

	~~<div class="mw-translate-fuzzy">~~		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 (un maestro al que no le agradas te saluda con una línea de rechazo); solo bloquea Habilidades, Entrenar y las misiones secundarias nuevas de ese maestro, mientras que las misiones de saga y las que ya están en curso siguen disponibles (consulta [[Special:MyLanguage/Masters\|Maestros]] y [[Special:MyLanguage/Alignment\|Alineamiento]]).
	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]]).
	~~</div>~~

	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.		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.

FuzzyBot: Updating to match new version of source page

2026-10-22T01:07:05Z

Updating to match new version of source page

← Older revision		Revision as of 01:07, 22 October 2026
Line 21:		Line 21:
	<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>		<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>

			<div class="mw-translate-fuzzy">
	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]]).		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]]).
			</div>

	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.		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.

Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T08:46:33Z

Translation sync from dragonminez-wiki repository

New page

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.


== 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>).


== 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.


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


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


=== 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}}.
|}


=== 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).
|}


=== 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.


=== 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.


== 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]].


== 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]].


== 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}}