Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T01:10:05Z

Translation sync from dragonminez-wiki repository

New page

Los '''deseos personalizados''' cambian lo que concede un dragón al invocarlo, solo con JSON y sin Java. El JSON de los deseos está en dos lugares distintos, según lo que quieras hacer:

{| class="wikitable"
! Objetivo !! Dónde !! Formato
|-
| Reemplazar la lista de deseos de un dragón ([[Special:MyLanguage/Shenron|Shenron]], [[Special:MyLanguage/Porunga|Porunga]] o un dragón de un addon) en un mundo. || <code><world save>/dragonminez/wishes/<dragon_id>.json</code> || Un '''array''' JSON simple de objetos de deseo.
|-
| Distribuir un '''dragón nuevo''', o deseos como parte de un paquete distribuible. || Un paquete de addon (carpeta o <code>.zip</code>) en <code><game dir>/dragonballs/</code> || Un '''objeto''' JSON con los campos <code>dragon</code> y <code>wishes</code>.
|}

Ambos formatos usan por dentro los mismos objetos de deseo; solo cambia el contenedor exterior. Los datapacks normales '''no''' se leen para dragones ni deseos: usa un paquete de addon. Para ver cómo los jugadores invocan dragones y eligen deseos, consulta [[Special:MyLanguage/Dragons and Wishes|Dragones y deseos]].


== Cómo se combinan las listas de deseos ==
# Primero se cargan las listas de deseos de los paquetes de addon (una lista por dragón).
# Cada dragón conocido que no tenga lista recibe una vacía.
# Después, cada archivo de <code><world save>/dragonminez/wishes/</code> '''reemplaza''' la lista completa del dragón cuyo nombre lleva el archivo.


== Campos base de todo deseo ==

