Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T00:05:48Z

Translation sync from dragonminez-wiki repository

New page

Os '''modelos e recursos próprios''' permitem que raças e formas usem sua própria geometria, texturas de corpo e rostos. Você não precisa criar um addon separado para isso, mas precisa editar arquivos de configuração JSON e adicionar recursos a um pacote de recursos.


== Como o modelo é escolhido ==
O DragonMineZ escolhe a chave de modelo nesta ordem:
# O <code>customModel</code> da '''forma acumulável''' ativa (de <code>config/dragonminez/forms/<group>.json</code>).
# O <code>customModel</code> da '''forma de raça''' ativa (de <code>races/<race>/forms/<group>.json</code>).
# O <code>customModel</code> da raça (de <code>races/<race>/character.json</code>).
# O modelo padrão incluído da raça (uma raça personalizada sem <code>customModel</code> usa o modelo Humano).

Origem: <code>src/main/java/com/dragonminez/client/model/DMZPlayerModel.java</code>.


== Chaves de modelo incluídas ==
Você pode fazer qualquer raça ou forma usar um modelo que já vem com o DragonMineZ. Estas chaves também trazem as texturas e os rostos desse modelo:

{| class="wikitable"
! Família !! Chaves
|-
| [[Special:MyLanguage/Human|Humano]] / [[Special:MyLanguage/Saiyan|Saiyajin]] || <code>human</code>, <code>saiyan</code>, <code>buffed</code>, <code>buffedg3</code>, <code>4arms</code>, <code>ssj4gt</code>, <code>ssj4d</code>, <code>oozaru</code>
|-
| [[Special:MyLanguage/Namekian|Namekuseijin]] || <code>namekian</code>, <code>namekian_orange</code>, <code>namekian_buffed</code>
|-
| [[Special:MyLanguage/Majin|Majin]] || <code>majin</code>, <code>majin_super</code>, <code>majin_ultra</code>, <code>majin_evil</code>, <code>majin_kid</code>, <code>janemba_imperfect</code>, <code>janemba_fat</code>, <code>janemba_super</code>
|-
| [[Special:MyLanguage/Frost Demon|Clã Freeza]] || <code>frostdemon</code>, <code>frostdemon_second</code>, <code>frostdemon_third</code>, <code>frostdemon_final</code>, <code>frostdemon_fifth</code>, <code>frostdemon_fp</code>, <code>frostdemon_mecha</code>, <code>frostdemon_metalcore</code>
|-
| [[Special:MyLanguage/Bio-Android|Bio-Androide]] || <code>bioandroid</code>, <code>bioandroid_base</code>, <code>bioandroid_semi</code>, <code>bioandroid_perfect</code>, <code>bioandroid_ultra</code>, <code>bioandroid_xeno</code>, <code>bioandroid_xenofp</code>
|-
| [[Special:MyLanguage/Glind|Glind]] || <code>glindtrueform</code>, <code>trascended</code> (usa o modelo feminino para personagens femininos)
|}

A chave especial <code>finalbase</code> (usada pela forma acumulável Ultimate) volta para o modelo base da própria raça nas raças incluídas.

Qualquer outra chave é uma '''chave de modelo personalizada''' e segue as convenções abaixo.


== Arquivos de geometria ==
Os arquivos de modelos personalizados são procurados neste namespace e caminho, tanto para modelos de raça '''quanto''' de forma:

<syntaxhighlight lang="text">
assets/dragonminez/geo/entity/races/<model_key>.geo.json
</syntaxhighlight>

Se a raça tiver <code>hasGender: true</code>, o DragonMineZ acrescenta o sufixo de gênero no lugar:

<syntaxhighlight lang="text">
assets/dragonminez/geo/entity/races/<model_key>_male.geo.json
assets/dragonminez/geo/entity/races/<model_key>_female.geo.json
</syntaxhighlight>

Se o arquivo não for encontrado, o jogador volta para o modelo Humano padrão. Esse comportamento do sufixo vem de <code>DMZPlayerModel#resolveCustomModel</code>.

As partes extras de cabeça escolhidas na personalização do personagem (os <code>headBones</code> da raça) são buscadas primeiro em <code>assets/dragonminez/geo/entity/raceparts.geo.json</code> e depois no próprio modelo da raça, então você pode adicionar seus próprios ossos de orelhas ou chifres diretamente no seu modelo.


== Texturas do corpo ==
Para chaves de modelo personalizadas, as texturas do corpo ficam em uma pasta com o nome da '''chave da raça''': <code>assets/dragonminez/textures/entity/races/<race_key>/</code>.

