Spawning

spawning.yml is where you decide how RPG Mobs enter your world. You can choose a progression style that fits your server, configure per-tier spawn weights, and fine-tune per-zone tier distributions. All spawning settings can be overridden per-world via the overlay system.

Spawn Chances

When a hostile NPC spawns, RPGMobs uses the spawnChancePerTier weights to decide which tier the elite becomes. These are weights (not percentages), so they don’t need to add up to 1.0.

Spawning:
  spawnChancePerTier:
    - 0.46  # Tier 1  -  46% weight
    - 0.28  # Tier 2  -  28% weight
    - 0.16  # Tier 3  -  16% weight
    - 0.08  # Tier 4  -  8% weight
    - 0.04  # Tier 5  -  4% weight

Higher values mean that tier will appear more often. Set a tier to 0 to prevent it from spawning. Tip: On a fresh server, the defaults work well. If the world feels too quiet, increase the weights. If players are overwhelmed, decrease higher-tier weights.

Progression Style

This is the most important setting in the file. It determines how tier difficulty is distributed across your world.

Spawning:
  progressionStyle: ENVIRONMENT

ENVIRONMENT (Default)

Tiers are tied to Hytale’s built-in zone system. Early zones spawn weaker elites, late zones spawn stronger ones.

Zone 1 (Emerald Grove): Mostly Tier 1-2, no Tier 4-5.
Zone 2 (Howling Sands): Mix of Tier 1-3, rare Tier 4.
Zone 3 (Borea): Tier 2-5, no Tier 1.
Zone 4 (Devastated Lands): Tier 3-5 only, the hardest content.

This is the recommended style for most servers because it naturally matches the game’s built-in difficulty curve.

DISTANCE_FROM_SPAWN

Difficulty increases the further players travel from world coordinates (0, 0). This creates a smooth, radiating difficulty gradient.

Spawning:
  progressionStyle: DISTANCE_FROM_SPAWN
  distancePerTier: 1000.0
  distanceBonusInterval: 100.0
  distanceHealthBonusPerInterval: 0.01
  distanceDamageBonusPerInterval: 0.005
  distanceHealthBonusCap: 0.5
  distanceDamageBonusCap: 0.5

Setting	What it does	Default
`distancePerTier`	Blocks of distance needed before the next tier unlocks. At 1000 blocks from spawn, Tier 2 starts appearing. At 2000, Tier 3, and so on.	`1000.0`
`distanceBonusInterval`	Every this many blocks, a small stat bonus is added on top of the tier multiplier.	`100.0`
`distanceHealthBonusPerInterval`	Health bonus per interval. `0.01` means +1% extra health every 100 blocks.	`0.01`
`distanceDamageBonusPerInterval`	Damage bonus per interval. `0.005` means +0.5% extra damage every 100 blocks.	`0.005`
`distanceHealthBonusCap`	Maximum health bonus from distance. `0.5` means the distance bonus can add at most +50% health on top of the tier multiplier.	`0.5`
`distanceDamageBonusCap`	Maximum damage bonus from distance.	`0.5`

This style works well with custom world generation mods or maps that don’t use Hytale’s standard zone tags.

NONE

Any tier can spawn anywhere. Tier distribution is completely random based on the spawnChancePerTier weights. Good for hardcore servers or arenas.

Spawning:
  progressionStyle: NONE

Environment Tier Rules

When using ENVIRONMENT progression, you can override the tier distribution for specific zones and sub-zones.

Spawning:
  enableEnvironmentTierSpawns: true
  environmentTierSpawns:
    Env_Zone1:
      enabled: true
      spawnChancePerTier: [0.60, 0.25, 0.15, 0.00, 0.00]
    Env_Zone2:
      enabled: true
      spawnChancePerTier: [0.50, 0.25, 0.18, 0.07, 0.00]
    Env_Zone3:
      enabled: true
      spawnChancePerTier: [0.00, 0.32, 0.28, 0.22, 0.18]
    Env_Zone4:
      enabled: true
      spawnChancePerTier: [0.00, 0.00, 0.40, 0.33, 0.27]

Each key is a Hytale environment identifier. The mod ships with rules for every known sub-zone (caves, dungeons, forests, etc.). If a mob spawns in a zone that has no matching rule, the default entry is used. Important: When a per-world overlay defines any environment tier rules, it fully replaces the base rules for that world (not additive). If you define one environment rule in an overlay, all base environment rules are removed for that world. Tip: Set enabled: false on any zone rule to prevent elites from spawning there entirely. This is useful for safe zones or player towns.

Getting Started

Admin UI

File Configuration

Developer API

Reference

Spawn Chances

Progression Style

ENVIRONMENT (Default)

DISTANCE_FROM_SPAWN

NONE

Environment Tier Rules

​Spawn Chances

​Progression Style

​ENVIRONMENT (Default)

​DISTANCE_FROM_SPAWN

​NONE

​Environment Tier Rules

Spawn Chances

Progression Style

ENVIRONMENT (Default)

DISTANCE_FROM_SPAWN

NONE

Environment Tier Rules