Encontrar carpetas
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
config/dragonminez/ 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 Recargar y actualizar cambios).
| Ruta | Uso |
|---|---|
config/dragonminez/general-server.json |
Opciones de jugabilidad de todo el servidor (consulta Configuración del servidor). |
config/dragonminez/general-user.json |
Solo cliente. Ajustes personales del cliente, el servidor nunca los envía (consulta Configuración del cliente). |
config/dragonminez/hud_layout.json |
Solo cliente. Estilo del HUD y disposición de sus elementos (consulta HUD). |
config/dragonminez/radial_layout.json |
Orden de las entradas de los menús radiales en el cliente, que se guarda cuando las reordenas. |
config/dragonminez/combat.json |
Valores de ajuste del combate (consulta Configuración de combate). |
config/dragonminez/skills.json |
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 Configuración de habilidades). |
config/dragonminez/training.json |
Ajuste de los minijuegos de entrenamiento de TP (consulta Puntos de entrenamiento y maestría). |
config/dragonminez/techniques.json |
Ajuste de los ataques de ki y los Super Golpes (consulta Configuración de habilidades). |
config/dragonminez/entities.json |
Estadísticas base de cada entidad y valores por defecto de las transformaciones de saga (consulta Configuración de entidades). |
config/dragonminez/races/<race>/character.json |
Identidad de la raza y valores por defecto de su apariencia (consulta Razas personalizadas). |
config/dragonminez/races/<race>/stats.json |
Estadísticas base de la raza y su escalado para cada clase. |
config/dragonminez/races/<race>/forms/*.json |
Formas que pertenecen solo a esa raza. |
config/dragonminez/forms/*.json |
Formas acumulables compartidas, que se suman a las formas propias de una raza (consulta Formas personalizadas). |
config/dragonminez/raids/*.json |
Definiciones de incursiones (consulta Incursiones). |
config/dragonminez/tournaments/*.json |
Definiciones de torneos (consulta Torneos). |
config/dragonminez/oldBackup/ |
Copias de los archivos de configuración que DragonMineZ actualizó o regeneró, con la misma estructura relativa (por ejemplo oldBackup/races/saiyan/stats.json). DragonMineZ nunca vuelve a leerlas.
|
Las razas por defecto que se generan aquí son human, saiyan, namekian, frostdemon, bioandroid, majin y glind. Cualquier otra carpeta dentro de races/ se carga como raza personalizada.
Código fuente: ConfigManager.java (loadGeneralConfigs, loadAllRaces, createOrLoadStackForms, loadRaids, loadTournaments).
Carpeta del mundo guardado
<world save>/dragonminez/ 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:
saves/<world>/dragonminez/ - Servidor:
<server>/<level-name>/dragonminez/ - Entorno de desarrollo:
run/saves/<world>/dragonminez/
| Ruta | Uso |
|---|---|
dragonminez/sagas/ |
Manifiestos de las sagas (el puntero questFolder y los metadatos de la saga).
|
dragonminez/quests/<questFolder>/ |
Archivos de misiones de una saga, cargados en orden alfabético (01_...json, 02_...json, ...).
|
dragonminez/sidequests/ |
Misiones secundarias independientes, cargadas cuando las misiones secundarias están activadas. |
dragonminez/wishes/*.json |
Lista de deseos de cada dragón (shenron.json, porunga.json, ...; consulta Deseos personalizados).
|
dragonminez/dialogues/*.json |
Árboles de diálogo de NPCs (consulta Diálogos de NPCs). La primera vez se escribe un _example.json; los archivos cuyo id de NPC empieza por _ no se cargan.
|
dragonminez/npcs/placements.json |
Posiciones de aparición de los NPCs maestros y entrenadores (consulta Ubicación y alineamiento de NPCs). |
dragonminez/npcs/alignment_rules.json |
Umbrales de alineamiento y hostilidad de cada NPC (consulta Ubicación y alineamiento de NPCs). |
dragonminez/playerdata_json/<uuid>.json |
Datos guardados de los jugadores, solo se usan cuando storageType es JSON.
|
dragonminez/oldBackup/ |
Copias de los archivos por defecto de misiones, sagas y misiones secundarias tomadas antes de que DragonMineZ los actualizara, con la misma estructura relativa. |
dragonminez/quest_update_report.txt |
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: QuestRegistry.loadAll(server), WishManager.loadWishes(server), DialogueRegistry.loadAll(server).
Archivos de historia por defecto
gameplayDragonMineZ 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 general-server.json (storyModeEnabled y createDefaultSagas para las sagas y sus misiones, createDefaultSideQuests para las misiones secundarias). Con autoUpdateQuests 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 dragonminez/oldBackup/. Los archivos que creaste tú nunca se tocan. Consulta Recargar y actualizar cambios.
Archivos de datos del mundo
Parte del estado de DragonMineZ se guarda como "saved data" de vanilla: archivos .dat en la carpeta data/ del mundo, o en la carpeta data/ propia de una dimensión. Estos archivos son binarios y no están pensados para editarse a mano: dragon_balls_data (posiciones de las Esferas del Dragón), dragonminez_mutants, dragonminez_parties, dragonminez_pothala_pairs, dragonminez_raids, dragonminez_raid_sites, dragonminez_structure_plan, dragonminez_worldbosses, dragonminez_npc_placements, dragonminez_tournaments y dragonminez_otherworld_tournament.
Carpeta de paquetes de Esferas del Dragón
<game dir>/dragonballs/ 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 .zip. DragonMineZ también busca una carpeta dragonballs en el directorio de trabajo actual y en la carpeta superior al directorio del juego. Los paquetes los carga DragonBallPackManager; consulta Deseos personalizados.
Caché de partituras de Ritmo
<game dir>/dragonminez/rhythm_charts/ 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 (data/<namespace>/...) en lugar de estar en config/ o en el mundo guardado:
spacepod/*.json: la lista de destinos de la Cápsula Espacial (consulta Destinos de la Cápsula Espacial).weapon_attributes/*.json: definiciones de atributos de armas (consulta Atributos de armas).structure_npcs/*.json: NPCs colocados dentro de estructuras de DragonMineZ (consulta Ubicación y alineamiento de NPCs).rhythm_charts/*.json: partituras del minijuego de entrenamiento Ritmo.
Estos los recarga el /reload de vanilla, no /dmzreload. Las definiciones de Esferas del Dragón y de deseos no se leen de datapacks: usa un paquete de addon en <game dir>/dragonballs/ o la carpeta dragonminez/wishes/ del mundo. Consulta 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 customModel) están en el namespace normal del paquete de recursos, por ejemplo:
assets/dragonminez/geo/entity/races/assets/dragonminez/lang/en_us.json(el archivo de idioma fuente)
Estos requieren una recarga de recursos (F3 + T en el cliente) o un reinicio. Consulta Recargar y actualizar cambios y 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:
config/dragonminez/ - Añadir o editar contenido de historia, deseos, diálogos o la ubicación de NPCs de este mundo:
<world save>/dragonminez/ - Distribuir un paquete de Esferas del Dragón:
<game dir>/dragonballs/ - Destinos de la Cápsula Espacial, atributos de armas, partituras de ritmo: un datapack
- Añadir un modelo, textura o animación:
assets/dragonminez/...en un paquete de recursos