As '''raças em camadas''' (<code>isLayered: true</code> em <code>character.json</code>) usam três camadas em tons de cinza por tipo corporal, tingidas com as três cores de corpo:
* <code><model_key>_<bodyType>_layer1.png</code> (cor de corpo 1)
* <code><model_key>_<bodyType>_layer2.png</code> (cor de corpo 2)
* <code><model_key>_<bodyType>_layer3.png</code> (cor de corpo 3)
* Com gênero: <code><model_key>_male_<bodyType>_layer1.png</code>, <code><model_key>_female_<bodyType>_layer1.png</code> e assim por diante.

A quantidade de tipos corporais oferecidos na personalização do personagem é a quantidade de arquivos <code><model_key>[_male|_female]_<n>_layer1.png</code> consecutivos encontrados, começando em <code>0</code>. Se a raça tiver <code>useVanillaSkin: true</code>, o tipo corporal <code>0</code> é a skin de Minecraft do próprio jogador e suas texturas começam em <code>1</code>. Se faltar o <code>layer1</code> de um tipo corporal, é usado o tipo corporal <code>0</code>.

As '''raças sem camadas''' (<code>isLayered: false</code>) usam uma única textura tingida com a cor de corpo 1: <code><model_key>.png</code>, ou <code><model_key>_male.png</code> / <code><model_key>_female.png</code> com gênero.

Origem: <code>src/main/java/com/dragonminez/client/util/SkinGathererProvider.java</code>, <code>src/main/java/com/dragonminez/client/util/TextureCounter.java</code>.


== Texturas do rosto ==
As raças personalizadas em camadas desenham o próprio rosto a partir desta pasta:

<syntaxhighlight lang="text">
assets/dragonminez/textures/entity/races/<race_key>/faces/
</syntaxhighlight>

Os arquivos seguem este padrão de nomes:
* <code><model_key>_eye_<eyesType>_0.png</code> (branco do olho)
* <code><model_key>_eye_<eyesType>_1.png</code> (cor dos olhos 1)
* <code><model_key>_eye_<eyesType>_2.png</code> (cor dos olhos 2)
* <code><model_key>_eye_<eyesType>_3.png</code> (sobrancelhas, cor do cabelo)
* <code><model_key>_nose_<noseType>.png</code> (cor da pele)
* <code><model_key>_mouth_<mouthType>.png</code> (cor da pele)

Se faltar um índice, é usado <code>_0</code>. A tela de personalização oferece primeiro seus próprios olhos, narizes e bocas (contados a partir dos arquivos acima, começando em <code>0</code>) e depois todos os dos Humanos, então os jogadores também podem dar à sua raça um rosto Humano.

As raças personalizadas sem camadas pegam emprestado o rosto Humano por completo. Quando uma raça renderiza a skin de Minecraft do jogador (tipo corporal <code>0</code> com <code>useVanillaSkin: true</code>), nenhuma textura de rosto é desenhada por cima.

Origem: <code>src/main/java/com/dragonminez/client/render/layer/DMZSkinLayer.java</code> (<code>renderCustomFace</code>).


== Atribuir sua chave de modelo ==
Escolha um lugar:
* O modelo padrão da raça: <code>races/<race>/character.json</code> → <code>customModel</code>
* Uma forma específica: <code>races/<race>/forms/<group>.json</code> → <code>forms.<form>.customModel</code>
* Uma forma acumulável: <code>forms/<group>.json</code> → <code>forms.<form>.customModel</code>
Depois adicione a geometria e as texturas correspondentes ao seu pacote de recursos. Veja [[Special:MyLanguage/Custom Races|Raças personalizadas]] e [[Special:MyLanguage/Custom Forms|Formas personalizadas]] para os outros campos.


== Animações de transformação ==
O <code>transformationAnimation</code> de uma forma pode indicar qualquer animação definida nos arquivos de animação do jogador em <code>assets/dragonminez/animations/entity/races/</code> (<code>movement</code>, <code>combat</code>, <code>ki</code>, <code>transf</code>, <code>skp</code>, <code>evs</code>). Para adicionar a sua, inclua no seu pacote de recursos uma cópia de <code>transf.animation.json</code> que mantenha as entradas incluídas e adicione sua animação, e depois use o nome dela na configuração da forma.

== Checklist ==
# Defina <code>customModel</code> na configuração da raça ou da forma.
# Adicione <code>geo/entity/races/<model_key>.geo.json</code> (e as variantes <code>_male</code> e <code>_female</code> se a raça tiver gênero).
# Adicione as texturas do corpo em <code>textures/entity/races/<race_key>/</code> (e as variantes de gênero, se necessário).
# Nas raças em camadas, adicione texturas de rosto para cada índice de olhos, nariz e boca que você usar.
# Recarregue os recursos e execute <code>/dmzreload</code>. Às vezes será preciso reiniciar o jogo.

{{Navbox Modding}}

Custom Models and Assets/pt - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository