Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T09:48:10Z

Translation sync from dragonminez-wiki repository

New page

No todos los cambios necesitan reiniciar el servidor, pero tampoco todos se pueden aplicar en caliente. Esta página explica qué hace <code>/dmzreload</code>, cómo llegan los valores de configuración a los clientes, cuándo sigue haciendo falta un reinicio o una recarga de recursos, y qué pasa con tus archivos cuando se actualiza el propio DragonMineZ.


== El comando /dmzreload ==
{{See also|Commands|Permissions}}
<code>/dmzreload [target]</code> se define en <code>ReloadCommand.java</code>. Requiere el nodo de permiso <code>dragonminez.dmz.reload</code>, <code>dragonminez.admin</code> o el nivel de operador 2 (consulta [[Special:MyLanguage/Permissions|Permisos]]). La consola siempre puede ejecutarlo.

<syntaxhighlight lang="text">
/dmzreload -> reloads everything (same as "all")
/dmzreload all -> config + story + wishes
/dmzreload config -> config files, raids, storage, NPC rules and placements
/dmzreload story -> quests, sagas, side quests and NPC dialogues
/dmzreload wishes -> dragon wishes only
</syntaxhighlight>

{| class="wikitable"
! Objetivo !! Qué recarga
|-
| <code>config</code> || Todos los archivos de <code>config/dragonminez</code> (general, combate, entrenamiento, habilidades, técnicas, entidades, razas, formas, formas acumulables, incursiones, torneos), los tipos de incursión, el backend de almacenamiento de jugadores (<code>StorageManager.reload()</code>), las reglas de alineamiento de NPCs y las ubicaciones de NPCs (vuelve a hacer aparecer los NPCs configurados). Después, todos los archivos de configuración se vuelven a enviar a cada jugador conectado, y se resincronizan sus límites de habilidades y su progresión.
|-
| <code>story</code> || <code>QuestRegistry.loadAll(server)</code>, que vuelve a leer las sagas, misiones y misiones secundarias del mundo guardado (ejecutando la actualización automática de misiones descrita abajo), y <code>DialogueRegistry.loadAll(server)</code> para los diálogos de NPCs. Después, el registro de misiones se vuelve a enviar a cada jugador conectado.
|-
| <code>wishes</code> || <code>WishManager.loadWishes(server)</code>; después, los deseos se vuelven a enviar a cada jugador conectado.
|-
| <code>all</code> || Todo lo anterior, en ese orden.
|}

Después de una recarga, los jugadores conectados se resincronizan automáticamente; no necesitan volver a conectarse. La consola también muestra el informe de carga de JSON (archivos que no se pudieron cargar y archivos que se actualizaron automáticamente).


=== Pantalla de configuración en el juego ===
La entrada '''DragonMineZ''' de la pantalla ''Mods'' de Forge tiene una pantalla de configuración que lista todos los archivos de <code>config/dragonminez</code> y te permite editarlos en el juego; mientras estás en un mundo también tiene un botón de recarga que ejecuta <code>/dmzreload</code>. Edita los archivos de '''tu propia''' carpeta del juego, así que está pensada para partidas en un solo jugador y anfitriones de LAN. En un servidor dedicado, edita los archivos del servidor.


== Cambiar un valor en caliente con /dmzconfig ==
<code>/dmzconfig <file> <key> <value></code> o <code>/dmzconfig <file> <section> <key> <value></code> (permiso: <code>dragonminez.admin</code> o nivel de operador 2) cambia un solo valor, guarda el archivo y lo vuelve a enviar a cada jugador conectado. Ejemplos:

<syntaxhighlight lang="text">
/dmzconfig general-server gameplay tpGainMultiplier 2.0
/dmzconfig general-server worldGen generateDragonBalls false
</syntaxhighlight>

Solo edita valores simples (números, <code>true</code>/<code>false</code>, texto) directamente en el archivo o a un nivel de sección; las listas y los objetos más profundos se deben editar en el archivo. Escribe el archivo tal como está, sin la actualización de versión descrita abajo.


