Skip to main content

​
Zone Level Config

File: mods/Zuxaw_RPGLeveling/ZoneLevelConfig.json This file maps zone IDs to their level ranges and defines per-entity overrides (e.g. bosses with higher levels than the zone max, or entities that ignore level scaling).

​
File Structure

The file structure includes:
  • Zone data — Zone ID/name, min/max level ranges, biome-to-zone remaps
  • Entity overrides — Per-NPC-type level overrides and optional disabling of level scaling

​
Zone Configuration Fields

Zones are defined under the top-level Zones array with PascalCase keys:
FieldTypeDescription
IdIntegerZone ID number (HUD shows “Zone 1”, “Zone 2”, etc.)
LevelMinIntegerMinimum monster level for this zone
LevelMaxIntegerMaximum monster level for this zone
ZoneRateExpDouble (optional)Per-zone XP multiplier. All XP gained in this zone (mob kills and block break) is multiplied by this value. Default 1.0 (no change). Use 2.0 to double XP in the zone, 0.5 to halve it.
MissingBiomeIdsArray of StringsBiome IDs/names that should be treated as this zone for mob leveling + HUD zone display (zone remap). Useful for special/modded biomes where Hytale reports a different zone number than you want.

​
Default Zones

The plugin includes 6 default zones:
ZoneNameMonster LevelsBest For
1Emerald Grove1 – 25Early game (Level 1–30)
2Howling Sands25 – 50Mid game (Level 20–55)
3Borea50 – 75Late game (Level 45–80)
4Devastated Lands75 – 100End game (Level 70–100)
5Skylands85 – 100Max level
6Poisonlands90 – 100Ultimate challenge
Monster level variation: Monsters in a zone have ±5 level variation around their base level. See Formulas for XP gain by zone.

​
Custom Modded Biomes

If you have modded or special biomes, you can add their biome IDs/names to the MissingBiomeIds array of the zone you want them to behave like. When mobs/players are inside that biome, the plugin will treat the biome as that zone (this affects mob levels and the HUD zone number). Example: If the biome name is ForgottenTemple but Hytale reports it as zone 4, you can put ForgottenTemple in zone 6’s MissingBiomeIds to make it behave like zone 6 (and show zone 6 in the HUD). 
{
  "Id": 6,
  "LevelMin": 90,
  "LevelMax": 100,
  "MissingBiomeIds": ["ForgottenTemple", "CustomBiome_Ancient"]
}

​
Entity Overrides (Boss Levels)

You can force specific NPC type IDs (e.g. bosses) to a fixed level and optionally disable their bonus stats per level (damage/HP scaling, gap bonuses, level-based XP). Entity overrides live under the top-level EntityOverrides array:

​
Entity Override Fields

FieldTypeDescription
EntityIdStringNPC type ID (e.g. Bear_Grizzly_Boss), same ID used in logs and blacklists
LevelIntegerFixed level to use for this entity (can exceed the zone max, e.g. 150)
DisableLevelScalingBooleanIf true, this entity ignores all bonus stats per level from the mod: no monster damage/HP scaling from level, no gap damage bonus, no gap defense, and XP for this entity uses the old HP-based formula (only mob max HP). If false or omitted, level-based scaling still applies, but uses the overridden level.
XPDouble (optional)Precise XP amount to award when killing this entity. If set, this exact XP is awarded regardless of level, HP, level gap, or other XP settings. Still multiplied by RateExp (RPGLevelingConfig) and the zone’s ZoneRateExp. If omitted or null, uses normal XP calculation (level-based or HP-based depending on config).

​
Example Config

{
  "Version": "0.2.0",
  "Zones": [
    {
      "Id": 1,
      "LevelMin": 1,
      "LevelMax": 25,
      "ZoneRateExp": 1.0,
      "MissingBiomeIds": []
    },
    {
      "Id": 2,
      "LevelMin": 25,
      "LevelMax": 50,
      "ZoneRateExp": 1.0,
      "MissingBiomeIds": []
    },
    {
      "Id": 6,
      "LevelMin": 90,
      "LevelMax": 100,
      "ZoneRateExp": 1.0,
      "MissingBiomeIds": ["ForgottenTemple"]
    }
  ],
  "EntityOverrides": [
    {
      "EntityId": "Bear_Grizzly_Boss",
      "Level": 150,
      "DisableLevelScaling": true,
      "XP": 10000.0
    },
    {
      "EntityId": "Dragon_Elder",
      "Level": 120,
      "DisableLevelScaling": false,
      "XP": 50000.0
    }
  ],
  "_comment": "If you have modded/special biomes, list them in MissingBiomeIds under the zone you want them to behave like. You can also use EntityOverrides to force specific NPC IDs to a fixed level and optionally disable bonus stats per level."
}

​
Use Cases

​
Boss with Fixed Level and XP

Force a boss to be level 150 with fixed XP reward, ignoring all level scaling: 
{
  "EntityId": "MyBoss_NPC_Id",
  "Level": 150,
  "DisableLevelScaling": true,
  "XP": 5000.0
}

​
Boss with Custom Level (But Keep Scaling)

Set a boss to level 80, but keep level-based damage/HP scaling: 
{
  "EntityId": "Bear_Grizzly",
  "Level": 80,
  "DisableLevelScaling": false,
  "XP": 5000.0
}

​
Remap Modded Biome to Zone

Make a custom biome behave like zone 6: 
{
  "Id": 6,
  "LevelMin": 90,
  "LevelMax": 100,
  "MissingBiomeIds": ["CustomModdedBiome", "AnotherBiome"]
}

​
File location and reload

​
See Also