Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T08:12:19Z

Translation sync from dragonminez-wiki repository

New page

'''Encontrar carpetas''' indica dónde guarda DragonMineZ sus datos editables. Los archivos se reparten entre varias raíces distintas, según '''a quién pertenecen los datos''' y '''cuándo se leen'''. Saber qué raíz necesitas te ahorra muchas confusiones, sobre todo porque algunas carpetas solo aparecen después de haber ejecutado el servidor o el cliente al menos una vez.


== Carpeta de configuración del mod ==
<code>config/dragonminez/</code> contiene la configuración del mod. Pertenece a la instancia del juego, no a un mundo, y se genera la primera vez que se inicia DragonMineZ. Aquí es donde ajustas el balance y las estadísticas, y añades razas, formas y entidades personalizadas. Salvo los dos archivos solo de cliente marcados abajo, el servidor envía todos los archivos de esta carpeta a los clientes que se conectan (consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]).

{| class="wikitable"
! Ruta !! Uso
|-
| <code>config/dragonminez/general-server.json</code> || Opciones de jugabilidad de todo el servidor (consulta [[Special:MyLanguage/General Server Config|Configuración del servidor]]).
|-
| <code>config/dragonminez/general-user.json</code> || '''Solo cliente.''' Ajustes personales del cliente, el servidor nunca los envía (consulta [[Special:MyLanguage/General User Config|Configuración del cliente]]).
|-
| <code>config/dragonminez/hud_layout.json</code> || '''Solo cliente.''' Estilo del HUD y disposición de sus elementos (consulta [[Special:MyLanguage/HUD|HUD]]).
|-
| <code>config/dragonminez/radial_layout.json</code> || Orden de las entradas de los menús radiales en el cliente, que se guarda cuando las reordenas.
|-
| <code>config/dragonminez/combat.json</code> || Valores de ajuste del combate (consulta [[Special:MyLanguage/Combat Config|Configuración de combate]]).
|-
| <code>config/dragonminez/skills.json</code> || Costos, tiempos de recarga y requisitos de las habilidades, y las habilidades que ofrece cada raza y maestro; ambas cosas están en este único archivo (consulta [[Special:MyLanguage/Skills Config|Configuración de habilidades]]).
|-
| <code>config/dragonminez/training.json</code> || Ajuste de los minijuegos de entrenamiento de TP (consulta [[Special:MyLanguage/Training Points and Mastery|Puntos de entrenamiento y maestría]]).
|-
| <code>config/dragonminez/techniques.json</code> || Ajuste de los ataques de ki y los Super Golpes (consulta [[Special:MyLanguage/Skills Config|Configuración de habilidades]]).
|-
| <code>config/dragonminez/entities.json</code> || Estadísticas base de cada entidad y valores por defecto de las transformaciones de saga (consulta [[Special:MyLanguage/Entities Config|Configuración de entidades]]).
|-
| <code>config/dragonminez/races/<race>/character.json</code> || Identidad de la raza y valores por defecto de su apariencia (consulta [[Special:MyLanguage/Custom Races|Razas personalizadas]]).
|-
| <code>config/dragonminez/races/<race>/stats.json</code> || Estadísticas base de la raza y su escalado para cada clase.
|-
| <code>config/dragonminez/races/<race>/forms/*.json</code> || Formas que pertenecen solo a esa raza.
|-
| <code>config/dragonminez/forms/*.json</code> || Formas acumulables compartidas, que se suman a las formas propias de una raza (consulta [[Special:MyLanguage/Custom Forms|Formas personalizadas]]).
|-
| <code>config/dragonminez/raids/*.json</code> || Definiciones de incursiones (consulta [[Special:MyLanguage/Raids|Incursiones]]).
|-
| <code>config/dragonminez/tournaments/*.json</code> || Definiciones de torneos (consulta [[Special:MyLanguage/Tournaments|Torneos]]).
|-
| <code>config/dragonminez/oldBackup/</code> || Copias de los archivos de configuración que DragonMineZ actualizó o regeneró, con la misma estructura relativa (por ejemplo <code>oldBackup/races/saiyan/stats.json</code>). DragonMineZ nunca vuelve a leerlas.
|}

Las razas por defecto que se generan aquí son <code>human</code>, <code>saiyan</code>, <code>namekian</code>, <code>frostdemon</code>, <code>bioandroid</code>, <code>majin</code> y <code>glind</code>. Cualquier otra carpeta dentro de <code>races/</code> se carga como raza personalizada.

Código fuente: <code>ConfigManager.java</code> (<code>loadGeneralConfigs</code>, <code>loadAllRaces</code>, <code>createOrLoadStackForms</code>, <code>loadRaids</code>, <code>loadTournaments</code>).


== Carpeta del mundo guardado ==
<code><world save>/dragonminez/</code> está dentro del mundo guardado, así que su contenido pertenece a un solo mundo, no a toda la instancia. Por eso los cambios en misiones y sagas no aparecen hasta que editas la carpeta del mundo correcto:
* Un jugador: <code>saves/<world>/dragonminez/</code>
* Servidor: <code><server>/<level-name>/dragonminez/</code>
* Entorno de desarrollo: <code>run/saves/<world>/dragonminez/</code>

{| class="wikitable"
! Ruta !! Uso
|-
| <code>dragonminez/sagas/</code> || Manifiestos de las sagas (el puntero <code>questFolder</code> y los metadatos de la saga).
|-
| <code>dragonminez/quests/<questFolder>/</code> || Archivos de misiones de una saga, cargados en orden alfabético (<code>01_...json</code>, <code>02_...json</code>, ...).
|-
| <code>dragonminez/sidequests/</code> || Misiones secundarias independientes, cargadas cuando las misiones secundarias están activadas.
|-
| <code>dragonminez/wishes/*.json</code> || Lista de deseos de cada dragón (<code>shenron.json</code>, <code>porunga.json</code>, ...; consulta [[Special:MyLanguage/Custom Wishes|Deseos personalizados]]).
|-
| <code>dragonminez/dialogues/*.json</code> || Árboles de diálogo de NPCs (consulta [[Special:MyLanguage/NPC Dialogue|Diálogos de NPCs]]). La primera vez se escribe un <code>_example.json</code>; los archivos cuyo id de NPC empieza por <code>_</code> no se cargan.
|-
| <code>dragonminez/npcs/placements.json</code> || Posiciones de aparición de los NPCs maestros y entrenadores (consulta [[Special:MyLanguage/NPC Placement and Alignment|Ubicación y alineamiento de NPCs]]).
|-
| <code>dragonminez/npcs/alignment_rules.json</code> || Umbrales de alineamiento y hostilidad de cada NPC (consulta [[Special:MyLanguage/NPC Placement and Alignment|Ubicación y alineamiento de NPCs]]).
|-
| <code>dragonminez/playerdata_json/<uuid>.json</code> || Datos guardados de los jugadores, solo se usan cuando <code>storageType</code> es <code>JSON</code>.
|-
| <code>dragonminez/oldBackup/</code> || Copias de los archivos por defecto de misiones, sagas y misiones secundarias tomadas antes de que DragonMineZ los actualizara, con la misma estructura relativa.
|-
| <code>dragonminez/quest_update_report.txt</code> || Resumen de la última actualización de las misiones por defecto: valores actualizados y conflictos en los que se conservaron tus cambios.
|}

Código fuente: <code>QuestRegistry.loadAll(server)</code>, <code>WishManager.loadWishes(server)</code>, <code>DialogueRegistry.loadAll(server)</code>.


=== Archivos de historia por defecto ===
{{Config|General Server Config|gameplay}}
DragonMineZ escribe sus archivos por defecto de sagas, misiones y misiones secundarias solo cuando no existen y las opciones de generación por defecto están activadas en <code>general-server.json</code> (<code>storyModeEnabled</code> y <code>createDefaultSagas</code> para las sagas y sus misiones, <code>createDefaultSideQuests</code> para las misiones secundarias). Con <code>autoUpdateQuests</code> activado (por defecto), los archivos que generó DragonMineZ se actualizan en su lugar cuando una nueva versión de DragonMineZ los cambia: tus cambios se conservan y antes se guarda una copia en <code>dragonminez/oldBackup/</code>. Los archivos que creaste tú nunca se tocan. Consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].


=== Archivos de datos del mundo ===
Parte del estado de DragonMineZ se guarda como "saved data" de vanilla: archivos <code>.dat</code> en la carpeta <code>data/</code> del mundo, o en la carpeta <code>data/</code> propia de una dimensión. Estos archivos son binarios y no están pensados para editarse a mano: <code>dragon_balls_data</code> (posiciones de las Esferas del Dragón), <code>dragonminez_mutants</code>, <code>dragonminez_parties</code>, <code>dragonminez_pothala_pairs</code>, <code>dragonminez_raids</code>, <code>dragonminez_raid_sites</code>, <code>dragonminez_structure_plan</code>, <code>dragonminez_worldbosses</code>, <code>dragonminez_npc_placements</code>, <code>dragonminez_tournaments</code> y <code>dragonminez_otherworld_tournament</code>.


== Carpeta de paquetes de Esferas del Dragón ==
<code><game dir>/dragonballs/</code> está junto a tus mundos y a la instancia (no dentro del mundo guardado). Contiene definiciones de Esferas del Dragón externas y distribuibles: juegos de esferas, radares, dragones y sus deseos. Cada paquete de addon puede ser una carpeta normal o un archivo <code>.zip</code>. DragonMineZ también busca una carpeta <code>dragonballs</code> en el directorio de trabajo actual y en la carpeta superior al directorio del juego. Los paquetes los carga <code>DragonBallPackManager</code>; consulta [[Special:MyLanguage/Custom Wishes|Deseos personalizados]].


== Caché de partituras de Ritmo ==
<code><game dir>/dragonminez/rhythm_charts/</code> lo crea en el cliente el minijuego de entrenamiento Ritmo para las partituras que genera a partir de la música. Es una caché, no configuración.

== Datapacks ==
Algunos sistemas son reload listeners normales de Forge o de vanilla. Siguen las reglas normales de los datapacks (<code>data/<namespace>/...</code>) en lugar de estar en <code>config/</code> o en el mundo guardado:
* <code>spacepod/*.json</code>: la lista de destinos de la [[Special:MyLanguage/Space Pod|Cápsula Espacial]] (consulta [[Special:MyLanguage/Space Pod Destinations|Destinos de la Cápsula Espacial]]).
* <code>weapon_attributes/*.json</code>: definiciones de atributos de armas (consulta [[Special:MyLanguage/Weapon Attributes|Atributos de armas]]).
* <code>structure_npcs/*.json</code>: NPCs colocados dentro de estructuras de DragonMineZ (consulta [[Special:MyLanguage/NPC Placement and Alignment#Structure NPCs|Ubicación y alineamiento de NPCs]]).
* <code>rhythm_charts/*.json</code>: partituras del minijuego de entrenamiento Ritmo.
Estos los recarga el <code>/reload</code> de vanilla, no <code>/dmzreload</code>. Las definiciones de Esferas del Dragón y de deseos '''no''' se leen de datapacks: usa un paquete de addon en <code><game dir>/dragonballs/</code> o la carpeta <code>dragonminez/wishes/</code> del mundo. Consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]] para ver el detalle completo.


== Recursos de paquetes de recursos ==
Los modelos, texturas y animaciones a los que hace referencia la configuración (los campos <code>customModel</code>) están en el namespace normal del paquete de recursos, por ejemplo:
* <code>assets/dragonminez/geo/entity/races/</code>
* <code>assets/dragonminez/lang/en_us.json</code> (el archivo de idioma fuente)
Estos requieren una recarga de recursos ({{Key|F3}} + {{Key|T}} en el cliente) o un reinicio. Consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]] y [[Special:MyLanguage/Custom Models and Assets|Modelos y recursos propios]].


== Guía rápida para decidir ==
* Ajustar estadísticas, daño o costos, o añadir una raza, forma, entidad o incursión: <code>config/dragonminez/</code>
* Añadir o editar contenido de historia, deseos, diálogos o la ubicación de NPCs de '''este mundo''': <code><world save>/dragonminez/</code>
* Distribuir un paquete de Esferas del Dragón: <code><game dir>/dragonballs/</code>
* Destinos de la Cápsula Espacial, atributos de armas, partituras de ritmo: un datapack
* Añadir un modelo, textura o animación: <code>assets/dragonminez/...</code> en un paquete de recursos

{{Navbox Modding}}

Locating Specific Folders/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository