Main Plugin Config

File: mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json The main configuration file for the RPG Leveling plugin. Controls XP rates, max level, difficulty preset, and core gameplay toggles.

Configuration Options

Option	Type	Default	Description
`MaxLevel`	Integer	100	Maximum level players can reach
`RateExp`	Double	3.0	Global XP multiplier (1.0 = normal, 2.0 = double XP)
`BaseXP`	Double	1.0	Base XP multiplier for mob kills (used in XP formula)
`LevelBaseXP`	Double	150.0	Base value for level XP requirement formula
`LevelOffset`	Double	0.0	Offset for level XP requirement formula
`EnableHUD`	Boolean	true	Enable or disable the level XP progress HUD
`EnableClassHud`	Boolean	true	Enable the class mini HUD (portrait, level, and Open Stats key; class name, tier, and objective when a class is selected). Requires classes enabled.
`ClassHudPosition`	String	`"bottom_left"`	Default class HUD corner: `bottom_left`, `bottom_right`, `top_left`, `top_right`. `bottom_right` already leaves room for the client keybind hints (Inventory, Map, Creative Tools). Players can override it in Settings.
`LevelHudPosition`	String	`"above"`	Default XP bar placement relative to the hotbar: `above` or `below`. With `below`, the XP line is drawn under the bar because the strip under the hotbar is thin. Players can override it in Settings.
`ClassHudOffsetX`	Integer	0	Horizontal nudge for the class HUD, in UI units. Positive moves it toward the middle of the screen, negative toward the screen side it hugs. See HUD placement.
`ClassHudOffsetY`	Integer	0	Vertical nudge for the class HUD, in UI units. Positive moves it away from the top or bottom edge it hugs.
`LevelHudOffsetY`	Integer	0	Vertical nudge for the XP bar, in UI units. Positive moves it up.
`EnableGuiOpenHotkey`	Boolean	true	Let players open the Stats GUI with Walk (vanilla default Alt) plus a hotbar number (Alt+1 … Alt+9). The hotbar swap is cancelled so the weapon does not change. Each player can turn it off and pick a different combo in Settings. Works in singleplayer and on a dedicated server, on the ground only (Hytale limitation). See Quick open key.
`GuiOpenHotkeySlot`	Integer	`1`	Hotbar slot (1-9) used with Walk. Default 1 is Alt+1. Endless Leveling uses slots 1-7 for its own menus, so set this to 8 or 9 if both mods run on the same server.
`Debug`	Boolean	false	Enable debug logging
`ResetLevelOnDeath`	Boolean	false	Reset player level to 1 on death (hardcore mode)
`BlacklistedEntities`	String	`""`	Comma-separated entity type IDs (e.g. `Bear_Grizzly`) that give no XP and no level display when killed or looked at
`BlacklistedEntityRoles`	String	`"Citizen_"`	Comma-separated role name substrings for NPCs excluded from leveling: no level display, no HP/damage scaling, no XP. NPCs with the NPCEntity component whose role name contains any of these strings (e.g. `Citizen_`) are treated as non-leveled. Use for Citizen mod NPCs (dialogue, traders). See Entity role blacklist.
`EnablePVPXp`	Boolean	false	If `true`, killing a player awards XP. If `false`, no XP from PvP kills
`DifficultyPreset`	String	”normal”	`"easy"`, `"normal"`, `"hard"`, or `"extreme"`
`EnableMonsterLevelScale`	Boolean	true	If `true` (default), monster level scaling is enabled (damage/HP per level, gap damage/defense, level-based XP). HP scaling is the primary toughness mechanic, so your damage stays consistent while higher-level mobs simply have bigger HP pools. If `false`, all monster level scaling is disabled and XP reverts to the old HP-based system (only mob max HP), while level display still works. See Difficulty Scaling.
`EnableGapLevelDefense`	Boolean	true	If `true`, level-gap defense applies (you deal less damage when underleveled). If `false`, gap defense is disabled - your damage to monsters is not reduced by level gap, letting HP scaling alone handle the toughness while your stat upgrades feel more impactful. See Difficulty Scaling.
`EnableGapLevelDamageToPlayer`	Boolean	true	If `true`, level-gap damage applies (monsters deal extra damage when above your level). If `false`, gap damage to player is disabled - monsters do not get bonus damage from level gap. See Difficulty Scaling.
`EnableGapLevelXpReducer`	Boolean	true	If `true`, XP is reduced when you are underleveled (monster level above yours). If `false`, no XP reduction for being underleveled - you get full XP from higher-level monsters. See Formulas level-difference table and Difficulty Scaling.
`EnableNameplateLevelDisplay`	Boolean	true	If `true` (default), nameplates can show level; if `false`, no nameplate is modified (players or monsters).
`EnablePlayerLevelNameplate`	Boolean	true	If `true` (default), player nameplates show level (e.g. “Username [Lvl. X]”). If `false`, only player nameplates are left unchanged; monster level still shows when you look at them.
`EnableNotification`	Boolean	true	If `true` (default), notifications are sent (XP gain, level up, stat points earned, death penalty, zone warnings, entity killed, critical hits, class tier-up subtitle, etc.). If `false`, no notifications are sent.
`EnablePassiveNotifications`	Boolean	true	Only applies when `EnableNotification` is `true`. If `true` (default), class passive proc popups are shown (heal/buff/damage effect lines, Hunter’s Mark proc, on-kill timed buffs like Overkill). If `false`, those passive-only popups are hidden; XP, level up, crits, entity killed, tier-up subtitle, zone warnings, etc. are unchanged.
`EnableCurrentZoneHudDisplay`	Boolean	true	If `true` (default), HUD shows level plus current zone/biome (e.g. “Lvl 5	Zone 1 Emerald Grove”). If `false`, HUD shows only level and XP progress bar.
`BlacklistedXPBlocks`	String	`"Tw_Feed_Carnivore,Tw_Feed_Herbivore"`	Comma-separated block type IDs excluded from mining/woodcutting XP. Case-insensitive exact match (same style as `BlacklistedEntities`). See Block XP blacklist.
`EnableTameXP`	Boolean	`true`	If `true`, taming a creature awards RPG XP. See Tame XP.
`TameXpMultiplier`	Double	`1.0`	Multiplier on tame XP (uses the same formula as mob kills).
`BlacklistedTameEntityRoles`	String	`"Citizen_"`	Comma-separated role name substrings for tamed NPCs that grant no tame XP (same contains / case-insensitive style as `BlacklistedEntityRoles`).

XP and Leveling

0.2.0 note: XP from mobs is based on monster level and level difference. RateExp and BaseXP still apply as multipliers. See Formulas for the complete math.

XP Rate Multiplier

RateExp - Global XP multiplier applied to all XP gains
- 1.0 = normal XP
- 2.0 = double XP
- 3.0 = triple XP (default)
Admin timed XP boost - Operators can run /lvl xprateboost (see Commands) for a server-wide or per-player multiplier over a duration. That multiplier is applied on top of this config (and zone rates): e.g. RateExp 3 plus timed ×2 ⇒ 6× vs the formula baseline, not 5×.

Level Requirements

Level XP requirements use this formula:

XP_required = LevelBaseXP × level^2.5 + LevelOffset   (level ≥ 2)
XP_required(1) = 0

LevelBaseXP - Base multiplier for the level curve (exponent 2.5; default: 150.0)
LevelOffset - Added to total XP per level.

To multiply XP earned while the player is in a specific level range (e.g. 3× XP at levels 80–100), use XPCurveOverridesConfig.json. See Formulas for examples and progression tables.

Difficulty Scaling

0.2.0 changes: Difficulty scaling settings are now in the main config file. Difficulty scaling is always enabled and controlled via the DifficultyPreset setting.

Difficulty Presets

Preset	Monster→Player Dmg/Lvl	HP%/Lvl	Gap Dmg Mult	Gap Def Mult	Best For
EASY	+0.5%	+2%	×0.75	×0.75	New players
NORMAL	+1%	+3.25%	×1.0	×1.0	Default
HARD	+2%	+4.5%	×1.25	×1.25	Experienced
EXTREME	+4%	+6.5%	×1.5	×1.5	Hardcore

See Difficulty Scaling for complete details on monster damage, HP scaling, and level-gap mechanics.

Scaling Toggles

Fine-tune difficulty with these toggles:

EnableMonsterLevelScale - Master toggle for all level-based scaling (damage, HP, XP)
EnableGapLevelDefense - Toggle level-gap defense penalty (you → monster when underleveled)
EnableGapLevelDamageToPlayer - Toggle level-gap damage bonus (monster → you when underleveled)
EnableGapLevelXpReducer - Toggle XP reduction when fighting higher-level monsters

Death Penalty

Optional hardcore mode that resets progress on death:

ResetLevelOnDeath: true - Reset to level 1, lose all XP, clear stat allocations
ResetLevelOnDeath: false (default) - Keep level and stats on death

Entity Blacklist

Exclude specific entities from giving XP and showing level displays:

{
  "BlacklistedEntities": "Bear_Grizzly,Wolf_Alpha,Sheep"
}

Blacklisted entities:

Give no XP when killed
Show no level display when looked at
Are comma-separated entity type IDs

Entity role blacklist

Exclude NPC roles from leveling (no level display, no HP/damage scaling, no XP). This is based on the entity’s role name (NPCEntity component), not the entity type ID. Default: "Citizen_" - so NPCs whose role name contains Citizen_ (e.g. from the Citizen mod: dialogue, traders, quest givers) are not scaled and do not show level.

{
  "BlacklistedEntityRoles": "Citizen_,Villager_"
}

Role names are checked with contains (case-insensitive). Example: Citizen_Guard or MyCitizen_Type match the string Citizen_.
Blacklisted role NPCs: no level on nameplate, no HP scaling, no damage scaling, no XP when killed.
Leave as "Citizen_" to keep Citizen mod NPCs unaffected; set to "" to level all NPCs by role (no role blacklist).

Block XP blacklist

Exclude specific block type IDs from mining/woodcutting XP when players break them. Use this when a modded block matches ore/log/tree rules but should not be farmed for XP (for example Animal Husbandry feed troughs). Default: "Tw_Feed_Carnivore,Tw_Feed_Herbivore"

{
  "BlacklistedXPBlocks": "Tw_Feed_Carnivore,Tw_Feed_Herbivore"
}

List block type IDs, not item IDs. Enable "Debug": true, break the block once, and check the console for [BlockBreakXPSystem] Block broken: id="...".
IDs use case-insensitive exact match (same as BlacklistedEntities). tw_feed_carnivore and Tw_Feed_Carnivore are equivalent.
Blacklisted blocks give no XP when broken. Mining/woodcutting stat speed bonuses are unchanged.
Set to "" to allow XP from all eligible blocks (no block blacklist).
To disable all block-break XP, use EnableBlockXP: false in the same file (documented in 0.2.0 Main Config - Block XP).

Tame XP

Added in 0.3.9. When a player tames a creature (NPC role becomes Tamed_*), RPG Leveling can award XP using the same formula as mob kills (monster level, level gap, RateExp, zone rate, curve overrides).

Option	Default	Description
`EnableTameXP`	`true`	Master toggle for tame XP.
`TameXpMultiplier`	`1.0`	Multiplier applied after the kill formula (e.g. `2.0` = double tame XP).
`BlacklistedTameEntityRoles`	`"Citizen_"`	Role substrings that never grant tame XP (e.g. Citizen mod NPCs). Set to `""` to allow all roles.

Run /lvl reload after editing. Players see notifications.creature_tamed when a tame succeeds (see Messages Config).

PvP XP

Control whether player kills award experience:

EnablePVPXp: true - Killing players awards XP
EnablePVPXp: false (default) - No XP from player kills

HUD placement

ClassHudPosition and LevelHudPosition set the defaults players get before they touch the Settings tab, where each player can pick their own corner and XP bar side. The built-in placements already avoid the client HUD: the class panel lines up with the hotbar row (portrait and Open Stats key stay visible even with no class selected; class name, tier, and objective appear after you pick one), bottom_right keeps clear of the keybind hints (Inventory, Map, Creative Tools), and the XP bar sits above the hotbar or, with below, right under it with the XP line beneath the bar. If your players run an unusual resolution or UI scale and a HUD still sits too close to something, nudge it with ClassHudOffsetX, ClassHudOffsetY, and LevelHudOffsetY. Values are UI units (the same units as the layout files) and positive numbers push a HUD away from the screen edge it hugs, so ClassHudOffsetX: 40 moves the class panel 40 units further toward the middle of the screen. Negative values move it back toward the edge. Offsets apply to every player, on top of whatever corner they picked.

Quick open key

Hold Walk (vanilla default Alt) and press a hotbar key (Alt+1 … Alt+9). The plugin sees Walk from the movement packet, then intercepts the hotbar swap (or a same-slot re-select), cancels it, and opens the Stats GUI. Your weapon does not change. This works in singleplayer and on a dedicated server, even when you are already on that slot. The shortcut only works while you are standing on the ground. It does not fire while you are flying, jumping, or otherwise off the ground. That is a Hytale limitation for now. Land first, or open the GUI with /lvl gui. Default: Alt+1 (GuiOpenHotkeySlot: 1). Players pick a different combination in the Stats GUI Settings tab (Alt+1 through Alt+9). That choice is saved with their other preferences. Hiding the class HUD does not turn the combo off. Players can disable the key entirely with the Settings enable/disable buttons (HideGuiHotkey). If Endless Leveling is also installed, it uses Alt+1 through Alt+7 for its own menus. Set GuiOpenHotkeySlot to 8 or 9 (and ask players to pick the same slot) so the two mods do not fight over the same number. Walk can be remapped in Hytale Settings > Controls. The combo still works with that remapped Walk key, but the class HUD always shows ALT+N because the server cannot read the client’s Walk bind. There is no Ability 2 / E fallback. Older builds that claimed Ability 2 clear that claim on the next sync so E works as a normal combat action again.

Example Config (Default Values)

{
  "MaxLevel": 100,
  "RateExp": 3.0,
  "BaseXP": 1.0,
  "LevelBaseXP": 150.0,
  "LevelOffset": 0.0,
  "EnableHUD": true,
  "EnableClassHud": true,
  "ClassHudPosition": "bottom_left",
  "LevelHudPosition": "above",
  "ClassHudOffsetX": 0,
  "ClassHudOffsetY": 0,
  "LevelHudOffsetY": 0,
  "EnableGuiOpenHotkey": true,
  "GuiOpenHotkeySlot": 1,
  "Debug": false,
  "ResetLevelOnDeath": false,
  "BlacklistedEntities": "",
  "EnablePVPXp": false,
  "DifficultyPreset": "normal",
  "EnableMonsterLevelScale": true,
  "EnableGapLevelDefense": true,
  "EnableGapLevelDamageToPlayer": true,
  "EnableGapLevelXpReducer": true,
  "EnableNameplateLevelDisplay": true,
  "EnablePlayerLevelNameplate": true,
  "EnableNotification": true,
  "EnablePassiveNotifications": true,
  "EnableCurrentZoneHudDisplay": true,
  "BlacklistedXPBlocks": "Tw_Feed_Carnivore,Tw_Feed_Herbivore"
}

File location and reload

Path: mods/Zuxaw_RPGLeveling/RPGLevelingConfig.json
This file is reloaded by /lvl reload. See Configuration Overview.

Getting Started

Guides

Classes & Passives

Usage

Mod Content

Configuration

Troubleshooting

For Developers

Changelog

Main Plugin Config

Main Plugin Config

Configuration Options

XP and Leveling

XP Rate Multiplier

Level Requirements

Difficulty Scaling

Difficulty Presets

Scaling Toggles

Death Penalty

Entity Blacklist

Entity role blacklist

Block XP blacklist

Tame XP

PvP XP

HUD placement

Quick open key

Example Config (Default Values)

File location and reload

See Also

​Main Plugin Config

​Configuration Options

​XP and Leveling

​XP Rate Multiplier

​Level Requirements

​Difficulty Scaling

​Difficulty Presets

​Scaling Toggles

​Death Penalty

​Entity Blacklist

​Entity role blacklist

​Block XP blacklist

​Tame XP

​PvP XP

​HUD placement

​Quick open key

​Example Config (Default Values)

​File location and reload

​See Also

Main Plugin Config

Configuration Options

XP and Leveling

XP Rate Multiplier

Level Requirements

Difficulty Scaling

Difficulty Presets

Scaling Toggles

Death Penalty

Entity Blacklist

Entity role blacklist

Block XP blacklist

Tame XP

PvP XP

HUD placement

Quick open key

Example Config (Default Values)

File location and reload

See Also