<syntaxhighlight lang="json">
{
"type": "attributes",
"name": "wish.shenron.attributes.name",
"description": "wish.shenron.attributes.desc",
"amount": 100
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>type</code> || Texto || Uno de los [[Special:MyLanguage/Custom Wishes#Wish types|tipos de deseo]] de abajo.
|-
| <code>name</code> || Texto || Clave de traducción del nombre que se muestra del deseo.
|-
| <code>description</code> || Texto || Clave de traducción de la descripción del deseo.
|-
| <code>repeatable</code> || Booleano || Opcional. Los dragones que conceden varios deseos (Porunga) permiten que un jugador elija el mismo deseo más de una vez por invocación. Ponlo en <code>false</code> para permitir el deseo una sola vez. Si no está, el deseo se puede repetir.
|}

Origen: <code>Wish.java</code> (clase base), <code>WishTypeAdapterFactory.java</code> (asignación de tipo a clase).


== Tipos de deseo ==

{| class="wikitable"
! <code>type</code> !! Campos extra !! Qué hace
|-
| <code>item_list_wish</code> || <code>items</code>: lista de objetos de ítem || Concede uno o más objetos descritos como objetos de ítem con tipo (ver abajo). Ejemplo: <code>{ "type": "item_list_wish", "name": "wish.shenron.senzu.name", "description": "wish.shenron.senzu.desc", "items": [{ "itemType": "generic_item", "itemId": "dragonminez:senzu_bean", "count": 16 }] }</code>
|-
| <code>item</code> || <code>itemId</code>, <code>count</code> || Concede una pila de objetos. Ejemplo: <code>{ "type": "item", "name": "...", "description": "...", "itemId": "dragonminez:senzu_bean", "count": 16 }</code>
|-
| <code>multi_wish</code> || <code>items</code>: lista de <code>{ "a": "<item_id>", "b": <count> }</code> || Concede varias pilas de objetos. Ejemplo: <code>{ "type": "multi_wish", "name": "...", "description": "...", "items": [{ "a": "dragonminez:kikono_shard", "b": 32 }, { "a": "minecraft:iron_ingot", "b": 64 }] }</code>
|-
| <code>attributes</code> || <code>amount</code> || Concede <code>amount</code> Atributos, repartidos entre Puntos de Atributo y los TP que esos puntos le costarían al jugador en ese momento (consulta [[Special:MyLanguage/Stats and Attributes|Estadísticas y atributos]]). Lo usan los deseos '''Aumento de Poder''' por defecto. Ejemplo: <code>{ "type": "attributes", "name": "...", "description": "...", "amount": 100 }</code>
|-
| <code>attributepoints</code> || <code>amount</code> || Concede solo <code>amount</code> Puntos de Atributo. Ejemplo: <code>{ "type": "attributepoints", "name": "...", "description": "...", "amount": 50 }</code>
|-
| <code>tps</code> || <code>amount</code> || Concede una cantidad fija de Puntos de Entrenamiento. Ejemplo: <code>{ "type": "tps", "name": "...", "description": "...", "amount": 5000 }</code>
|-
| <code>skill</code> || <code>skill</code>, <code>level</code> || Sube una habilidad al menos hasta <code>level</code>, por ejemplo <code>{ "type": "skill", "name": "...", "description": "...", "skill": "kaioken", "level": 2 }</code>. Se ignora si el jugador ya tiene ese nivel.
|-
| <code>command</code> || <code>commands</code>: array de textos, donde <code>%player%</code> se reemplaza por el nombre del jugador || Ejecuta comandos. Ejemplo: <code>{ "type": "command", "name": "...", "description": "...", "commands": ["effect give %player% minecraft:regeneration 60 1"] }</code>
|-
| <code>revive</code> || <code>maxTargets</code> (por defecto <code>1</code>) || Revive de verdad hasta <code>maxTargets</code> jugadores muertos, elegidos en la pantalla de deseos. Consulta [[Special:MyLanguage/Otherworld|Otro Mundo]].
|-
| <code>passivereset</code> || Ninguno || Reinicia las bonificaciones de las habilidades pasivas raciales (Zenkai, Asimilación y Absorción).
|-
| <code>recustomize</code> || Ninguno || Abre la pantalla de personalización del personaje.
|-
| <code>relocatestats</code> || Ninguno || Permite al jugador redistribuir los puntos de estadísticas que gastó.
|-
| <code>changedifficulty</code> || Ninguno || Permite al jugador volver a elegir la dificultad de la historia.
|-
| <code>resetstory</code> || Ninguno || Reinicia todo el progreso de las misiones de la historia.
|}

<code>item_list_wish</code> es el tipo que usan los deseos por defecto. Cada entrada de <code>items</code> es un objeto de ítem con tipo, así que un deseo también puede conceder equipo encantado, pociones o armaduras con adornos:

<syntaxhighlight lang="json">
{
"type": "item_list_wish",
"name": "wish.shenron.strongest.name",
"description": "wish.shenron.strongest.desc",
"items": [
{ "itemType": "enchanted_item", "itemId": "minecraft:diamond_sword", "count": 1, "enchantments": { "minecraft:sharpness": 5 } },
{ "itemType": "potion", "itemId": "minecraft:potion", "count": 1, "potion": "minecraft:strong_healing" }
]
}
</syntaxhighlight>

Los campos de cada objeto de ítem (<code>generic_item</code>, <code>enchanted_item</code>, <code>enchanted_book</code>, <code>potion</code>, <code>splash_potion</code>, <code>lingering_potion</code>, <code>tipped_arrow</code>, <code>trimmed_armor</code>) están en [[Special:MyLanguage/Custom Quests#Item objects|Misiones personalizadas]].

Origen: las clases de <code>src/main/java/com/dragonminez/common/wish/wishes/</code> y la tabla de despacho de <code>WishTypeAdapterFactory.java</code>.


== Reemplazar los deseos de un dragón ==
Coloca un archivo con el id del dragón como nombre en <code><world save>/dragonminez/wishes/</code>, por ejemplo <code>shenron.json</code> o <code>porunga.json</code>. Es un '''array simple''', sin objeto contenedor:

<syntaxhighlight lang="json">
[
{
"type": "item_list_wish",
"name": "wish.shenron.senzu.name",
"description": "wish.shenron.senzu.desc",
"items": [ { "itemType": "generic_item", "itemId": "dragonminez:senzu_bean", "count": 16 } ]
},
{
"type": "attributes",
"name": "wish.shenron.attributes.name",
"description": "wish.shenron.attributes.desc",
"amount": 100
},
{
"type": "revive",
"name": "wish.shenron.revive.name",
"description": "wish.shenron.revive.desc",
"maxTargets": 3
}
]
</syntaxhighlight>

{{Note|type=warning|title=El archivo reemplaza toda la lista|text=Este archivo '''reemplaza por completo''' la lista de deseos de ese dragón; no se suma a los deseos de los paquetes de addon. Si solo quieres añadir un deseo y conservar el resto, primero copia la lista de deseos completa actual del dragón y luego añade el tuyo.}}

Si <code>shenron.json</code> o <code>porunga.json</code> todavía no existen, DragonMineZ los crea con la lista de deseos por defecto la primera vez que se cargan los deseos, así siempre tienes un ejemplo funcional para empezar. Cualquier otro nombre de archivo que crees aquí define la lista de deseos de ese id de dragón; solo aparece si existe un dragón con ese id (consulta [[Special:MyLanguage/Custom Wishes#Adding a new dragon|Añadir un dragón nuevo]]).

Cada deseo se comprueba al cargar el archivo: un <code>type</code> desconocido o una clave desconocida se informa en el reporte de carga de JSON. Un archivo que no se puede analizar (JSON roto, un objeto de ítem no válido) se omite entero y se informa, así que el dragón conserva los deseos de su paquete de addon hasta que lo corrijas.

Origen: <code>WishManager.loadWishes()</code> y <code>loadWishConfig()</code>.


== Añadir un dragón nuevo ==
Un archivo de reemplazo de deseos por sí solo únicamente funciona para un id de dragón que ya tenga una '''definición de dragón''' (entidad, conjunto de esferas y reglas de invocación). Un dragón, conjunto de esferas o radar nuevo viene de un paquete de addon en <code><game dir>/dragonballs/</code>: una carpeta o un archivo <code>.zip</code> con esta estructura:

<syntaxhighlight lang="text">
<pack_name>/
definitions/
dragon.json
ballset.json
radar.json
wishes.json
assets/
dragon.json
ballset.json
radar.json
</syntaxhighlight>

Los paquetes se cargan en orden alfabético y se combinan por id sobre las definiciones incluidas: un paquete cuyo <code>dragon.json</code> usa un id de dragón existente sobrescribe la definición de ese dragón. Los dragones, conjuntos de esferas y radares registran su entidad, bloques y objetos al iniciar el juego, así que '''los nuevos necesitan reiniciar el juego'''. Consulta [[Special:MyLanguage/Locating Specific Folders|Encontrar carpetas]] para ver el mapa completo de carpetas.


=== Definición del dragón ===
<code>definitions/dragon.json</code>:

<syntaxhighlight lang="json">
{
"id": "my_dragon",
"entity_registry_name": "my_dragon",
"entity_width": 3.0,
"entity_height": 17.0,
"dimensions": ["minecraft:overworld"],
"ball_set": "my_ball_set",
"wish_screen_id": "my_dragon",
"wish_count": 1,
"asset_definition": "my_dragon"
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Qué hace
|-
| <code>id</code> || Id del dragón.
|-
| <code>entity_registry_name</code> || Nombre de registro de la entidad del dragón (<code>dragonminez:<name></code>). Mantenlo igual a <code>id</code>: la invocación busca la entidad por el id del dragón.
|-
| <code>entity_width</code>, <code>entity_height</code> || Tamaño de la entidad.
|-
| <code>dimensions</code> || Dimensiones en las que se puede invocar al dragón.
|-
| <code>ball_set</code> || Id del conjunto de esferas que lo invoca.
|-
| <code>wish_screen_id</code> || Id de la lista de deseos que ofrece el dragón (el valor <code>dragon</code> en <code>wishes.json</code> y el nombre de archivo de un reemplazo por mundo).
|-
| <code>wish_count</code> || Cuántos deseos se conceden por invocación.
|-
| <code>asset_definition</code> || Id opcional de una entrada de <code>assets/dragon.json</code> (<code>id</code>, <code>renderer_type</code>, <code>model</code>, <code>texture</code>, <code>animation</code>).
|}


=== Definición del conjunto de esferas ===
<code>definitions/ballset.json</code> acepta estas claves: <code>id</code>, <code>dimensions</code>, <code>copies</code> (por defecto <code>5</code>), <code>spawn_range</code>, <code>summon_radius</code> (qué tan cerca deben estar las demás esferas de la que haces clic derecho), <code>blocks</code> (número de estrellas a nombre de registro del bloque), <code>asset_definition</code>, <code>display_name</code> y <code>natural_spawn</code> (opcional, por defecto <code>true</code>).
* Un conjunto está completo cuando '''todas las estrellas listadas en <code>blocks</code>''' están colocadas dentro de <code>summon_radius</code>, así que un conjunto no tiene por qué tener siete esferas.
* Con <code>"natural_spawn": false</code>, las esferas del conjunto nunca se reparten por el mundo (ni al crear el mundo, ni después de un deseo, ni con <code>/dmzdragonballs</code>): solo existen si las entregas tú, por ejemplo como recompensas de misiones o de jefes de mundo.


=== Definición del radar ===
<code>definitions/radar.json</code> acepta estas claves: <code>id</code>, <code>item_registry_name</code>, <code>dimensions</code>, <code>ball_set</code>, <code>tooltip_key</code>, <code>ranges</code>, <code>recipe_definition</code>, <code>chip_item</code>, <code>cpu_item</code>, <code>chip_model_item</code>, <code>cpu_model_item</code>, <code>asset_definition</code> y <code>display_name</code>. Un radar con <code>chip_item</code> y <code>cpu_item</code> y sin <code>recipe_definition</code> recibe una receta de fabricación con esos dos objetos. Consulta [[Special:MyLanguage/Dragon Radar|Radar del Dragón]] para ver el radar incluido.


=== Lista de deseos del paquete ===
<code>definitions/wishes.json</code> usa un objeto contenedor. Es el formato de paquete de addon, distinto del formato de array por mundo de arriba:

<syntaxhighlight lang="json">
{
"dragon": "my_dragon",
"wishes": [
{ "type": "tps", "name": "wish.my_dragon.tps.name", "description": "wish.my_dragon.tps.desc", "amount": 5000 }
]
}
</syntaxhighlight>

Cada clave de estos archivos se comprueba contra las listas de arriba, y las claves desconocidas se informan en el reporte de carga de JSON.

Origen: <code>DragonBallPackManager.java</code>, <code>DragonDefinition.java</code>, <code>DragonBallSetDefinition.java</code>, <code>DragonRadarDefinition.java</code>, <code>DragonWishRegistry.java</code>.


== Claves de traducción ==
La convención es <code>wish.<dragon_id>.<wish_key>.name</code> / <code>wish.<dragon_id>.<wish_key>.desc</code>, por ejemplo <code>wish.shenron.senzu.name</code>. Añade estas claves a tu <code>en_us.json</code> o a tu propio archivo de idioma. Las traducciones personalizadas se combinan con las de Crowdin igual que en las [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|razas personalizadas]].


== Recargar y validar ==
# Guarda tus archivos de reemplazo de deseos en <code><world save>/dragonminez/wishes/</code>, o tu paquete de addon en <code><game dir>/dragonballs/</code>.
# Valida la sintaxis JSON (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
# Para los reemplazos por mundo, ejecuta <code>/dmzreload wishes</code> (o <code>/dmzreload all</code>); consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]. Las listas de deseos de los paquetes de addon se vuelven a leer con el <code>/reload</code> de vanilla; después ejecuta <code>/dmzreload wishes</code> para que los reemplazos por mundo se vuelvan a aplicar encima. Los dragones, conjuntos de esferas y radares nuevos necesitan un reinicio completo.
# Invoca al dragón en el juego y comprueba que la lista de deseos sea la que esperas.

{{Navbox Modding}}

Custom Wishes/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository