Shokkoh: Translation sync from dragonminez-wiki repository

2026-10-14T00:03:27Z

Translation sync from dragonminez-wiki repository

New page

Los '''modelos y recursos propios''' permiten que las razas y formas usen tu propia geometría, texturas de cuerpo y caras. No necesitas crear un addon aparte para esto, pero sí tienes que editar archivos de configuración JSON y añadir recursos a un paquete de recursos.


== Cómo se elige el modelo ==
DragonMineZ elige la clave de modelo en este orden:
# El <code>customModel</code> de la '''forma acumulable''' activa (de <code>config/dragonminez/forms/<group>.json</code>).
# El <code>customModel</code> de la '''forma de raza''' activa (de <code>races/<race>/forms/<group>.json</code>).
# El <code>customModel</code> de la raza (de <code>races/<race>/character.json</code>).
# El modelo por defecto incluido de la raza (una raza personalizada sin <code>customModel</code> usa el modelo Humano).

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


== Claves de modelo incluidas ==
Puedes hacer que cualquier raza o forma use un modelo que ya viene con DragonMineZ. Estas claves también traen consigo las texturas y caras de ese modelo:

{| class="wikitable"
! Familia !! Claves
|-
| [[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|Namekiano]] || <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|Demonio del Frío]] || <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 el modelo femenino para los personajes femeninos)
|}

La clave especial <code>finalbase</code> (que usa la forma acumulable Definitivo) vuelve al modelo base propio de la raza en las razas incluidas.

Cualquier otra clave es una '''clave de modelo personalizada''' y sigue las convenciones de abajo.


== Archivos de geometría ==
Los archivos de modelos personalizados se buscan en este namespace y ruta, tanto para modelos de raza '''como''' de forma:

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

Si la raza tiene <code>hasGender: true</code>, DragonMineZ añade en su lugar el sufijo de género:

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

Si no se encuentra el archivo, el jugador vuelve al modelo Humano por defecto. Este comportamiento del sufijo viene de <code>DMZPlayerModel#resolveCustomModel</code>.

Las partes extra de la cabeza que se eligen en la personalización del personaje (los <code>headBones</code> de la raza) se toman primero de <code>assets/dragonminez/geo/entity/raceparts.geo.json</code> y luego del propio modelo de la raza, así que puedes añadir tus propios huesos de orejas o cuernos directamente en tu modelo.


== Texturas del cuerpo ==
Para las claves de modelo personalizadas, las texturas del cuerpo están en una carpeta con el nombre de la '''clave de la raza''': <code>assets/dragonminez/textures/entity/races/<race_key>/</code>.

Las '''razas por capas''' (<code>isLayered: true</code> en <code>character.json</code>) usan tres capas en escala de grises por tipo de cuerpo, teñidas con los tres colores de cuerpo:
* <code><model_key>_<bodyType>_layer1.png</code> (color de cuerpo 1)
* <code><model_key>_<bodyType>_layer2.png</code> (color de cuerpo 2)
* <code><model_key>_<bodyType>_layer3.png</code> (color de cuerpo 3)
* Con género: <code><model_key>_male_<bodyType>_layer1.png</code>, <code><model_key>_female_<bodyType>_layer1.png</code>, etc.

La cantidad de tipos de cuerpo que se ofrecen en la personalización del personaje es la cantidad de archivos <code><model_key>[_male|_female]_<n>_layer1.png</code> consecutivos que se encuentran, empezando en <code>0</code>. Si la raza tiene <code>useVanillaSkin: true</code>, el tipo de cuerpo <code>0</code> es la skin de Minecraft del propio jugador y tus texturas empiezan en <code>1</code>. Si a un tipo de cuerpo le falta el <code>layer1</code>, se usa el tipo de cuerpo <code>0</code>.

Las '''razas sin capas''' (<code>isLayered: false</code>) usan una sola textura teñida con el color de cuerpo 1: <code><model_key>.png</code>, o <code><model_key>_male.png</code> / <code><model_key>_female.png</code> con género.

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


== Texturas de la cara ==
Las razas personalizadas por capas dibujan su propia cara desde esta carpeta:

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

Los archivos siguen este patrón de nombres:
* <code><model_key>_eye_<eyesType>_0.png</code> (blanco del ojo)
* <code><model_key>_eye_<eyesType>_1.png</code> (color de ojos 1)
* <code><model_key>_eye_<eyesType>_2.png</code> (color de ojos 2)
* <code><model_key>_eye_<eyesType>_3.png</code> (cejas, color del pelo)
* <code><model_key>_nose_<noseType>.png</code> (color de piel)
* <code><model_key>_mouth_<mouthType>.png</code> (color de piel)

Si falta un índice, se usa <code>_0</code>. La pantalla de personalización ofrece primero tus propios ojos, narices y bocas (contados a partir de los archivos de arriba, empezando en <code>0</code>) y después todos los de los Humanos, así que los jugadores también pueden darle a tu raza una cara Humana.

Las razas personalizadas sin capas toman prestada por completo la cara Humana. Cuando una raza renderiza la skin de Minecraft del jugador (tipo de cuerpo <code>0</code> con <code>useVanillaSkin: true</code>), no se dibuja ninguna textura de cara encima.

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


== Asignar tu clave de modelo ==
Elige un lugar:
* El modelo por defecto de la raza: <code>races/<race>/character.json</code> → <code>customModel</code>
* Una forma concreta: <code>races/<race>/forms/<group>.json</code> → <code>forms.<form>.customModel</code>
* Una forma acumulable: <code>forms/<group>.json</code> → <code>forms.<form>.customModel</code>
Después añade la geometría y las texturas correspondientes a tu paquete de recursos. Consulta [[Special:MyLanguage/Custom Races|Razas personalizadas]] y [[Special:MyLanguage/Custom Forms|Formas personalizadas]] para ver los demás campos.


== Animaciones de transformación ==
El <code>transformationAnimation</code> de una forma puede nombrar cualquier animación definida en los archivos de animación del jugador en <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 añadir la tuya, incluye en tu paquete de recursos una copia de <code>transf.animation.json</code> que conserve las entradas incluidas y añada tu animación, y luego usa su nombre en la configuración de la forma.


== Lista de comprobación ==
# Define <code>customModel</code> en la configuración de la raza o de la forma.
# Añade <code>geo/entity/races/<model_key>.geo.json</code> (y las variantes <code>_male</code> y <code>_female</code> si la raza tiene género).
# Añade las texturas del cuerpo en <code>textures/entity/races/<race_key>/</code> (y las variantes de género si hace falta).
# En las razas por capas, añade texturas de cara para cada índice de ojos, nariz y boca que uses.
# Recarga los recursos y ejecuta <code>/dmzreload</code>. A veces tendrás que reiniciar el juego.

{{Navbox Modding}}

Custom Models and Assets/es - Revision history

Shokkoh: Translation sync from dragonminez-wiki repository