View source for Developer Scope and Prerequisites/es

'''Alcance y requisitos''' explica para quién están escritas las páginas de contenido propio y de addons, las dos formas de ampliar DragonMineZ, y las carpetas y herramientas que necesitas antes de empezar. Ejecuta DragonMineZ una vez primero, para que se creen sus archivos de configuración.

<span id="Intended_audience"></span>
== Público objetivo ==
Las páginas de contenido propio y de addons están escritas para:
* Personas que saben editar JSON y recursos de paquetes de recursos.
* Personas que saben usar entornos de desarrollo de Minecraft Forge.
* Personas que quieren aportar contenido compatible con DMZ.
No cubren guías generales para jugadores, lore ni la progresión en supervivencia. Para eso, empieza por la [[Special:MyLanguage/Beginner's Guide|Guía para empezar]].

<span id="Two_ways_to_extend_DMZ"></span>
== Dos formas de ampliar DMZ ==

{| class="wikitable"
! Enfoque !! Qué necesitas !! Por dónde empezar
|-
| '''Addons de datos''' (configuraciones, razas, formas, misiones, deseos, paquetes de Esferas del Dragón, paquetes de recursos) || Un editor de texto y una instancia de DMZ || Esta página, y luego las páginas de JSON enlazadas abajo y en [[Special:MyLanguage/Modding|Contenido propio]]
|-
| '''Addons de código''' (tu propio mod de Forge que se engancha a los eventos y las API de DMZ) || Un entorno de desarrollo de Forge 1.20.1 || {{L|Add-on Getting Started}}
|}

<span id="Baseline_setup"></span>
== Configuración base ==
{{See also|Configuration|General Server Config|General User Config|Entities Config}}
# Ejecuta DMZ una vez para que se generen los archivos de configuración.
# Usa <code>config/dragonminez</code> como raíz de configuración de tus instancias de desarrollo locales.
# La configuración de cada raza está en <code>config/dragonminez/races/<race_name>/</code> (<code>character.json</code>, <code>stats.json</code> y una carpeta <code>forms/</code>). Consulta [[Special:MyLanguage/Custom Races|Razas personalizadas]].
# Las formas acumulables compartidas están en <code>config/dragonminez/forms/</code>. Consulta [[Special:MyLanguage/Custom Forms|Formas personalizadas]].
# Los atributos de las entidades se configuran en <code>config/dragonminez/entities.json</code>.
# Los ajustes generales del servidor están en <code>config/dragonminez/general-server.json</code>.
# Los ajustes generales del usuario (cliente) están en <code>config/dragonminez/general-user.json</code>.
# El combate, el entrenamiento, las habilidades y las técnicas de ki se configuran en <code>config/dragonminez/combat.json</code>, <code>config/dragonminez/training.json</code>, <code>config/dragonminez/skills.json</code> y <code>config/dragonminez/techniques.json</code>.
# Las definiciones de incursiones y torneos están en <code>config/dragonminez/raids/</code> y <code>config/dragonminez/tournaments/</code>, un archivo JSON por incursión o torneo; los archivos extra que añadas también se cargan.
# La disposición del HUD, solo del cliente y escrita por el editor de HUD del juego, es <code>config/dragonminez/hud_layout.json</code>.

Todos los archivos de configuración excepto <code>general-user.json</code> y <code>hud_layout.json</code> se envían del servidor a cada cliente al conectarse, así que los clientes siempre usan los valores del servidor.

Los archivos de configuración desactualizados o dañados no se descartan sin avisar: DMZ mueve el archivo viejo a <code>config/dragonminez/oldBackup/</code> (con la misma ruta relativa) y combina tus cambios con los nuevos valores por defecto. Consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]] y [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].

<span id="World_save_data"></span>
=== Datos del mundo guardado ===
Algunos sistemas viven dentro de la carpeta del mundo en lugar de <code>config/</code>:

{| class="wikitable"
! Carpeta !! Contenido !! Página
|-
| <code><world>/dragonminez/sagas/</code>, <code>quests/</code>, <code>sidequests/</code> || Sagas de la historia, misiones de saga y misiones secundarias || {{L|Custom Quests}}
|-
| <code><world>/dragonminez/wishes/</code> || Deseos personalizados de cada mundo (un archivo por dragón) || {{L|Custom Wishes}}
|-
| <code><world>/dragonminez/dialogues/</code> || Archivos de diálogo de NPCs || {{L|NPC Dialogue}}
|-
| <code><world>/dragonminez/npcs/</code> || Ubicaciones de NPCs (<code>placements.json</code>) y reglas de alineamiento (<code>alignment_rules.json</code>) || {{L|NPC Placement and Alignment}}
|-
| <code><world>/dragonminez/playerdata_json/</code> || Datos de los jugadores cuando se elige el backend de almacenamiento <code>JSON</code> || {{L|General Server Config}}
|}

Los paquetes de addons de Esferas del Dragón (carpetas o archivos <code>.zip</code>) van en la carpeta <code>dragonballs</code> del directorio del juego; consulta [[Special:MyLanguage/Custom Wishes|Deseos personalizados]]. ¿No sabes dónde está una carpeta en tu equipo? Consulta [[Special:MyLanguage/Locating Specific Folders|Encontrar carpetas]].

<span id="Reload_workflow"></span>
== Flujo de recarga ==
Después de cambiar archivos de configuración JSON, puedes recargarlos en el juego con <code>/dmzreload [all|config|story|wishes]</code> (sin argumento equivale a <code>all</code>). El código del comando está en <code>src/main/java/com/dragonminez/server/commands/ReloadCommand.java</code>. Consulta [[Special:MyLanguage/Commands|Comandos]] y [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]] para ver qué recarga cada sección.

Los cambios en paquetes de recursos (modelos y texturas) normalmente requieren una recarga de recursos o un reinicio.

<span id="Finding_JSON_mistakes"></span>
=== Encontrar errores en el JSON ===
{{Config|General Server Config|developer.reportJsonProblemsInChat}}
Cuando un archivo de configuración, misión o deseo no se puede cargar, DMZ registra el archivo, la línea y la columna, y la ruta JSON del problema. El informe se imprime en el log del servidor y se muestra en el chat a los jugadores al conectarse. Los dueños de servidores pueden desactivar el mensaje del chat con <code>developer.reportJsonProblemsInChat = false</code> en <code>general-server.json</code>.

<span id="Translations"></span>
== Traducciones ==
Todo el texto del juego usa claves de traducción. El archivo fuente en inglés es <code>assets/dragonminez/lang/en_us.json</code>; las traducciones de la comunidad se gestionan en Crowdin (consulta [[Special:MyLanguage/Contributing|Cómo contribuir]]).

DragonMineZ descarga automáticamente la última traducción de Crowdin para el idioma del juego que elegiste (todos los idiomas excepto <code>en_us</code>), así que las correcciones de traducción llegan a los jugadores sin actualizar el mod. Para desactivarlo (por ejemplo, para probar tu propio archivo de idioma), inicia el juego con el argumento de JVM <code>-Ddmz.crowdin.enabled=false</code>.

Cuando falta una clave de traducción, algunas pantallas de DMZ muestran una versión legible del id (por ejemplo, los textos de misiones y los nombres de formas se convierten en palabras con mayúscula inicial). Para nombres propios y otros idiomas, incluye tus propias claves en un paquete de recursos en <code>assets/<namespace>/lang/<locale>.json</code> y usa esas claves en tu JSON (por ejemplo, el nombre de una forma usa <code>race.dragonminez.<race>.form.<group>.<form></code>).

{{Navbox Add-ons}}