FuzzyBot: Updating to match new version of source page

2026-10-22T00:58:01Z

Updating to match new version of source page

← Older revision		Revision as of 00:58, 22 October 2026
Line 122:		Line 122:
	\| <code>tintColor</code>, <code>tintIntensity</code> \|\| Hex / Double \|\| <code>#FF0000</code>, <code>0.0</code> \|\| Color tint over the player while transformed. <code>0</code> means no tint.		\| <code>tintColor</code>, <code>tintIntensity</code> \|\| Hex / Double \|\| <code>#FF0000</code>, <code>0.0</code> \|\| Color tint over the player while transformed. <code>0</code> means no tint.
	\|-		\|-
	\| <code>outlineShader</code> \|\| Object \|\| — \|\| <code>enabled</code> (<code>false</code>), <code>primaryColor</code> (<code>#7FFFFF</code>), <code>secondaryColor</code>, <code>outlineThickness</code> (<code>1.5</code>).		\| <code>outlineShader</code> \|\| Object \|\| — \|\| <code>enabled</code> (<code>false</code>), <code>primaryColor</code> (<code>#7FFFFF</code>), <code>secondaryColor</code>, <code>outlineThickness</code> (<code>1.5</code>), <code>fireIntensity</code> (<code>0</code>–<code>3</code>, default <code>0</code>: animated flame tongues), <code>colorMode</code> (<code>"pulse"</code>, the default, shifts between the two colors; <code>"gradient"</code> goes from <code>primaryColor</code> next to the body to <code>secondaryColor</code> at the outer edge) and <code>bodyGlow</code> (<code>0</code>–<code>1</code>, default <code>0</code>: a glow of the outline color along the edges of the body). The same <code>outlineThickness</code> draws a wider outline than before 2.2.
	\|}		\|}

FuzzyBot: Updating to match new version of source page

2026-10-13T05:22:46Z

Updating to match new version of source page

New page

'''Custom forms''' are transformations you add or change with JSON files. Forms can live in two places; both use exactly the same JSON schema and Java class (<code>FormConfig.java</code>), and only the folder they sit in changes what they mean:

{| class="wikitable"
! Location !! What it is
|-
| <code>config/dragonminez/races/<race>/forms/*.json</code> || '''Race forms''' belong to one race only (for example, Super Saiyan only exists for Saiyans). See [[Special:MyLanguage/Custom Races|Custom Races]].
|-
| <code>config/dragonminez/forms/*.json</code> || '''Stack forms''' are shared by all races and designed to layer on top of whatever race form is already active.
|}

This page is about the second kind, stack forms, but the [[Special:MyLanguage/Custom Forms#Field reference|field reference]] below applies to race forms too.

Loader: <code>ConfigManager.createOrLoadStackForms()</code> reads every file in <code>config/dragonminez/forms/</code> (<code>ConfigLoader.loadStackForms</code>). Files whose name starts with <code>old_</code> are ignored.

== What a stack form is ==
{{Main|Transformations}}
A stack form doesn't replace your current transformation: it stacks its multipliers on top of it. The clearest example is [[Special:MyLanguage/Kaioken|Kaioken]]: a Saiyan can be in base form or Super Saiyan and ''also'' be in Kaioken x2 at the same time, multiplying whatever form they are already in. The built-in stack form groups are <code>kaioken</code> (x2, x3, x4, x10, x20) and <code>ultimate</code> (<code>StackForms.java</code>).

A stack group is unlocked by the stack skill named in its <code>formType</code>: <code>kaioken</code> or <code>ultimate</code>. A form of the group becomes available when that skill reaches the form's <code>unlockOnSkillLevel</code>.

== File structure ==
There is one file per group, for example <code>config/dragonminez/forms/kaioken.json</code> (shortened):

<syntaxhighlight lang="json">
{
"configVersion": "2.2.0",
"groupName": "kaioken",
"formType": "kaioken",
"forms": {
"x2": {
"name": "x2",
"unlockOnSkillLevel": 1,
"keepBaseFormHeadBones": true,
"strMultiplier": 1.1,
"skpMultiplier": 1.1,
"defMultiplier": 1.125,
"pwrMultiplier": 1.1,
"speedMultiplier": 1.1,
"healthDrain": 0.03,
"attackSpeed": 1.1,
"tintColor": "#FF0000",
"tintIntensity": 0.1,
"auraColor": "#DB182C",
"auraLayer": 1,
"formStackable": true,
"stackDrainMultiplier": 1.0,
"incompatibleWith": ["ultimate.ultimate"],
"shareMasteryWith": ["kaioken.x3"],
"shareMasteryMultiplier": 0.25
}
}
}
</syntaxhighlight>

<code>groupName</code> is the group key (lowercase); groups are identified by it, not by the filename. Everything nested under <code>forms</code> is one form entry, keyed by its own <code>name</code>. Any field you leave out takes the default shown below.

{{Note|type=config|title=Config version|text=Use <code>"configVersion": "2.2.0"</code>. A custom form file with an older or missing version is backed up to <code>config/dragonminez/oldBackup/</code> and saved again with the current version; your values are kept. A file with broken JSON syntax is skipped and reported until you fix it.}}

== Field reference ==
Schema source: <code>src/main/java/com/dragonminez/common/config/FormConfig.java</code>.

=== Unlock and requirements ===
{{Config|General Server Config|gameplay}}

{| class="wikitable"
! Field !! Type !! Default !! What it does
|-
| <code>name</code> || String || <code>""</code> || Form key within the group (for example <code>x2</code>, <code>x3</code> or <code>ultimate</code>).
|-
| <code>unlockOnSkillLevel</code> || Integer || <code>0</code> || Level of the group's form skill that unlocks this form.
|-
| <code>formRequisite</code> || String || <code>""</code> || Other forms that must be mastered first, as <code>"group.form"</code>. Separate several with commas.
|-
| <code>formRequisiteType</code> || String || <code>all</code> || <code>all</code>: every listed form needs the mastery. <code>any</code>: one is enough.
|-
| <code>unlockOnMastery</code> || Double || <code>0.0</code> || Mastery the <code>formRequisite</code> forms need. <code>0</code> turns the requirement off.
|-
| <code>levelRequisite</code> || Integer || <code>0</code> || Player level needed. Until it is reached, the form skill cannot be leveled up to this form. Toggle: <code>levelFormRequisiteEnabled</code> in <code>general-server.json</code> → <code>gameplay</code>.
|-
| <code>sagaRequisite</code> || String || <code>""</code> || Saga quest that must be completed first, as <code>"sagaId:questId"</code> (for example <code>"frieza_saga:10"</code>). Until it is completed, the form skill cannot be leveled up to this form. Ignored when story mode is off or the quest does not exist. Toggle: <code>sagaFormRequisiteEnabled</code> in <code>general-server.json</code> → <code>gameplay</code>.
|}

=== Visuals ===

{| class="wikitable"
! Field !! Type !! Default !! What it does
|-
| <code>customModel</code> || String || <code>""</code> || Model key for the form. Looked up like a race model: built-in keys or your own <code>geo/entity/races/<key>.geo.json</code> (see [[Special:MyLanguage/Custom Models and Assets|Custom Models and Assets]]). A stack form's model wins over the race form's.
|-
| <code>keepBaseFormHeadBones</code> || Boolean || <code>false</code> || Keeps the player's chosen head bone (ears, horns and so on) visible in this form.
|-
| <code>hideTail</code> || Boolean || <code>false</code> || Hides the Saiyan tail while in this form.
|-
| <code>transformationAnimation</code> || String || <code>transf.generic</code> || Animation played while charging into this form. Built-in values: <code>transf.generic</code>, <code>transf.ssj</code>, <code>transf.ssj3</code>, <code>transf.ssg2</code>, <code>transf.ozaru</code>, <code>transf.absorb</code>, <code>transf.berserker</code>, <code>transf.freezer</code>, <code>transf.freezer2</code>, <code>transf.janemba</code>, <code>transf.daima</code>. Any animation name from the player animation files (<code>assets/dragonminez/animations/entity/races/*.animation.json</code>) works, so a resource pack can add its own. Empty means the generic animation.
|-
| <code>bodyColor1</code>, <code>bodyColor2</code>, <code>bodyColor3</code>, <code>hairColor</code>, <code>eye1Color</code>, <code>eye2Color</code> || Hex string || <code>""</code> || Color overrides. Empty keeps the player's color. Colors blend in while charging.
|-
| <code>furUsesHairColor</code> || Boolean || <code>false</code> || On SSJ4 models (a <code>customModel</code> containing <code>ssj4gt</code> or <code>ssj4d</code>), colors the fur with the hair color.
|-
| <code>hairType</code> || String || <code>""</code> || Which of the player's hair styles to show: <code>base</code>, <code>ssj</code>, <code>ssj2</code>, <code>ssj3</code> or <code>ssj4</code>.
|-
| <code>forcedHairCode</code> || String || <code>""</code> || A hair code (from the hair editor) forced while in this form.
|-
| <code>extraFormLayer</code>, <code>extraFormColor</code> || String / Hex || <code>""</code> || Extra texture drawn over the body, tinted with <code>extraFormColor</code> (white if empty). Use a full <code>namespace:path</code> or a path inside the <code>dragonminez</code> namespace, for example <code>textures/entity/races/my_overlay.png</code>.
|-
| <code>auraType</code> || String || <code>kakarot</code> || 2D aura sprite set: <code>kakarot</code> or <code>god</code>.
|-
| <code>auraType3D</code> || String || <code>userPreference</code> || 3D aura style: <code>smooth</code>, <code>sparking</code>, <code>god</code> or <code>userPreference</code> (each player's own setting). A form that names <code>god</code> shows it for any race; as a player preference it is Glind-only.
|-
| <code>auraColor</code> || Hex string || <code>""</code> || Aura color. Empty keeps the player's aura color.
|-
| <code>auraLayer</code> || Integer || <code>0</code> || Aura layer slot. Forms on different layers show separate auras at the same time (the Kaioken forms use layer <code>1</code>).
|-
| <code>aura3DStyle</code> || Object || See below || Shape of the 3D aura (see [[Special:MyLanguage/Custom Forms#3D aura shape|3D aura shape]]).
|-
| <code>extraAuraType</code>, <code>extraAuraType3D</code>, <code>extraAuraColor</code>, <code>extraAuraLayer</code>, <code>extraAura3DStyle</code> || — || <code>kakarot</code>, <code>userPreference</code>, <code>#FFFFFF</code>, <code>-1</code>, defaults || A second aura. <code>extraAuraLayer</code> must be <code>1</code>–<code>6</code> to show; <code>-1</code> means none.
|-
| <code>hasLightnings</code>, <code>lightningColor</code> || Boolean / Hex || <code>false</code>, <code>""</code> || Lightning bolts around the player.
|-
| <code>modelScaling</code> || <code>[x, y, z]</code> floats || <code>[0.9375, 0.9375, 0.9375]</code> || Model scale factors.
|-
| <code>tintColor</code>, <code>tintIntensity</code> || Hex / Double || <code>#FF0000</code>, <code>0.0</code> || Color tint over the player while transformed. <code>0</code> means no tint.
|-
| <code>outlineShader</code> || Object || — || <code>enabled</code> (<code>false</code>), <code>primaryColor</code> (<code>#7FFFFF</code>), <code>secondaryColor</code>, <code>outlineThickness</code> (<code>1.5</code>).
|}

=== 3D aura shape ===
These keys go inside <code>aura3DStyle</code> and <code>extraAura3DStyle</code> (and inside a race's <code>aura3DStyle</code> in <code>character.json</code>). Every key is optional; a missing key uses the default.

{| class="wikitable"
! Key !! Default !! What it does
|-
| <code>size</code> || <code>[1.10, 1.17, 1.02]</code> || Width, height and depth of the aura shell.
|-
| <code>flamePeaks</code> || <code>12</code> || Number of flame tongues around the shell (1–64). Smooth style only.
|-
| <code>waveFrequency</code>, <code>waveSpeed</code>, <code>waveAmplitude</code> || <code>2.0</code>, <code>5.0</code>, <code>0.75</code> || Flame waves. In the sparking style, <code>waveAmplitude</code> is the spike reach and <code>waveSpeed</code> is the surge speed.
|-
| <code>noiseDetail</code>, <code>upwardBias</code> || <code>0.10</code>, <code>0.54</code> || Flame turbulence, and how strongly it flows upwards.
|-
| <code>coreAlpha</code>, <code>rimAlpha</code>, <code>rimPower</code>, <code>rimThreshold</code> || <code>0.05</code>, <code>1.0</code>, <code>4.0</code>, <code>0.05</code> || Opacity of the center and of the edge.
|-
| <code>coreColor</code>, <code>rimColor</code>, <code>noiseColor</code> || <code>""</code> || Hex colors. Empty means derived from the aura color.
|-
| <code>secondBorderColor</code> || <code>""</code> || Hex color of an outer fringe around the edge. Sparking style only; empty means no fringe.
|-
| <code>bloomIntensity</code> || <code>1.0</code> || Glow strength.
|-
| <code>spikeDensity</code>, <code>spikeBurstRate</code>, <code>spikeRarity</code>, <code>bandStart</code> || <code>32</code>, <code>3.0</code>, <code>3.0</code>, <code>0.50</code> || Sparking style only: spike columns (4–32), burst rate, how rare spikes are, and where the outline band starts.
|}

=== Stats and drains ===

{| class="wikitable"
! Field !! Type !! Default !! What it does
|-
| <code>strMultiplier</code>, <code>skpMultiplier</code>, <code>stmMultiplier</code>, <code>defMultiplier</code>, <code>vitMultiplier</code>, <code>pwrMultiplier</code>, <code>eneMultiplier</code>, <code>speedMultiplier</code> || Double || <code>1.0</code> || Stat multipliers. RES uses the average of <code>defMultiplier</code> and <code>stmMultiplier</code>. A race form and a stack form add their bonuses together, or multiply them if <code>multiplicationInsteadOfAdditionForMultipliers</code> is on in <code>general-server.json</code>.
|-
| <code>attackSpeed</code> || Double || <code>1.0</code> || Attack speed multiplier.
|-
| <code>energyDrain</code>, <code>staminaDrain</code>, <code>healthDrain</code> || Double || <code>0.0</code> || Drain while transformed (also used for the cost of transforming). Values below <code>0</code> are treated as <code>0</code>.
|-
| <code>staminaDrainMultiplier</code> || Double || <code>1.0</code> || Multiplier on the stamina each attack costs while transformed.
|-
| <code>otherworldTimeDrain</code>, <code>otherworldTimeDrainMastered</code> || Double || <code>1.0</code>, <code>1.0</code> || How fast this form drains Baba's temporary-revive timer, at 0 mastery and at full mastery (blended in between). See [[Special:MyLanguage/Otherworld|Otherworld]].
|}

=== Mastery ===

{| class="wikitable"
! Field !! Type !! Default !! What it does
|-
| <code>maxMastery</code> || Double || <code>100.0</code> || Maximum mastery (<code>0</code> means no mastery progression).
|-
| <code>masteryPerHitDealt</code>, <code>masteryPerHitReceived</code> || Double || <code>0.01</code> || Mastery gained per hit.
|-
| <code>passiveMasteryEveryFiveSeconds</code> || Double || <code>0.001</code> || Passive mastery gained every 5 seconds in the form.
|-
| <code>maxStatsMultiplier</code> || Double || <code>1.25</code> || At full mastery, stat multipliers above <code>1</code> are multiplied by this (scales up linearly with mastery).
|-
| <code>maxCostMultiplier</code> || Double || <code>0.5</code> || At full mastery, the form's drains are multiplied by this (scales linearly with mastery).
|-
| <code>stackOnMastery</code> || Double || <code>0.0</code> || Mastery this form needs before it can be combined with a stack form (or, for a stack form, with a race form).
|-
| <code>instantTransformOnMastery</code> || Double || <code>40.0</code> || Mastery this form needs for instant transformation (no charge, costs ki).
|-
| <code>allowFreeTransformOnMastery</code> || Double || <code>50.0</code> || Mastery this form needs before you can transform straight into it instead of going through the group in order. The group's first unlocked form never needs it.
|-
| <code>shareMasteryWith</code>, <code>shareMasteryMultiplier</code> || List / Double || <code>[]</code>, <code>1.0</code> || Whenever this form gains mastery, each listed form (<code>"group.form"</code>) gains that amount × <code>shareMasteryMultiplier</code>. The default Kaioken forms share 25% with the next one up.
|}

=== Stacking behavior ===

{| class="wikitable"
! Field !! Type !! Default !! What it does
|-
| <code>formStackable</code> || Boolean || <code>true</code> || Both the race form and the stack form must allow stacking.
|-
| <code>stackDrainMultiplier</code> || Double || <code>2.0</code> || While a race form and a stack form are combined, the drains of both forms are multiplied by the <code>stackDrainMultiplier</code> of both forms.
|-
| <code>incompatibleWith</code> || List of <code>"group.form"</code> || <code>["ultimate.ultimate"]</code> || Forms that cannot be active at the same time as this one (checked both ways). On a race form, listing <code>ultimate.ultimate</code> also keeps the Ultimate form from copying it as your best form; DragonMineZ's own forms only list it on each race's top tier.
|-
| <code>formCombo</code> || String || <code>""</code> || Weapon attributes id used for melee combos while in this form, for example <code>dragonminez:giant</code> for giant forms. A bare name is looked up under <code>dragonminez:</code>, then <code>minecraft:</code>. See [[Special:MyLanguage/Weapon Attributes|Weapon Attributes]].
|}

=== Costs and effects ===

{| class="wikitable"
! Field !! Type !! What it does
|-
| <code>triggerItemCosts</code> || List of <code>{ itemId</code> or <code>itemTag, nbt, count, consume }</code> || Items needed to transform. Entries are alternatives: the first one the player can pay is used. <code>count</code> defaults to <code>1</code> and <code>consume</code> to <code>true</code>. <code>itemTag</code> is a tag id without <code>#</code>. Creative players skip it.
|-
| <code>durationItemCosts</code> || List of <code>{ itemId</code> or <code>itemTag, nbt, durationSeconds }</code> || Items that keep the form going: one item buys <code>durationSeconds</code> (default <code>1</code>) of form time. When none is left, the form ends.
|-
| <code>mobEffects</code> || List of <code>{ effectId, amplifier, durationTicks, ambient, visible, showIcon }</code> || Potion effects applied while transformed. <code>durationTicks</code> <code>-1</code> (the default) means as long as the form lasts.
|}

== Translation keys ==
Stack form groups and forms are named with these keys:

<syntaxhighlight lang="text">
race.dragonminez.stack.group.<groupName> # e.g. "race.dragonminez.stack.group.kaioken" -> "Kaioken"
race.dragonminez.stack.form.<groupName>.<name> # e.g. "race.dragonminez.stack.form.kaioken.x2" -> "x2"
</syntaxhighlight>

Add these to your <code>en_us.json</code> or to your own language file. Custom translations merge with the Crowdin ones in the same way as for [[Special:MyLanguage/Custom Races#Step 4: Add translation keys|custom races]].

== Reload and validate ==
# Save your file under <code>config/dragonminez/forms/</code>.
# Validate the JSON syntax (see [[Special:MyLanguage/How to JSON|How to JSON]]).
# Run <code>/dmzreload config</code> (see [[Special:MyLanguage/Reloading and Updating Changes|Reloading and Updating Changes]]).
# Transform in game and check that stats, drains, visuals and stacking behave as expected.

{{Navbox Modding}}

Custom Forms/en - Revision history

FuzzyBot: Updating to match new version of source page

FuzzyBot: Updating to match new version of source page