Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T11:46:38Z

Translation sync from dragonminez-wiki repository

New page

'''Atributos de armas''' es un sistema de datapacks que le dice al motor de combate de DragonMineZ cómo se comporta un objeto concreto en combate: alcance de ataque, animación, forma del hitbox, multiplicadores de daño, variantes de ataque condicionales (empuñar dos armas, agacharse, ir montado, etc.) y estadísticas críticas. Los mods de armas de terceros se conectan a este sistema para tener un comportamiento de combate de DragonMineZ adecuado.

Cargador: <code>WeaponRegistry.loadAttributes(resourceManager)</code>, en <code>src/main/java/com/dragonminez/common/combat/logic/weapon/WeaponRegistry.java</code>. Se recarga con la recarga de datapacks de vanilla (<code>/reload</code> o un reinicio), '''no''' con <code>/dmzreload</code>.


== Ubicación del archivo y asignación al objeto ==

<syntaxhighlight lang="text">
data/<namespace>/weapon_attributes/<item_path>.json
</syntaxhighlight>

El namespace y la ruta forman el id del objeto de destino: <code>data/dragonminez/weapon_attributes/axe.json</code> se aplica a <code>dragonminez:axe</code>. Un mod de terceros define sus propias armas en su propio namespace, por ejemplo <code>data/mymod/weapon_attributes/great_axe.json</code> para <code>mymod:great_axe</code>.

{{Note|title=Datapacks de Better Combat|text=Cualquier namespace <code>bettercombat:</code> que aparezca en estos archivos JSON se reescribe como <code>dragonminez:</code> al cargarse, así que los datapacks de atributos de armas escritos para el mod Better Combat funcionan casi siempre tal cual.}}


== Esquema de nivel superior ==
Un archivo contiene un objeto <code>attributes</code>:

<syntaxhighlight lang="text">
{
"attributes": { ... }
}
</syntaxhighlight>

O bien, para heredar los atributos de otro objeto y sobrescribir solo algunos campos, indica un <code>parent</code>:

<syntaxhighlight lang="json">
{
"parent": "dragonminez:sword",
"attributes": {
"crit_chance": 0.10,
"crit_damage": 0.15
}
}
</syntaxhighlight>

Las cadenas de <code>parent</code> pueden tener varios niveles (un padre puede tener su propio padre). Los ciclos se detectan: un arma cuya cadena de padres vuelve sobre sí misma no se puede resolver y se omite (se registra como error), así que revisa bien tus referencias de <code>parent</code>.


== Campos de los atributos ==
{{Config|Combat Config|fallbackCompatibility}}

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>attack_range</code> || Número || Alcance en bloques (el valor por defecto de Minecraft, <code>3.0</code>, si se omite).
|-
| <code>pose</code> || Texto || Pose de animación de GeckoLib para el arma de la mano principal.
|-
| <code>off_hand_pose</code> || Texto || Pose de animación de GeckoLib para el arma de la mano secundaria.
|-
| <code>two_handed</code> || Booleano || Si es <code>true</code>, no se puede usar la mano secundaria mientras se empuña el arma.
|-
| <code>category</code> || Texto || Etiqueta de categoría libre. Se usa para dos cosas: para comparar las condiciones <code>DUAL_WIELDING_SAME_CATEGORY</code> entre la mano principal y la secundaria, '''y''' como categoría de destino del sistema de regex <code>fallbackCompatibility</code> de [[Special:MyLanguage/Combat Config|Configuración de combate]].
|-
| <code>crit_chance</code> || Número || Probabilidad crítica innata (<code>0.0</code>–<code>1.0</code>), aplicada como modificador de atributo.
|-
| <code>crit_damage</code> || Número || Multiplicador de daño crítico innato, aplicado como modificador de atributo.
|-
| <code>attacks</code> || Array || '''Obligatorio.''' Una o más variantes de ataque (ver abajo).
|}


== Entradas de ataque ==
Cada entrada de <code>attacks</code> describe una variante de golpe. DragonMineZ revisa las <code>conditions</code> de arriba abajo y usa el primer ataque cuyas condiciones se cumplen todas.

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>conditions</code> || Lista de textos de condición || Todas deben cumplirse para que se active esta variante. Omítelo para un ataque sin condiciones.
|-
| <code>hitbox</code> || Texto || <code>FORWARD_BOX</code> (una caja que se extiende hacia delante, lo más parecido a vanilla), <code>VERTICAL_PLANE</code> (un tajo vertical de barrido) o <code>HORIZONTAL_PLANE</code> (un barrido horizontal amplio).
|-
| <code>damage_multiplier</code> || Número || Multiplicador del daño base del arma (por defecto <code>1.0</code>).
|-
| <code>angle</code> || Número || Arco del golpe en grados.
|-
| <code>upswing</code> || Número || Multiplicador del tiempo de recarga: <code>cooldownTicks = (1 / (4 - attackSpeed)) * 20 * upswing</code>. Un valor menor significa un golpe siguiente más rápido. También define la '''preparación''' del golpe (el retraso antes de que impacte): ticks de animación × <code>upswing</code> × 0.95, limitado a 3–7 ticks.
|-
| <code>animation</code> || Texto || Nombre de animación de GeckoLib. Se compara con <code>animations/*.json</code>; si no hay una coincidencia exacta, DragonMineZ elige el nombre más parecido (distancia de Levenshtein) después de quitar los prefijos conocidos (<code>dragonminez:</code>, <code>bettercombat:</code>, <code>combat.</code>).
|-
| <code>swing_sound</code> / <code>impact_sound</code> || <code>{ "id", "volume"*, "pitch"*, "randomness"* }</code> || Sonido que se reproduce al golpear o al impactar. <code>volume</code> y <code>pitch</code> valen <code>1.0</code> por defecto, y <code>randomness</code>, <code>0.1</code>.
|}


=== Condiciones de ataque ===
Esta es la lista completa de condiciones:

{| class="wikitable"
! Condición !! Significado
|-
| <code>NOT_DUAL_WIELDING</code> || La mano secundaria está vacía (aire).
|-
| <code>DUAL_WIELDING_ANY</code> || Ambas manos sostienen algo.
|-
| <code>DUAL_WIELDING_SAME</code> || Ambas manos sostienen exactamente el mismo id de objeto.
|-
| <code>DUAL_WIELDING_SAME_CATEGORY</code> || Ambas manos sostienen objetos que comparten la misma <code>category</code>.
|-
| <code>NO_OFFHAND_ITEM</code> || La mano secundaria está vacía.
|-
| <code>OFF_HAND_SHIELD</code> || La mano secundaria sostiene un escudo.
|-
| <code>MAIN_HAND_ONLY</code> || El ataque solo se aplica al arma de la mano principal.
|-
| <code>OFF_HAND_ONLY</code> || El ataque solo se aplica al arma de la mano secundaria.
|-
| <code>MOUNTED</code> || El jugador va montado en una entidad.
|-
| <code>NOT_MOUNTED</code> || El jugador no va montado.
|-
| <code>SNEAKING</code> || El jugador está agachado.
|-
| <code>NOT_SNEAKING</code> || El jugador está de pie.
|}


== Ejemplo completo ==
Una daga con varios ataques y una variante para empuñar dos armas:

<syntaxhighlight lang="json">
{
"attributes": {
"attack_range": 2,
"two_handed": false,
"category": "dagger",
"attacks": [
{
"hitbox": "HORIZONTAL_PLANE",
"damage_multiplier": 0.8,
"angle": 150,
"upswing": 0.5,
"animation": "combat.one_handed_slash_horizontal_right_1",
"swing_sound": { "id": "dragonminez:dagger_slash" }
},
{
"hitbox": "HORIZONTAL_PLANE",
"damage_multiplier": 0.8,
"angle": 150,
"upswing": 0.5,
"animation": "combat.one_handed_slash_horizontal_right_2",
"swing_sound": { "id": "dragonminez:dagger_slash" }
},
{
"conditions": ["DUAL_WIELDING_SAME_CATEGORY", "MAIN_HAND_ONLY"],
"hitbox": "FORWARD_BOX",
"damage_multiplier": 1.4,
"angle": 150,
"upswing": 0.5,
"animation": "combat.dual_handed_stab",
"swing_sound": { "id": "dragonminez:dagger_slash" }
}
]
}
}
</syntaxhighlight>

Un ejemplo de herencia (<code>brave_sword.json</code>, que solo sobrescribe las estadísticas críticas):

<syntaxhighlight lang="json">
{
"parent": "dragonminez:sword",
"attributes": {
"crit_chance": 0.10,
"crit_damage": 0.15
}
}
</syntaxhighlight>


== Archivos de atributos incluidos ==
{{See also|Special Weapons}}
DragonMineZ incluye estas entradas en <code>data/dragonminez/weapon_attributes/</code>, así que puedes usarlas como <code>parent</code> o como destino de <code>weaponCombo</code> o del sistema de respaldo:
* '''Combos base:''' <code>anchor</code>, <code>axe</code>, <code>battlestaff</code>, <code>claw</code>, <code>claymore</code>, <code>cutlass</code>, <code>dagger</code>, <code>double_axe</code>, <code>fist</code>, <code>giant</code>, <code>glaive</code>, <code>halberd</code>, <code>hammer</code>, <code>katana</code>, <code>lance</code>, <code>mace</code>, <code>pickaxe</code>, <code>rapier</code>, <code>scythe</code>, <code>sickle</code>, <code>soul_knife</code>, <code>spear</code>, <code>staff</code>, <code>sword</code>, <code>trident</code>, <code>twin_blade</code>, <code>wand</code>.
* '''Armas características:''' <code>brave_sword</code> ([[Special:MyLanguage/Brave Sword|Espada Valiente]], padre <code>sword</code>), <code>yajirobe_katana</code> ([[Special:MyLanguage/Yajirobe's Katana|Katana de Yajirobe]], padre <code>katana</code>), <code>z_sword</code> ([[Special:MyLanguage/Z Sword|Espada Z]], padre <code>claymore</code>) y <code>power_pole</code> ([[Special:MyLanguage/Power Pole|Bastón Mágico]], padre <code>staff</code>, con su propio combo de tres golpes).

Los objetos de DragonMineZ que no tienen una entrada propia (por ejemplo la [[Special:MyLanguage/Dimension Sword|Espada Dimensional]] y las armas de Tamagami: [[Special:MyLanguage/Tamagami Sword|Espada de Tamagami]], [[Special:MyLanguage/Tamagami Trident|Tridente de Tamagami]] y [[Special:MyLanguage/Tamagami Hammer|Martillo de Tamagami]]) obtienen su combo de las regex de <code>fallbackCompatibility</code> de [[Special:MyLanguage/Combat Config|Configuración de combate]], igual que las armas de terceros.


== Para mods de armas de terceros ==
Si tu mod añade armas y no incluyes una entrada de Atributos de armas para ellas, DragonMineZ recurre a comparar el id de cada objeto con un modificador de daño de ataque con la lista <code>fallbackCompatibility</code> de [[Special:MyLanguage/Combat Config|Configuración de combate]] (por ejemplo, un id de objeto que contiene <code>axe</code> se trata como <code>dragonminez:axe</code>). Esto da un valor por defecto razonable, pero una entrada de datapack real que coincida con el combo y las animaciones reales de tu arma siempre es más precisa, y siempre tiene prioridad sobre la suposición del sistema de respaldo.


== Recargar y validar ==
# Añade o edita archivos en <code>data/<namespace>/weapon_attributes/</code>.
# Valida la sintaxis JSON (consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]]).
# Ejecuta el <code>/reload</code> de vanilla o reinicia. Es un listener de recarga de datapacks normal, no forma parte de <code>/dmzreload</code> (consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]).
# Prueba el arma en el juego: alcance, animación, forma del hitbox y cualquier variante condicional (empuñar dos armas, agacharse, ir montado).

{{Navbox Modding}}

Weapon Attributes/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository