View source for Custom Races/es

Las '''razas personalizadas''' son razas jugables que añades a DragonMineZ solo con archivos de configuración. No necesitas código Java ni un jar de addon: una carpeta con unos pocos archivos JSON define la apariencia de la raza, sus clases, su habilidad racial y sus transformaciones, y la raza aparece entonces en la creación de personaje.

<span id="How_DragonMineZ_finds_races"></span>
== Cómo encuentra DragonMineZ las razas ==
DragonMineZ carga primero sus razas incluidas (<code>human</code>, <code>saiyan</code>, <code>namekian</code>, <code>frostdemon</code>, <code>bioandroid</code>, <code>majin</code>, <code>glind</code>) y luego revisa las subcarpetas de <code>config/dragonminez/races/</code>. Cualquier otro nombre de carpeta que haya ahí se trata como la clave de una raza personalizada (usa minúsculas). Cada carpeta de raza contiene:

<syntaxhighlight lang="text">
config/dragonminez/races/<race_key>/
  character.json      # appearance, model, racial skill, form skill prices
  stats.json          # per-class base stats and scaling
  forms/*.json        # the race's transformation groups
</syntaxhighlight>

Si creas una carpeta vacía, DragonMineZ genera un <code>character.json</code> y un <code>stats.json</code> con valores neutros la próxima vez que se cargue la configuración. '''No''' genera ninguna forma para una raza personalizada: esas las añades tú (consulta el paso 3).

Un buen punto de partida es copiar la carpeta de una raza existente (por ejemplo <code>races/saiyan/</code>), cambiarle el nombre y ajustar los valores que contiene.

Código fuente: <code>src/main/java/com/dragonminez/common/config/ConfigManager.java</code> (<code>loadAllRaces</code>, <code>createOrLoadRace</code>).

{{Note|type=config|title=Versión de la configuración|text=Cada archivo lleva un texto <code>"configVersion"</code> (actualmente <code>"2.2.0"</code>). Un archivo personalizado con una versión anterior o sin versión se respalda en <code>config/dragonminez/oldBackup/</code> y se vuelve a guardar con la versión actual; tus valores se conservan. Un archivo con sintaxis JSON rota nunca se sobrescribe: se reporta y se omite hasta que lo corrijas. Consulta [[Special:MyLanguage/How to JSON|Cómo usar JSON]] y [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]].}}

<span id="Step_1:_Configure_the_character"></span>
== Paso 1: configura el personaje ==
<code>character.json</code> define la apariencia, el modelo, la habilidad racial y los precios de las habilidades de forma de la raza:

<syntaxhighlight lang="json">
{
  "configVersion": "2.2.0",
  "hasGender": false,
  "useVanillaSkin": false,
  "customModel": "saibaman",
  "isLayered": true,
  "headBones": ["ears1"],
  "racialSkill": "namekian",
  "hasSaiyanTail": false,
  "auraType": "kakarot",
  "auraType3D": "userPreference",
  "defaultModelScaling": [0.9375, 0.9375, 0.9375],
  "defaultBodyType": 0,
  "slimBodyTypes": [],
  "defaultHairType": 0,
  "defaultEyesType": 0,
  "defaultNoseType": 0,
  "defaultMouthType": 0,
  "defaultTattooType": 0,
  "defaultBodyColor": "#3E8E2E",
  "defaultBodyColor2": "#2A5C20",
  "defaultBodyColor3": "#9BD36A",
  "defaultHairColor": "#222629",
  "defaultEye1Color": "#B40000",
  "defaultEye2Color": "#B40000",
  "defaultAuraColor": "#7FFF00",
  "formSkillsCosts": {
    "superforms": { "buyFromMaster": false, "prices": [20000, 45000, 80000] },
    "godforms": { "buyFromMaster": false, "prices": [] },
    "legendaryforms": { "buyFromMaster": false, "prices": [] }
  }
}
</syntaxhighlight>

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>hasGender</code> || Booleano || <code>true</code> le da a la raza la opción de elegir hombre/mujer. Los modelos y texturas personalizados usan entonces los sufijos <code>_male</code> / <code>_female</code> (consulta [[Special:MyLanguage/Custom Models and Assets|Modelos y recursos propios]]).
|-
| <code>useVanillaSkin</code> || Booleano || Con <code>true</code>, el tipo de cuerpo <code>0</code> muestra la propia skin de Minecraft del jugador; las texturas de cuerpo propias de la raza empiezan en el tipo de cuerpo <code>1</code>.
|-
| <code>customModel</code> || Texto || Clave del modelo. Vacía significa que la raza se ve como un Humano. Una clave incluida (por ejemplo <code>namekian</code>, <code>majin</code> o <code>frostdemon</code>) reutiliza ese modelo y sus texturas; cualquier otra clave carga tu propio modelo. Las claves incluidas aparecen en [[Special:MyLanguage/Custom Models and Assets#Built-in model keys|Modelos y recursos propios]].
|-
| <code>isLayered</code> || Booleano || <code>true</code>: el cuerpo se dibuja con tres capas de textura teñibles (colores de cuerpo 1, 2 y 3) y la raza usa sus propias texturas de cara. <code>false</code>: una sola textura de cuerpo sin capas y caras prestadas del Humano.
|-
| <code>headBones</code> || Lista de textos || Nombres de huesos que el jugador puede elegir en la personalización del personaje (uno a la vez, más una opción "ninguno"), por ejemplo orejas, cuernos o antenas. Une huesos con <code>+</code> para mostrar varios a la vez (<code>"ears1+horns2"</code>). La entrada especial <code>"hair"</code> activa el editor de pelo para la raza. Los huesos se buscan primero en <code>geo/entity/raceparts.geo.json</code> y luego en el modelo de la raza.
|-
| <code>racialSkill</code> || Texto || Qué habilidad racial usa la raza: <code>human</code>, <code>saiyan</code>, <code>namekian</code>, <code>frostdemon</code>, <code>bioandroid</code>, <code>majin</code> o <code>glind</code>. Una raza personalizada usa el mismo ajuste que la raza de la que la toma (<code>general-server.json</code> → <code>racialSkills.<skill></code>). Consulta [[Special:MyLanguage/Racial Skills|Habilidades raciales]].
|-
| <code>hasSaiyanTail</code> || Booleano || Le da a la raza una cola Saiyajin.
|-
| <code>auraType</code> || Texto || Conjunto de sprites del aura 2D: <code>kakarot</code> o <code>god</code>.
|-
| <code>auraType3D</code> || Texto || Estilo del aura 3D de la forma base: <code>smooth</code>, <code>sparking</code>, <code>god</code> o <code>userPreference</code> (sigue el ajuste de cada jugador).
|-
| <code>aura3DStyle</code> || Objeto || Ajuste fino de la forma del aura 3D base. Las claves aparecen en [[Special:MyLanguage/Custom Forms#3D aura shape|Formas personalizadas]].
|-
| <code>defaultModelScaling</code> || <code>[x, y, z]</code> || Tamaño base del modelo.
|-
| <code>defaultBodyType</code> || Entero || Tipo de cuerpo elegido por defecto en la creación de personaje.
|-
| <code>slimBodyTypes</code> || Lista de enteros || Tipos de cuerpo (aparte del <code>0</code>) que usan brazos delgados. El tipo de cuerpo <code>0</code> siempre sigue el modelo de skin del jugador.
|-
| <code>defaultHairType</code>, <code>defaultEyesType</code>, <code>defaultNoseType</code>, <code>defaultMouthType</code>, <code>defaultTattooType</code> || Entero || Índices de personalización por defecto.
|-
| <code>defaultBodyColor</code>, <code>defaultBodyColor2</code>, <code>defaultBodyColor3</code>, <code>defaultHairColor</code>, <code>defaultEye1Color</code>, <code>defaultEye2Color</code>, <code>defaultAuraColor</code> || Texto hexadecimal || Colores por defecto en la creación de personaje.
|-
| <code>formSkillsCosts</code> || Objeto || Una entrada por cada habilidad de forma que la raza puede subir de nivel (ver abajo).
|}

Origen del esquema: <code>src/main/java/com/dragonminez/common/config/RaceCharacterConfig.java</code>.

<span id="Form_skill_prices"></span>
=== Precios de las habilidades de forma ===
Cada clave de <code>formSkillsCosts</code> es una habilidad de forma: <code>superforms</code>, <code>legendaryforms</code>, <code>godforms</code> o <code>androidforms</code>. El valor es un array simple de precios o un objeto con estos campos:

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>prices</code> || Lista de números || Precio en TP de cada nivel, en orden. La cantidad de entradas es el nivel máximo de la habilidad, así que una lista vacía significa que la raza no puede subir de nivel esa habilidad.
|-
| <code>buyFromMaster</code> || Booleano || <code>true</code>: el primer nivel se tiene que comprar a un maestro antes de poder subir la habilidad desde el menú de Habilidades.
|}

Una forma se desbloquea cuando esta habilidad alcanza el <code>unlockOnSkillLevel</code> de la forma (consulta el paso 3).

<span id="Android_upgrade_for_custom_races"></span>
=== Mejora androide para razas personalizadas ===
La mejora androide del Dr. Gero se ofrece a cualquier raza cuyo <code>formSkillsCosts</code> tenga al menos un precio en <code>androidforms</code> (por defecto solo los [[Special:MyLanguage/Human|Humanos]]). La mejora pone al jugador en la forma <code>androidbase</code> del grupo <code>androidforms</code>, así que la raza también necesita un grupo de formas <code>androidforms</code> en su carpeta <code>forms/</code>. Lo más fácil es copiar <code>races/human/forms/androidforms.json</code> en la carpeta <code>forms/</code> de tu raza. Consulta [[Special:MyLanguage/Android|Androide]] para ver la mejora en sí.

<span id="Step_2:_Configure_the_classes"></span>
== Paso 2: configura las clases ==
<code>stats.json</code> contiene un objeto <code>classes</code> con un bloque por clase. DragonMineZ genera las ocho clases por defecto: <code>warrior</code>, <code>spiritualist</code>, <code>martialartist</code>, <code>berserker</code>, <code>paladin</code>, <code>tank</code>, <code>cleric</code> y <code>unversed</code> (consulta [[Special:MyLanguage/Classes|Clases]]). Puedes añadir tu propia clase duplicando un bloque con una clave nueva; aparece en la creación de personaje de esa raza. Un jugador cuya clase no esté en el archivo de la raza usa los valores de <code>warrior</code>.

Dentro de cada bloque de clase:

{| class="wikitable"
! Campo !! Tipo !! Qué hace
|-
| <code>baseStats</code> || Objeto || Estadísticas iniciales: <code>STR</code>, <code>SKP</code>, <code>RES</code>, <code>VIT</code>, <code>PWR</code>, <code>ENE</code>.
|-
| <code>statScaling</code> || Objeto || <code>STR_scaling</code>, <code>SKP_scaling</code>, <code>STM_scaling</code>, <code>DEF_scaling</code>, <code>VIT_scaling</code>, <code>PWR_scaling</code>, <code>ENE_scaling</code>. Los opcionales <code>VIT_scaling_max</code> y <code>DEF_scaling_max</code> hacen que el escalado crezca desde el valor normal hacia ese máximo a medida que sube la estadística (hasta el punto de inflexión de la curva definido en <code>general-server.json</code>); omítelos para un escalado fijo.
|-
| <code>baseHp5</code>, <code>hp5VitScaling</code> || Número || Vida regenerada cada 5 segundos, más una parte de VIT.
|-
| <code>baseEp5</code>, <code>ep5EneScaling</code> || Número || Ki regenerado cada 5 segundos, más una parte de ENE.
|-
| <code>baseSp5</code>, <code>sp5StmScaling</code>, <code>sp5ResScaling</code> || Número || Stamina regenerada cada 5 segundos, más una parte de VIT (<code>sp5StmScaling</code>, a pesar de su nombre) y una parte de RES (<code>sp5ResScaling</code>, <code>0</code> si falta).
|-
| <code>tpCostMultiplier</code>, <code>tpGainMultiplier</code> || Número || Multiplicadores de toda la clase sobre los costos y las ganancias de TP.
|-
| <code>passive</code> || Objeto || <code>enabled</code> más un mapa <code>values</code> con el ajuste de la pasiva de la clase (las claves dependen de la clase).
|}

Origen del esquema: <code>src/main/java/com/dragonminez/common/config/RaceStatsConfig.java</code>. Consulta [[Special:MyLanguage/Stats and Attributes|Estadísticas y atributos]] para ver qué hace cada estadística.

<span id="Step_3:_Add_form_groups"></span>
== Paso 3: añade grupos de formas ==
{{Main|Custom Forms}}
Cada archivo de <code>races/<race_key>/forms/</code> define un grupo de formas. Las formas de raza usan exactamente el mismo esquema que las formas acumulables, así que la referencia completa de campos está en [[Special:MyLanguage/Custom Forms|Formas personalizadas]]. Los campos más importantes para un grupo de raza son:
* <code>groupName</code>: la clave del grupo (en minúsculas). Los grupos se identifican por este valor, no por el nombre del archivo.
* <code>formType</code>: la habilidad de forma que desbloquea el grupo: <code>superforms</code>, <code>legendaryforms</code>, <code>godforms</code> o <code>androidforms</code>. La raza necesita precios para esa habilidad en <code>formSkillsCosts</code>.
* <code>forms</code>: las formas del grupo, en orden de transformación. El <code>unlockOnSkillLevel</code> de cada forma es el nivel de habilidad que la desbloquea.
* <code>customModel</code>: una clave de modelo para la forma (se busca igual que el <code>customModel</code> de la raza).
Los archivos cuyo nombre empieza por <code>old_</code> se ignoran. Consulta [[Special:MyLanguage/Transformations|Transformaciones]] para ver cómo funcionan las formas en el juego.

<span id="Step_4:_Add_translation_keys"></span>
== Paso 4: añade claves de traducción ==
Los nombres de razas y formas se traducen con estas claves:
* <code>race.dragonminez.<race_key></code>: el nombre de la raza.
* <code>race.dragonminez.<race_key>.desc</code>: una breve descripción que se muestra en la creación de personaje.
* <code>race.dragonminez.<race_key>.group.<group_key></code>: el nombre de un grupo de formas.
* <code>race.dragonminez.<race_key>.form.<group_key>.<form_key></code>: el nombre de una forma.
El archivo de idioma por defecto es <code>src/main/resources/assets/dragonminez/lang/en_us.json</code>. Puedes editar tu <code>en_us.json</code> o crear un nuevo archivo de idioma para tu raza personalizada. No necesitas añadir claves de traducción para nada más: DragonMineZ combina automáticamente las traducciones ya hechas en Crowdin con las tuyas.

<span id="Step_5:_Reload_and_validate"></span>
== Paso 5: recarga y valida ==
# Guarda tus archivos JSON.
# Ejecuta <code>/dmzreload config</code> (consulta [[Special:MyLanguage/Reloading and Updating Changes|Recargar y actualizar cambios]]).
# Abre la creación de personaje y comprueba que aparece tu raza.
# Revisa sus formas, colores y escalado en el juego.

{{Navbox Modding}}