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:

Field	Type	Description
`Id`	Integer	Zone ID number (HUD shows “Zone 1”, “Zone 2”, etc.)
`LevelMin`	Integer	Minimum monster level for this zone
`LevelMax`	Integer	Maximum monster level for this zone
`ZoneRateExp`	Double (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.
`MissingBiomeIds`	Array of Strings	Biome 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.
`BlockXPZoneLevelFactor`	Double	Block XP zone bonus factor (default 0.005). Higher zones give more mining/woodcutting XP. Formula: `zoneMultiplier = 1.0 + (zoneLevelMid - 1) × BlockXPZoneLevelFactor`, capped at 1.5.

Default Zones

The plugin includes 6 default zones:

Zone	Name	Monster Levels	Best For
1	Emerald Grove	1 – 25	Early game (Level 1–30)
2	Howling Sands	25 – 50	Mid game (Level 20–55)
3	Borea	50 – 75	Late game (Level 45–80)
4	Devastated Lands	75 – 100	End game (Level 70–100)
5	Skylands	85 – 100	Max level
6	Poisonlands	90 – 100	Ultimate challenge

Monster level variation: Monsters in a zone have ±5 level variation around their base level. See Formulas for XP gain by zone.

Block XP Zone Bonus

0.2.3+: Each zone can have its own BlockXPZoneLevelFactor to control how much bonus XP is awarded for mining/woodcutting in that zone:

{
  "Id": 4,
  "LevelMin": 75,
  "LevelMax": 100,
  "MissingBiomeIds": [],
  "BlockXPZoneLevelFactor": 0.008
}

Formula:

zoneMultiplier = 1.0 + (zoneLevelMid - 1) × BlockXPZoneLevelFactor

Where zoneLevelMid = (LevelMin + LevelMax) / 2, capped at 1.5× max.

Example Zone Multipliers

Zone	LevelMin-Max	ZoneLevelMid	Factor	Multiplier
Zone 1	1-15	8	0.005	1.035×
Zone 2	15-50	32	0.005	1.155×
Zone 3	50-75	62	0.005	1.305×
Zone 4	75-100	87	0.005	1.43×
Zone 4 (custom)	75-100	87	0.008	1.5× (capped)

Higher factor = more bonus XP in that zone. Set to 0 to disable zone bonus for a specific 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

Field	Type	Description
`EntityId`	String	NPC type ID (e.g. `Bear_Grizzly_Boss`), same ID used in logs and blacklists
`Level`	Integer	Fixed level to use for this entity (can exceed the zone max, e.g. 150)
`DisableLevelScaling`	Boolean	If `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.
`XP`	Double (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.5",
  "Zones": [
    {
      "Id": 1,
      "LevelMin": 1,
      "LevelMax": 25,
      "ZoneRateExp": 1.0,
      "MissingBiomeIds": [],
      "BlockXPZoneLevelFactor": 0.005
    },
    {
      "Id": 2,
      "LevelMin": 25,
      "LevelMax": 50,
      "ZoneRateExp": 1.0,
      "MissingBiomeIds": [],
      "BlockXPZoneLevelFactor": 0.005
    },
    {
      "Id": 6,
      "LevelMin": 90,
      "LevelMax": 100,
      "ZoneRateExp": 2.0,
      "MissingBiomeIds": ["ForgottenTemple"],
      "BlockXPZoneLevelFactor": 0.008
    }
  ],
  "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. BlockXPZoneLevelFactor controls mining/woodcutting XP bonus per zone."
}

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"]
}

Getting Started

Guides

Classes & Passives

Usage

Mod Content

Configuration

Troubleshooting

For Developers

Changelog

Zone Level Config

Zone Level Config

File Structure

Zone Configuration Fields

Default Zones

Block XP Zone Bonus

Example Zone Multipliers

Custom Modded Biomes

Entity Overrides (Boss Levels)

Entity Override Fields

Example Config

Use Cases

Boss with Fixed Level and XP

Boss with Custom Level (But Keep Scaling)

Remap Modded Biome to Zone

See Also

​Zone Level Config

​File Structure

​Zone Configuration Fields

​Default Zones

​Block XP Zone Bonus

​Example Zone Multipliers

​Custom Modded Biomes

​Entity Overrides (Boss Levels)

​Entity Override Fields

​Example Config

​Use Cases

​Boss with Fixed Level and XP

​Boss with Custom Level (But Keep Scaling)

​Remap Modded Biome to Zone

​See Also

Zone Level Config

File Structure

Zone Configuration Fields

Default Zones

Block XP Zone Bonus

Example Zone Multipliers

Custom Modded Biomes

Entity Overrides (Boss Levels)

Entity Override Fields

Example Config

Use Cases

Boss with Fixed Level and XP

Boss with Custom Level (But Keep Scaling)

Remap Modded Biome to Zone

See Also