== Cómo llega la configuración a los clientes ==
{{See also|Configuration}}
* Cuando un jugador se conecta, el servidor le envía '''todos''' los archivos de <code>config/dragonminez</code> excepto los de solo cliente <code>general-user.json</code> y <code>hud_layout.json</code>, un paquete comprimido por archivo. Mientras está conectado, el cliente usa los valores del servidor para todo lo que controlan esos archivos (estadísticas, formas, habilidades, valores de combate que se muestran en los menús, etc.).
* <code>/dmzreload config</code> y <code>/dmzconfig</code> vuelven a enviar los archivos a todos los conectados.
* El servidor envía los archivos '''tal como están en el disco'''. Si editas un archivo y no recargas, el servidor sigue funcionando con los valores viejos mientras que los jugadores que se conecten después reciben tu archivo editado. Ejecuta siempre <code>/dmzreload config</code> después de editar.
* Al desconectarse, el cliente descarta la copia del servidor y vuelve a sus propios archivos locales.


== Qué cubre /dmzreload ==
* <code>config/dragonminez/general-server.json</code>, <code>combat.json</code>, <code>training.json</code>, <code>skills.json</code>, <code>techniques.json</code>, <code>entities.json</code>
* <code>config/dragonminez/races/<race>/character.json</code>, <code>stats.json</code> y <code>forms/*.json</code>, y <code>config/dragonminez/forms/*.json</code> (formas acumulables)
* <code>config/dragonminez/raids/*.json</code> y <code>config/dragonminez/tournaments/*.json</code>
* <code><world save>/dragonminez/{sagas,quests,sidequests}</code> y <code><world save>/dragonminez/dialogues</code> (con <code>story</code> o <code>all</code>)
* <code><world save>/dragonminez/wishes/*.json</code> (con <code>wishes</code> o <code>all</code>); consulta [[Special:MyLanguage/Custom Wishes|Deseos personalizados]]
* <code><world save>/dragonminez/npcs/{placements.json,alignment_rules.json}</code> (con <code>config</code> o <code>all</code>); consulta [[Special:MyLanguage/NPC Placement and Alignment|Ubicación y alineamiento de NPCs]]


== Qué no cubre /dmzreload ==
* '''<code>general-user.json</code> y <code>hud_layout.json</code>''': son archivos del cliente. Los jugadores los cambian desde la pantalla de Configuración del juego y el editor del HUD; las ediciones a mano necesitan reiniciar el juego.
* '''Recursos de resource packs''' (modelos, texturas, animaciones en <code>assets/dragonminez/...</code>). Necesitan una recarga de recursos del cliente ({{Key|F3}} + {{Key|T}}), ya que se cargan en el cliente, no desde la configuración del servidor.
* '''Listeners de recarga de datapacks''': <code>spacepod/*.json</code> (consulta [[Special:MyLanguage/Space Pod Destinations|Destinos de la Cápsula Espacial]]), <code>weapon_attributes/*.json</code> (consulta [[Special:MyLanguage/Weapon Attributes|Atributos de armas]]) y <code>rhythm_charts/*.json</code>. Siguen las reglas de los datapacks vanilla: usa el <code>/reload</code> vanilla o reinicia el servidor.
* '''Paquetes de addons externos de Esferas del Dragón''' en <code><game dir>/dragonballs/</code>. Los vuelve a leer el <code>/reload</code> vanilla (juegos de esferas, radares, dragones y los deseos del paquete). Ejecuta <code>/dmzreload wishes</code> después para que los archivos de deseos de cada mundo se vuelvan a combinar sobre los deseos recargados del paquete.
* '''Cambio de backend de almacenamiento''' (<code>NBT</code> ↔ <code>JSON</code> ↔ <code>DATABASE</code>): <code>/dmzreload config</code> guarda a los jugadores conectados y reinicia el backend de almacenamiento con los nuevos ajustes, pero cambiar de backend con jugadores conectados no es algo para hacer a la ligera; mejor hazlo con el servidor vacío.
* '''Código Java nuevo o jars de addons''': siempre requieren un reinicio.


== Actualizar DragonMineZ ==
Cuando instalas una versión nueva de DMZ, tus archivos se actualizan automáticamente en el siguiente arranque.


=== Archivos de configuración ===
{{See also|How to JSON}}
Cada archivo de configuración lleva un <code>configVersion</code> (por ejemplo <code>"2.2.0"</code>). Cuando es anterior a la versión del mod, DMZ mueve el archivo viejo a <code>config/dragonminez/oldBackup/<same path></code>, escribe los nuevos valores predeterminados y vuelve a combinar tus valores: los que nunca tocaste adoptan el nuevo valor predeterminado, los que cambiaste se conservan y se añaden las claves nuevas. Los detalles están en [[Special:MyLanguage/How to JSON|Cómo usar JSON]].


=== Misiones, sagas y misiones secundarias ===
{{See also|Custom Quests|Sagas}}
Con <code>autoUpdateQuests</code> activado en [[Special:MyLanguage/General Server Config|Configuración del servidor]] (el valor predeterminado), los archivos predeterminados de misiones, sagas y misiones secundarias que DMZ generó en tu mundo se actualizan de la misma forma cuando arranca el servidor (y con <code>/dmzreload story</code>):

* Cada archivo generado lleva un <code>"defaultsVersion"</code>. Los archivos que ya están en la versión actual se omiten.
* Un campo que nunca editaste adopta el nuevo valor predeterminado, así que los ajustes de balance llegan a tu mundo.
* Un campo que editaste conserva tu valor. Si la nueva versión también cambió ese campo, se registra como '''conflicto''', y tu valor sigue ganando.
* Las claves que añadiste se conservan. Las listas (objetivos, recompensas) solo se combinan entrada por entrada cuando su estructura sigue coincidiendo; si no, se conserva tu lista entera y se informa como conflicto.
* Antes de cambiar un archivo, se guarda una copia en <code><world>/dragonminez/oldBackup/<same path></code>. Un resumen de lo que cambió se escribe en <code><world>/dragonminez/quest_update_report.txt</code> y se muestra en el informe de carga de JSON.
* Los archivos de misiones que creaste tú nunca se tocan.

Con <code>autoUpdateQuests</code> en <code>false</code>, los archivos predeterminados solo se escriben cuando faltan.

{{Note|type=danger|title=Empezar de cero con los valores predeterminados|text=Para descartar los archivos de historia de tu mundo y empezar con los valores predeterminados actuales, usa <code>/dmzrestoreupdate</code>. '''Borra''' todo lo que hay en <code><world>/dragonminez/wishes</code>, <code>sagas</code> y <code>quests</code>, y luego ejecuta <code>/dmzreload all</code> para regenerarlos (las misiones secundarias no se tocan). Primero pide confirmación: haz clic en el botón o ejecuta <code>/dmzrestoreupdate confirm</code> en menos de 15 segundos.}}


== Flujo de trabajo práctico ==
# Edita tu archivo o archivos JSON.
# Valida la sintaxis del JSON (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
# Ejecuta el <code>/dmzreload <target></code> más acotado que cubra tu cambio: <code>config</code> para ediciones de balance, razas, formas e incursiones, <code>story</code> para ediciones de misiones, sagas y diálogos, <code>wishes</code> para ediciones de deseos.
# Revisa el log del servidor (o el informe de carga de JSON en el chat). Un mensaje <code>malformed JSON</code> significa que DMZ no pudo leer tu archivo: está usando los valores predeterminados de ese archivo y tu archivo quedó intacto. Arréglalo y vuelve a recargar.
# Para cambios en resource packs o datapacks, haz en su lugar una recarga de recursos del cliente o un <code>/reload</code> vanilla.

Si tienes dudas, <code>/dmzreload all</code> se puede ejecutar con seguridad en cualquier momento: simplemente vuelve a ejecutar todas las rutas de recarga y resincroniza a todos.

{{Navbox Configuration}}

Reloading and Updating Changes/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository