FuzzyBot: Updating to match new version of source page

2026-10-13T05:34:08Z

Updating to match new version of source page

New page

DragonMineZ is configured through JSON files that server owners, singleplayer hosts and add-on authors can edit. Most of them live in the <code>config/dragonminez</code> folder of the game or server instance and are generated the first time DMZ boots; story, wish and NPC data lives inside each world save instead. The server sends its config files to every player who joins, so on a server everyone plays with the server's values.

This section of the wiki documents every config file, the gamerules and permission nodes DMZ adds, and how to apply and keep your changes safely.

<div class="dmz-cards">
{{Card|General Server Config|Progression, TP, world generation, the story, racial skills, world bosses and storage.}}
{{Card|General User Config|Personal client settings: HUD behavior, cameras, auras and tutorials.}}
{{Card|Combat Config|Blocking, parrying, mitigation, Speed, Ki Surge, combat flight and ki weapons.}}
{{Card|Skills Config|Skill costs, which master teaches what, and technique tuning.}}
{{Card|Entities Config|Base stats of DMZ creatures and saga enemy transformations.}}
{{Card|Gravity Config|Dimension gravity, the Gravity Device and weight training zones.}}
{{Card|Dynamic Growth|Practice-based stat growth and its anti-farming rules.}}
{{Card|Gamerules|Ki-griefing and building protection for terrain and arenas.}}
{{Card|Permissions|Every command permission node and how checks resolve.}}
{{Card|Notice to Server Owners|Backups, updates and multiplayer advice before you edit anything.}}
{{Card|Reloading and Updating Changes|What /dmzreload covers and how DMZ updates upgrade your files.}}
</div>

== Where config lives ==
{{See also|Locating Specific Folders}}
The <code>config/dragonminez/</code> folder belongs to the instance, not to a world: every world played on that instance uses the same files. Except for the client-only files marked below, the server sends every file in this folder to joining clients.

{| class="wikitable"
! File !! What it holds !! Documented on
|-
| <code>general-server.json</code> || Server-wide gameplay settings: progression, TP, world generation, the story, racial skills, Dynamic Growth, gravity, world bosses, storage. || {{L|General Server Config}}
|-
| <code>general-user.json</code> || '''Client-only.''' Personal client settings, never sent by the server. || {{L|General User Config}}
|-
| <code>hud_layout.json</code> || '''Client-only.''' HUD style and element layout, written by the HUD editor. || {{L|HUD}}
|-
| <code>radial_layout.json</code> || Client-side order of the entries in the radial menus, saved when you reorder them. ||
|-
| <code>combat.json</code> || Combat tuning values. || {{L|Combat Config}}
|-
| <code>skills.json</code> || Skill costs and eligibility, and which master offers which skill. || {{L|Skills Config}}
|-
| <code>techniques.json</code> || Ki attack, strike and evasion technique tuning. || {{L|Skills Config}}
|-
| <code>training.json</code> || Training minigame tuning. || {{L|Training Points and Mastery}}
|-
| <code>entities.json</code> || Base stats per entity and saga transformation defaults. || {{L|Entities Config}}
|-
| <code>races/<race>/character.json</code> || Race identity and appearance defaults. || {{L|Custom Races}}
|-
| <code>races/<race>/stats.json</code> || Race base stats and scaling per class. || {{L|Custom Races}}
|-
| <code>races/<race>/forms/*.json</code> || Forms that belong only to that race. || {{L|Custom Forms}}
|-
| <code>forms/*.json</code> || Shared stack forms layered on top of a race's own forms. || {{L|Custom Forms}}
|-
| <code>raids/*.json</code> || Raid definitions. || {{L|Raids}}
|-
| <code>tournaments/*.json</code> || Tournament definitions. || {{L|Tournaments}}
|-
| <code>oldBackup/</code> || Copies of config files DMZ upgraded or regenerated, in the same relative layout (for example <code>oldBackup/races/saiyan/stats.json</code>). DMZ never reads them back. || {{L|How to JSON}}
|}

The default races generated in <code>races/</code> are <code>human</code>, <code>saiyan</code>, <code>namekian</code>, <code>frostdemon</code>, <code>bioandroid</code>, <code>majin</code> and <code>glind</code>. Any other folder under <code>races/</code> is loaded as a custom race.

Gameplay rules that aren't JSON files are covered on [[Special:MyLanguage/Gamerules|Gamerules]] (ki-griefing and arena building) and [[Special:MyLanguage/Permissions|Permissions]] (who can run each command). The per-world folders (sagas, quests, side quests, wishes, dialogues, NPC placements and JSON player data) are listed on [[Special:MyLanguage/Locating Specific Folders|Locating Specific Folders]].

== How config reaches the clients ==
{{Main|Reloading and Updating Changes}}
* When a player joins, the server sends them every file under <code>config/dragonminez</code> except <code>general-user.json</code> and <code>hud_layout.json</code>. While connected, the client uses the server's values for everything those files control.
* The server sends the files as they are on disk. After editing a file, always run <code>/dmzreload config</code>; until you do, the server keeps running the old values while players who join afterwards already receive the edited file.
* <code>/dmzreload config</code> and <code>/dmzconfig</code> resend the files to everyone online.
* On disconnect, the client drops the server's copy and goes back to its own local files.

== Editing config safely ==
{{See also|How to JSON|Notice to Server Owners}}
* Keep the files valid JSON. A file with a syntax error is never overwritten: DMZ runs on that file's defaults for the session and reports the file, line and column in the log (and in chat on login).
* Don't edit <code>configVersion</code>. DMZ uses it to upgrade the file after a mod update: the old file is moved to <code>oldBackup/</code>, new defaults are written, and the values you changed are merged back in.
* Comments and notes inside the files are removed whenever DMZ rewrites them, so keep your notes elsewhere.
* Take your own backup before bulk edits on a live server.

{{Navbox Configuration}}

Configuration/en - Revision history

FuzzyBot: Updating to match new version of source page