Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T09:12:22Z

Translation sync from dragonminez-wiki repository

New page

Lee esta página antes de empezar a editar cualquier cosa en <code>config/dragonminez</code> o en la carpeta de guardado <code>dragonminez/</code> de un mundo en un servidor en funcionamiento. Explica de qué hace copia de seguridad DragonMineZ por ti y de qué no, cómo tratan tus archivos las actualizaciones y qué tener en cuenta en un servidor multijugador.


== Haz una copia de seguridad antes de tocar nada ==
{{See also|How to JSON|Locating Specific Folders}}
DMZ guarda por su cuenta una copia de los archivos que modifica:

* Los archivos de configuración que actualiza tras una actualización de DMZ se mueven a <code>config/dragonminez/oldBackup/<same path></code> antes de escribir el archivo nuevo (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
* Los archivos predeterminados de misiones, sagas y misiones secundarias que actualiza se copian primero a <code><world>/dragonminez/oldBackup/<same path></code> (consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]).
* Los archivos que no puede leer nunca se sobrescriben: DMZ usa los valores predeterminados durante esa sesión y no toca tu archivo.

Esa red de seguridad '''no''' cubre:

* Tus propias ediciones entre dos versiones de DMZ. <code>oldBackup/</code> solo guarda la versión de justo antes de una actualización.
* <code>/dmzrestoreupdate</code>, que '''borra''' las carpetas <code>wishes</code>, <code>sagas</code> y <code>quests</code> del mundo (incluidos tus archivos personalizados) y regenera los valores predeterminados.
* Los datos de los jugadores: <code>playerdata_json/<uuid>.json</code> si usas el almacenamiento <code>JSON</code>, tu base de datos si usas el almacenamiento <code>DATABASE</code>, y los archivos <code>.dat</code> vanilla de los jugadores.
* Los datos guardados del mundo en <code><world>/data/</code> (posiciones de las Esferas del Dragón, grupos, incursiones, jefes de mundo y más).

{{Note|type=danger|title=Haz tu propia copia de seguridad|text=Haz tu propia copia de seguridad de los archivos o de la base de datos antes de editar en masa cualquiera de estos, sobre todo en un servidor con datos de jugadores reales.}}


== Para quién son estas páginas ==
{{See also|Developer Scope and Prerequisites|Modding}}
Las páginas de configuración y de contenido propio de esta wiki están escritas para personas que se sienten cómodas editando JSON, usando un entorno de desarrollo o creando un addon de Forge. A propósito, no explican el lore ni la historia, ni el alojamiento o la administración de servidores fuera del propio DMZ (puertos, proxies, etc.). Para jugar el mod, empieza por la [[Special:MyLanguage/Beginner's Guide|Guía para empezar]].


== Nunca confíes en datos del cliente para la progresión ==
{{See also|Add-on Development}}
Si estás escribiendo un addon o un mixin para DMZ: las estadísticas, los desbloqueos, los permisos, las misiones y los deseos se validan en el servidor por diseño. No crees funciones de addons que confíen en un valor informado por el cliente para nada relacionado con la progresión; lee el estado desde <code>StatsCapability</code> / <code>StatsProvider</code> en el servidor en lugar de una caché del cliente.


== Los archivos de configuración se actualizan con las actualizaciones de DMZ ==
{{See also|How to JSON|Reloading and Updating Changes}}
Cada archivo de configuración lleva un <code>configVersion</code>. Cuando instalas una versión más nueva de DMZ, los archivos desactualizados se regeneran con los nuevos valores predeterminados y los valores que cambiaste se vuelven a combinar (los valores que nunca tocaste adoptan los nuevos predeterminados). Es el comportamiento esperado, no un bug: consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]] para ver exactamente cómo funciona la combinación, y compara con la copia de <code>oldBackup/</code> si un valor parece incorrecto tras una actualización.

Un archivo con un error de sintaxis '''no''' se regenera: DMZ usa los valores predeterminados de ese archivo hasta que lo arregles y ejecutes <code>/dmzreload</code>. Cada jugador ve en el chat, al conectarse, un breve informe de los archivos rotos (puedes desactivarlo con <code>developer.reportJsonProblemsInChat</code> en [[Special:MyLanguage/General Server Config|Configuración del servidor]]).


== El contenido personalizado y de la comunidad sobrevive a las actualizaciones ==
* Las razas personalizadas conservan todos sus valores entre actualizaciones; los archivos de formas personalizadas conservan su contenido; los archivos extra de incursiones y torneos, y las misiones y sagas personalizadas que crees, se cargan tal como están.
* Los archivos de configuración e historia predeterminados de DMZ se actualizan cuando DMZ los cambia, pero se conservan los valores que editaste. Si quieres que un cambio sea totalmente independiente de los valores predeterminados de DMZ, cópialo a tu propia raza, forma o saga personalizada en lugar de editar los archivos de DMZ (consulta [[Special:MyLanguage/Custom Races|Razas personalizadas]], [[Special:MyLanguage/Custom Forms|Formas personalizadas]] y [[Special:MyLanguage/Custom Quests|Misiones personalizadas]]).
* Pon <code>autoUpdateQuests</code> en <code>false</code> en [[Special:MyLanguage/General Server Config|Configuración del servidor]] si nunca quieres que DMZ toque los archivos de misiones predeterminados de un mundo una vez que existan.


== Consideraciones para multijugador y servidores grandes ==
* El servidor envía sus archivos de configuración a cada jugador al conectarse. Después de editar un archivo de configuración, ejecuta siempre <code>/dmzreload config</code>: hasta que lo hagas, el servidor mantiene los valores viejos mientras que los jugadores que se conectan reciben el archivo editado. La recarga vuelve a enviar todos los archivos a cada jugador conectado, así que espera un breve tirón en servidores grandes.
* Las ediciones de misiones, sagas y diálogos solo surten efecto en un mundo después de <code>/dmzreload story</code> (o de un reinicio).
* No cambies de backend de almacenamiento (<code>NBT</code>, <code>JSON</code>, <code>DATABASE</code>) con jugadores conectados: hazlo con el servidor vacío y haz una copia de seguridad antes. El guardado vanilla <code>.dat</code> del jugador siempre se escribe también, así que sigue siendo un respaldo si no se puede acceder a la base de datos.


== Cómo obtener ayuda ==
* Pregunta en el [https://discord.com/servers/dragonmine-z-1216429657273012415 Discord de DragonMineZ].
* Reporta bugs a nivel del motor o pide funciones en el [https://github.com/orgs/DragonMineZ/projects/4 tablero de progreso] de GitHub.

{{Navbox Configuration}}

Notice to Server Owners/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository