Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T11:48:44Z

Translation sync from dragonminez-wiki repository

New page

'''Atributos de armas''' é um sistema de datapacks que diz ao motor de combate do DragonMineZ como um item específico se comporta em combate: alcance de ataque, animação, formato da hitbox, multiplicadores de dano, variantes de ataque condicionais (empunhar duas armas, agachar, estar montado etc.) e estatísticas críticas. Mods de armas de terceiros se conectam a esse sistema para ter um comportamento de combate do DragonMineZ adequado.

Carregador: <code>WeaponRegistry.loadAttributes(resourceManager)</code>, em <code>src/main/java/com/dragonminez/common/combat/logic/weapon/WeaponRegistry.java</code>. Ele é recarregado com a recarga de datapacks do vanilla (<code>/reload</code> ou uma reinicialização), '''não''' com <code>/dmzreload</code>.


== Local do arquivo e mapeamento para o item ==

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

O namespace e o caminho formam o id do item de destino: <code>data/dragonminez/weapon_attributes/axe.json</code> se aplica a <code>dragonminez:axe</code>. Um mod de terceiros define suas próprias armas no seu próprio namespace, por exemplo <code>data/mymod/weapon_attributes/great_axe.json</code> para <code>mymod:great_axe</code>.

{{Note|title=Datapacks do Better Combat|text=Qualquer namespace <code>bettercombat:</code> encontrado nestes arquivos JSON é reescrito como <code>dragonminez:</code> no carregamento, então os datapacks de atributos de armas feitos para o mod Better Combat funcionam quase sempre como estão.}}


== Esquema de nível superior ==
Um arquivo contém um objeto <code>attributes</code>:

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

Ou, para herdar os atributos de outro item e sobrescrever só alguns campos, ele indica um <code>parent</code>:

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

As cadeias de <code>parent</code> podem ter vários níveis (um pai pode ter seu próprio pai). Ciclos são detectados: uma arma cuja cadeia de pais volta para ela mesma não pode ser resolvida e é ignorada (registrada como erro), então confira bem suas referências de <code>parent</code>.


== Campos dos atributos ==
{{Config|Combat Config|fallbackCompatibility}}

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>attack_range</code> || Número || Alcance em blocos (o padrão do Minecraft, <code>3.0</code>, se for omitido).
|-
| <code>pose</code> || Texto || Pose de animação do GeckoLib para a arma da mão principal.
|-
| <code>off_hand_pose</code> || Texto || Pose de animação do GeckoLib para a arma da mão secundária.
|-
| <code>two_handed</code> || Booleano || Se for <code>true</code>, a mão secundária não pode ser usada enquanto a arma estiver empunhada.
|-
| <code>category</code> || Texto || Etiqueta de categoria livre. É usada para duas coisas: comparar as condições <code>DUAL_WIELDING_SAME_CATEGORY</code> entre a mão principal e a secundária, '''e''' como categoria de destino do sistema de regex <code>fallbackCompatibility</code> em [[Special:MyLanguage/Combat Config|Configuração de combate]].
|-
| <code>crit_chance</code> || Número || Chance crítica inata (<code>0.0</code>–<code>1.0</code>), aplicada como modificador de atributo.
|-
| <code>crit_damage</code> || Número || Multiplicador de dano crítico inato, aplicado como modificador de atributo.
|-
| <code>attacks</code> || Array || '''Obrigatório.''' Uma ou mais variantes de ataque (veja abaixo).
|}


== Entradas de ataque ==
Cada entrada de <code>attacks</code> descreve uma variante de golpe. O DragonMineZ verifica as <code>conditions</code> de cima para baixo e usa o primeiro ataque cujas condições são todas atendidas.

