View source for NPC Placement and Alignment/es

'''Ubicación y alineamiento de NPCs''' trata de los archivos que deciden dónde están los NPCs maestros y entrenadores y cómo el alineamiento de un jugador cambia la forma en que cada NPC lo trata. De esto se encargan dos archivos JSON relacionados de cada mundo, ambos en <code><world save>/dragonminez/npcs/</code>, más un formato de datapack para los NPCs que viven dentro de estructuras.

{| class="wikitable"
! Archivo !! Qué controla
|-
| <code>placements.json</code> || Dónde aparecen los NPCs maestros y entrenadores (posición, dimensión, alineamiento o relación inicial).
|-
| <code>alignment_rules.json</code> || Cómo el alineamiento del '''jugador''' afecta la hostilidad, la amabilidad y la disponibilidad para interactuar de cada NPC.
|}

Ambos archivos se cargan al iniciar el servidor y se recargan con <code>/dmzreload config</code> (o <code>/dmzreload all</code>); consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]. Una recarga también vuelve a aplicar las ubicaciones en todas las dimensiones cargadas.

{{Note|type=warning|title=Los mundos antiguos conservan sus archivos antiguos|text=Ambos archivos solo se escriben con los valores por defecto de DragonMineZ cuando '''no existen'''. Un mundo creado con una versión anterior de DragonMineZ conserva sus archivos antiguos, así que no recibe las nuevas entradas por defecto (por ejemplo, los NPCs del Otro Mundo de la v2.2 y sus nuevas coordenadas). Para obtener los valores por defecto actuales, borra el archivo (respáldalo antes si lo editaste) y ejecuta <code>/dmzreload config</code>.}}

<span id="NPC_placement"></span>
== Ubicación de NPCs ==
<code>placements.json</code> lista todos los NPCs que coloca DragonMineZ y dónde.

Código fuente: <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 !! Qué hace
|-
| <code>id</code> || Texto || Id único de la ubicación. Se etiqueta en la entidad generada para que DragonMineZ pueda encontrarla y actualizarla después. Si dos ubicaciones comparten id, gana la última del archivo (se registra una advertencia).
|-
| <code>entity</code> || Texto || Id de registro del tipo de entidad.
|-
| <code>dimension</code> || Texto || Por defecto <code>minecraft:overworld</code>.
|-
| <code>npc_id</code> || Texto || Solo tiene sentido para entidades <code>dragonminez:quest_npc</code>: enlaza con el id de NPC del sistema de misiones.
|-
| <code>model</code> / <code>texture</code> || Texto || Solo se usa para entidades <code>quest_npc</code>.
|-
| <code>structure</code> || Texto || Si se define, <code>x</code>, <code>y</code> y <code>z</code> pasan a ser un '''desplazamiento''' desde el origen de esa estructura en lugar de coordenadas del 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>. Un valor no reconocido hace que <code>x</code>, <code>y</code> y <code>z</code> se traten como coordenadas del mundo sin más (con una advertencia en el log).
|-
| <code>x</code>, <code>y</code>, <code>z</code> || Número || Coordenadas del mundo, o el desplazamiento desde la estructura (ver arriba). Por defecto: <code>0.5</code>, <code>64.0</code>, <code>0.5</code>.
|-
| <code>yaw</code>, <code>pitch</code> || Número || Dirección a la que mira, en grados.
|-
| <code>surface</code> || Booleano || Si es <code>true</code>, ajusta la Y a la superficie del terreno al cargar en lugar de usar la Y indicada.
|-
| <code>relative_to_spawn</code> || Booleano || Si es <code>true</code>, suma el punto de aparición del mundo a <code>x</code> y <code>z</code> (se aplica después de cualquier desplazamiento de estructura).
|-
| <code>enabled</code> || Booleano || Si es <code>false</code>, esta ubicación se omite por completo.
|-
| <code>override</code> || Booleano || Si es <code>true</code>, la entidad siempre se vuelve a generar, aunque ya exista una para este <code>id</code>. Si no, la entidad existente solo se actualiza en su lugar.
|-
| <code>alignment</code> || Entero (0–100) || Alineamiento opcional para este NPC concreto: por encima de 60 es amistoso, de 41 a 60 neutral, y con 40 o menos hostil (salvo que una regla de alineamiento lo vuelva hostil antes, ver abajo).
|-
| <code>relation</code> || Texto || Reemplazo opcional para esta instancia (<code>HOSTILE</code>, <code>NEUTRAL</code> o <code>FRIENDLY</code>), guardado en la propia entidad en lugar de buscarse en las reglas de alineamiento.
|}

Las claves desconocidas se reportan en el informe de carga del JSON.

<span id="Default_placements"></span>
=== Ubicaciones por defecto ===
El archivo por defecto genera de forma activa estos NPCs:

