Configuration Overview
Main configuration files
The plugin uses 6 distinct configuration files inmods/Zuxaw_RPGLeveling/:
- RPGLevelingConfig.json — Main plugin configuration (XP rates, max level, difficulty preset, toggles)
- StatsLevelConfig.json — Stat-related configuration (stat points, stat values, max allocations)
- ZoneLevelConfig.json — Zone level mapping and entity overrides
- InstanceLevelConfig.json — Instance/dungeon level mapping and entity overrides
- LevelRewardsConfig.json — Level-based rewards (items and reset points), claimable in the Rewards tab
- MessagesLanguageMapping.json — Translation/localization strings
mods/Zuxaw_RPGLeveling/Classes/: ClassHeavy.json, ClassBlunt.json, etc., plus PassivesConfig.json and ClassesGlobalConfig.json. See Classes configuration and Passives configuration.
Quick Tips
- Faster progression — Increase
RateExporBaseXPin RPGLevelingConfig.json - Slower progression — Decrease
RateExporBaseXPin RPGLevelingConfig.json - More stat points — Increase
StatPointsPerLevelin StatsLevelConfig.json - Stronger stats — Increase
StatValuePerPointin StatsLevelConfig.json - Difficulty — Use
DifficultyPresetin RPGLevelingConfig.json (easy / normal / hard / extreme) - Custom translations — Edit MessagesLanguageMapping.json to translate all plugin text
- Zone level mapping — Edit ZoneLevelConfig.json to customize zone level ranges
- Dungeon levels — Edit InstanceLevelConfig.json to set level ranges for instances/dungeons
- Disable mod per world/instance — In InstanceLevelConfig.json, set
DisableRPGLevelingtotruefor an instance to turn off HUD, XP, scaling, and stats there. See Disable mod for a specific world/instance. - Level rewards — Edit LevelRewardsConfig.json to define items and reset points per level (Rewards tab in GUI)
- Classes & passives — Edit JSON in
mods/Zuxaw_RPGLeveling/Classes/to customize classes, passives, and weapon kinds. See Classes config, Passives config.
Config File Locations
All configuration files are located in:mods/Zuxaw_RPGLeveling/
mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json— Main configurationmods/Zuxaw_RPGLeveling/StatsLevelConfig.json— Stat configurationmods/Zuxaw_RPGLeveling/MessagesLanguageMapping.json— Translation stringsmods/Zuxaw_RPGLeveling/ZoneLevelConfig.json— Zone level mappingmods/Zuxaw_RPGLeveling/InstanceLevelConfig.json— Instance/dungeon level mappingmods/Zuxaw_RPGLeveling/LevelRewardsConfig.json— Level rewards (items and reset points)mods/Zuxaw_RPGLeveling/Classes/— Class files (ClassHeavy.json, etc.), PassivesConfig.json, ClassesGlobalConfig.json (0.3.0)
Reloading config
To apply config changes without restarting the server, use/lvl reload (admin/OP). See Commands.
| Config file | Reloaded by /lvl reload? |
|---|---|
| ZoneLevelConfig.json | Yes |
| InstanceLevelConfig.json | Yes |
| LevelRewardsConfig.json | Yes |
| MessagesLanguageMapping.json | Yes |
| RPGLevelingConfig.json | Yes |
| StatsLevelConfig.json | Yes |
| DatabaseConfig.json | Yes (in-memory only; DB connection unchanged until restart) |
/lvl reload to pick up changes. For DatabaseConfig: enabling/disabling sync or changing JDBC URL still requires a server restart to apply the new connection.
Migration from 0.1.9
⚠️ Manual Migration Required: When updating from 0.1.9 to 0.2.0, you will need to manually migrate your config values from the old location (mods/RPGLeveling/) to the new location (mods/Zuxaw_RPGLeveling/). Many configuration options have changed, so please review the documentation carefully and copy only the values you want to keep. The plugin will generate new default config files on first run.
For future updates: The plugin updates config files automatically when you install a new version (see Config migrations). Before changing anything, it saves a backup with the suffix .pre-migration so you can restore if needed. Your custom values are preserved where possible. If something goes wrong after an update, see Troubleshooting — Config after an update.