{| class="wikitable"
! Campo !! Tipo !! O que faz
|-
| <code>conditions</code> || Lista de textos de condição || Todas precisam ser verdadeiras para que esta variante seja usada. Omita para um ataque sem condições.
|-
| <code>hitbox</code> || Texto || <code>FORWARD_BOX</code> (uma caixa que se estende para a frente, o mais próximo do vanilla), <code>VERTICAL_PLANE</code> (um corte vertical de varredura) ou <code>HORIZONTAL_PLANE</code> (uma varredura horizontal ampla).
|-
| <code>damage_multiplier</code> || Número || Multiplicador do dano base da arma (padrão <code>1.0</code>).
|-
| <code>angle</code> || Número || Arco do golpe em graus.
|-
| <code>upswing</code> || Número || Multiplicador da recarga: <code>cooldownTicks = (1 / (4 - attackSpeed)) * 20 * upswing</code>. Um valor menor significa um golpe seguinte mais rápido. Também define a '''preparação''' do golpe (o atraso antes de o golpe acertar): ticks de animação × <code>upswing</code> × 0.95, limitado a 3–7 ticks.
|-
| <code>animation</code> || Texto || Nome de animação do GeckoLib. É comparado com <code>animations/*.json</code>; se não houver correspondência exata, o DragonMineZ escolhe o nome mais parecido (distância de Levenshtein) depois de remover os prefixos conhecidos (<code>dragonminez:</code>, <code>bettercombat:</code>, <code>combat.</code>).
|-
| <code>swing_sound</code> / <code>impact_sound</code> || <code>{ "id", "volume"*, "pitch"*, "randomness"* }</code> || Som reproduzido ao golpear ou no impacto. <code>volume</code> e <code>pitch</code> valem <code>1.0</code> por padrão, e <code>randomness</code>, <code>0.1</code>.
|}


=== Condições de ataque ===
Esta é a lista completa de condições:

{| class="wikitable"
! Condição !! Significado
|-
| <code>NOT_DUAL_WIELDING</code> || A mão secundária está vazia (ar).
|-
| <code>DUAL_WIELDING_ANY</code> || As duas mãos seguram algo.
|-
| <code>DUAL_WIELDING_SAME</code> || As duas mãos seguram exatamente o mesmo id de item.
|-
| <code>DUAL_WIELDING_SAME_CATEGORY</code> || As duas mãos seguram itens que compartilham a mesma <code>category</code>.
|-
| <code>NO_OFFHAND_ITEM</code> || A mão secundária está vazia.
|-
| <code>OFF_HAND_SHIELD</code> || A mão secundária segura um escudo.
|-
| <code>MAIN_HAND_ONLY</code> || O ataque só se aplica à arma da mão principal.
|-
| <code>OFF_HAND_ONLY</code> || O ataque só se aplica à arma da mão secundária.
|-
| <code>MOUNTED</code> || O jogador está montado em uma entidade.
|-
| <code>NOT_MOUNTED</code> || O jogador não está montado.
|-
| <code>SNEAKING</code> || O jogador está agachado.
|-
| <code>NOT_SNEAKING</code> || O jogador está de pé.
|}


== Exemplo completo ==
Uma adaga com vários ataques e uma variante para empunhar duas 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>

Um exemplo de herança (<code>brave_sword.json</code>, que só sobrescreve as estatísticas críticas):

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


== Arquivos de atributos incluídos ==
{{See also|Special Weapons}}
O DragonMineZ inclui estas entradas em <code>data/dragonminez/weapon_attributes/</code>, então você pode usá-las como <code>parent</code> ou como destino de <code>weaponCombo</code> ou do sistema de fallback:
* '''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 Valente]], pai <code>sword</code>), <code>yajirobe_katana</code> ([[Special:MyLanguage/Yajirobe's Katana|Katana do Yajirobe]], pai <code>katana</code>), <code>z_sword</code> ([[Special:MyLanguage/Z Sword|Espada Z]], pai <code>claymore</code>) e <code>power_pole</code> ([[Special:MyLanguage/Power Pole|Bastão Mágico]], pai <code>staff</code>, com seu próprio combo de três golpes).

Os itens do DragonMineZ que não têm uma entrada própria (por exemplo a [[Special:MyLanguage/Dimension Sword|Espada Dimensional]] e as armas de Tamagami: [[Special:MyLanguage/Tamagami Sword|Espada de Tamagami]], [[Special:MyLanguage/Tamagami Trident|Tridente de Tamagami]] e [[Special:MyLanguage/Tamagami Hammer|Martelo de Tamagami]]) recebem seu combo das regex de <code>fallbackCompatibility</code> em [[Special:MyLanguage/Combat Config|Configuração de combate]], assim como as armas de terceiros.


== Para mods de armas de terceiros ==
Se o seu mod adiciona armas e você não inclui uma entrada de Atributos de armas para elas, o DragonMineZ passa a comparar o id de todo item com modificador de dano de ataque com a lista <code>fallbackCompatibility</code> em [[Special:MyLanguage/Combat Config|Configuração de combate]] (por exemplo, um id de item que contém <code>axe</code> é tratado como <code>dragonminez:axe</code>). Isso dá um padrão razoável, mas uma entrada de datapack de verdade que corresponda ao combo e às animações reais da sua arma é sempre mais precisa, e sempre tem prioridade sobre o palpite do fallback.


== Recarregar e validar ==
# Adicione ou edite arquivos em <code>data/<namespace>/weapon_attributes/</code>.
# Valide a sintaxe JSON (veja [[Special:MyLanguage/How to JSON|Como usar JSON]]).
# Execute o <code>/reload</code> do vanilla ou reinicie. É um listener de recarga de datapacks comum, não faz parte do <code>/dmzreload</code> (veja [[Special:MyLanguage/Reloading and Updating Changes|Recarregar e atualizar mudanças]]).
# Teste a arma no jogo: alcance, animação, formato da hitbox e quaisquer variantes condicionais (empunhar duas armas, agachar, estar montado).

{{Navbox Modding}}

Weapon Attributes/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository