Features
Core Systems
- Experience Gain - XP from mob kills based on monster level and level difference (not max health)
- Mining and Woodcutting XP - XP when breaking ore/mineral (mining) and log/tree (woodcutting) blocks, scaled by player level, zone level bonus (per-zone factor in Zone Config), and RateExp; XP is awarded via the API so listeners apply. See Formulas and Main Config.
- Zones - 6 zones with monster level ranges; HUD shows zone name and color (green / white / orange–red–purple)
- Monster level variation - ±5 levels per monster in a zone
- Level Progression - Level up by accumulating XP
- Stat Points - Earn stat points each level (configurable)
- Stat Allocation - Distribute points across stats
- Stat Modifiers - Allocated stats apply as permanent modifiers
- Death Penalty - Optional reset to level 1 on death (disabled by default)
- HUD Display - Level, XP progress, and zone + color
- GUI - Stat management and sidebar navigation
- Leaderboard - Top 100 players by level/XP; Gold/Silver/Bronze for top 3
- Difficulty Scaling - Monster damage/HP scale with level; level-gap penalties (see Difficulty Scaling)
- Translation - Multi-language support via
mods/Zuxaw_RPGLeveling/MessagesLanguageMapping.json - Database Sync - Sync player data (level, XP, stats) to an external database (H2, MySQL, MariaDB, PostgreSQL). One-way sync: game → DB. See Database Sync.
- Configurable - Progression, formulas, and difficulty presets via JSON
Available Stats
| Stat | Effect |
|---|---|
| Health | Increases maximum health |
| Stamina | Increases maximum stamina |
| Mana | Increases maximum mana |
| Ammo | Increases ammo capacity |
| Oxygen | Increases oxygen (underwater) |
| StaminaRegenSpeed | Faster stamina regeneration |
| StaminaConsumption | Reduces stamina consumption |
| Damage | Increases damage to NPCs (multiplicative, configurable) |
| Mining | Damage to stone/ore blocks (configurable) |
| Woodcutting | Damage to wood blocks (configurable) |
| Defense | Reduces damage taken (%, diminishing returns; max 80%) |
StatValuePerPoint, DamageStatValuePerPoint, etc.