{| class="wikitable"
! Id de ubicación !! Entidad !! Dónde
|-
| <code>master_roshi</code> || <code>dragonminez:master_roshi</code> || Kame House
|-
| <code>master_goku</code> || <code>dragonminez:master_goku</code> || Casa de 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> || La Atalaya de Kami
|-
| <code>master_gero</code> || <code>dragonminez:master_gero</code> || Laboratorio del Dr. Gero
|-
| <code>master_guru</code> || <code>dragonminez:master_guru</code> || Casa del Gran Anciano (Namek)
|-
| <code>master_kaiosama</code> || <code>dragonminez:master_kaiosama</code> || Otro Mundo, <code>54.5 299 1031.5</code>
|-
| <code>master_toribot</code> || <code>dragonminez:master_toribot</code> || Otro Mundo, <code>50.5 298 1030.5</code>
|-
| <code>master_enma</code> || <code>dragonminez:master_enma</code> || Otro Mundo, <code>0.5 150 17.5</code>
|-
| <code>master_baba</code> || <code>dragonminez:master_uranai</code> || Otro Mundo, <code>9.5 150 3.5</code>
|-
| <code>master_grandkai</code> || <code>dragonminez:master_grandkai</code> || Otro 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>) || Otro Mundo, <code>9.5 150 16.5</code>
|-
| <code>master_otherworld_announcer</code> || <code>dragonminez:master_otherworld_announcer</code> || Recinto del [[Special:MyLanguage/Otherworld Tournament|Torneo del Otro Mundo]], <code>-25.5 352 -1164.5</code> (solo se coloca una vez construido el recinto del torneo)
|}

<span id="Quest_NPCs_and_master_NPCs"></span>
=== NPCs de misiones y NPCs maestros ===
Los NPCs de misiones (Bulma, Krilin, Yamcha, Ten Shin Han, Piccolo, Gohan, Vegeta, Trunks, Chi-Chi, Videl, Shin y el Anciano Namekiano) también aparecen en el archivo por defecto, pero con <code>"enabled": false</code>: este sistema ya no los genera durante la partida. Están incluidos directamente en el NBT de la estructura, así que viven en lugares fijos colocados a mano en lugar de amontonarse en el punto de aparición del mundo. Sus entradas aquí son solo de referencia. Los NPCs añadidos a una estructura después de crear su NBT vienen, en cambio, de los [[Special:MyLanguage/NPC Placement and Alignment#Structure NPCs|archivos de NPCs de estructuras]] (Chi-Chi en la Casa de Goku es uno de ellos).

Los NPCs del Otro 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> y <code>npc_hell_ogre</code>) siempre fuerzan <code>override: true</code> internamente, diga lo que diga el archivo, ya que necesitan existir de forma fiable en una dimensión generada. Consulta [[Special:MyLanguage/Otherworld|Otro Mundo]].

<span id="Structure_NPCs"></span>
== NPCs de estructuras ==
Los archivos de NPCs de estructuras colocan NPCs '''dentro''' de una estructura de DragonMineZ sin editar su archivo <code>.nbt</code>. A diferencia de los archivos anteriores, estos son archivos de '''datapack''': <code>data/<namespace>/structure_npcs/*.json</code>, uno por estructura, cargados con los datapacks (y con <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 !! Obligatorio !! Qué hace
|-
| <code>structure</code> || Sí || Id de la estructura a la que pertenecen los NPCs.
|-
| <code>id</code> || Sí || Id único de este NPC dentro de la estructura. También es la clave de seguimiento, así que no le cambies el nombre una vez que los mundos lo usen.
|-
| <code>entity</code> || Sí || Tipo de entidad que se genera (por ejemplo <code>dragonminez:quest_npc</code> o el id de entidad de un maestro).
|-
| <code>npc_id</code> || No || Id del NPC de misiones, para <code>dragonminez:quest_npc</code>.
|-
| <code>model</code>, <code>texture</code> || No || Nombres de modelo y textura para los NPCs de misiones.
|-
| <code>template</code> || No || La plantilla de la estructura respecto a la que se mide la posición, para estructuras formadas por varias piezas.
|-
| <code>pos</code> || Sí || Posición '''relativa a la plantilla de la estructura''', así que queda bien sea cual sea la rotación con la que apareció la estructura.
|-
| <code>yaw</code> || No || Orientación, también relativa a la plantilla (por defecto <code>0</code>).
|-
| <code>alignment</code>, <code>relation</code> || No || Alineamiento y relación iniciales, como en <code>placements.json</code>.
|}

Cada NPC aparece '''una vez''' por estructura generada cuando se carga su chunk, incluidas las estructuras que se generaron antes de que existiera el archivo, y la aparición se recuerda: un NPC que muere no vuelve.

Para obtener las coordenadas, ponte donde debería estar el NPC y ejecuta <code>/dmzstructure here</code>: muestra la estructura, su plantilla y tu posición y yaw relativos a la plantilla, con un botón '''Copy NPC JSON''' que copia una entrada lista para usar. <code>/dmzstructure npcs</code> lista los NPCs de la estructura en la que estás y si cada uno ya apareció. Ambos comandos requieren el permiso <code>dragonminez.dmzstructure</code> (consulta [[Special:MyLanguage/Permissions|Permisos]]).

<span id="NPC_alignment_rules"></span>
== Reglas de alineamiento de NPCs ==
{{See also|Alignment|Masters}}
<code>alignment_rules.json</code> decide cómo reacciona cada NPC al alineamiento del jugador.

Código fuente: <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>

Las claves de <code>npcs</code> son ids de NPC '''sin ningún namespace''' (<code>dragonminez:roshi</code> pasa a ser la clave <code>roshi</code>).

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>default_relation</code> || <code>HOSTILE</code> / <code>NEUTRAL</code> / <code>FRIENDLY</code> || Relación base cuando ninguno de los umbrales de abajo la reemplaza. Por defecto <code>NEUTRAL</code>.
|-
| <code>hostile_below</code> || Entero || Si el alineamiento del jugador está por debajo de este valor, el NPC se vuelve hostil sin importar <code>default_relation</code>.
|-
| <code>hostile_above</code> || Entero || Lo mismo, pero para un alineamiento por encima de este valor.
|-
| <code>interaction.min_alignment</code> || Entero || El jugador necesita al menos este alineamiento para hablar con el NPC. Aunque el NPC no sea hostil, un alineamiento lo bastante bajo sigue bloqueando la interacción. También se puede escribir directamente en la regla, sin el contenedor <code>interaction</code>.
|-
| <code>interaction.max_alignment</code> || Entero || Lo mismo, pero como límite superior.
|}

Los cuatro campos de umbral son opcionales: omite los que no apliquen. Tomando como ejemplo la entrada <code>goku</code> de arriba: con menos de 25 de alineamiento, Goku es hostil; de 25 a 60 está presente pero no habla (el alineamiento está por debajo del <code>min_alignment</code> de 61); con 61 o más es amistoso y se puede hablar con él.

<code>NpcDispositionService.getRelation()</code> comprueba la relación en este orden:
# Gana una <code>relation</code> definida en la ubicación (<code>placements.json</code>).
# Los umbrales <code>hostile_below</code> y <code>hostile_above</code> de la regla.
# Un <code>alignment</code> definido en la ubicación.
# El <code>default_relation</code> de la regla.

<span id="Master_NPCs"></span>
=== NPCs maestros ===
Para los '''NPCs maestros y entrenadores''' el archivo de reglas decide la hostilidad, pero su filtro de alineamiento es una regla fija en lugar de <code>interaction</code>: siempre se puede hablar con los maestros, pero [[Special:MyLanguage/Goku|Goku]], [[Special:MyLanguage/Gohan|Gohan]], [[Special:MyLanguage/King Kai|Kaiosama]], [[Special:MyLanguage/Old Kai|Kaioshin Anciano]], [[Special:MyLanguage/Master Roshi|Roshi]] y [[Special:MyLanguage/Krillin|Krilin]] solo desbloquean sus '''Habilidades''', '''Entrenar''' y las misiones nuevas con un alineamiento de al menos '''61''', y [[Special:MyLanguage/Cell|Cell]] y [[Special:MyLanguage/Frieza|Freezer]] con '''40 o menos'''. Ningún otro maestro tiene filtro de alineamiento. Consulta [[Special:MyLanguage/Masters|Maestros]].

<span id="NPC_ids_covered_by_default"></span>
=== Ids de NPC incluidos por defecto ===
El archivo por defecto incluye <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> y <code>vegeta</code>.
* La mayoría usa por defecto <code>FRIENDLY</code> con <code>min_alignment: 41</code> (o <code>61</code> para Goku, Gurú, Dendé, Kaiosama y el Anciano Namekiano) y <code>hostile_below: 25</code>.
* <code>gero</code> usa por defecto <code>NEUTRAL</code> con <code>max_alignment: 60</code>.
* <code>enma</code>, <code>baba</code>, <code>toribot</code>, <code>grandkai</code>, <code>otherworld_announcer</code> y <code>vegeta</code> usan por defecto <code>NEUTRAL</code> sin umbrales.
* <code>piccolo</code> usa por defecto <code>NEUTRAL</code> con sus propios umbrales (<code>min_alignment: 41</code>, <code>hostile_below: 20</code>).

<span id="Reload_and_validate"></span>
== Recarga y validación ==
# Edita los archivos en <code><world save>/dragonminez/npcs/</code>.
# Valida la sintaxis JSON (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
# Ejecuta <code>/dmzreload config</code> (o <code>/dmzreload all</code>); consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].
# Comprueba que el NPC apareció o se movió como esperabas, y que la hostilidad y la interacción según el alineamiento se comportan como configuraste (prueba con un par de valores de alineamiento si puedes).

{{Navbox Modding}}