Mob Leveling Modes
Mob Leveling Modes define how a mob's level is dynamically calculated. These modes allow server owners to tailor difficulty based on players, geography, or instances.
The active mode is controlled via the LevelMode configuration value.
Description:
Mobs keep their original spawn level permanently.
Behavior:
- Uses the level assigned at spawn
- No dynamic recalculation
- Ideal for static or RPG-style worlds
Use Cases:
- Fixed difficulty zones
- Hand-balanced encounters
Description:
Mob level is based on the average level of nearby players.
Behavior:
- Detects players within a 40-block radius
- Computes the mean player level
- Rounds to the nearest whole number
- Falls back to level 5 if no players are nearby
Use Cases:
- Dynamic overworld scaling
- Co-op friendly encounters
- Prevents over- or under-leveled mobs
Description:
Mob level is determined by the biome they are currently in.
Behavior:
- Reads the active biome name
- Uses biome-to-level mappings
- Defaults to level 1
- If biome cannot be resolved, defaults to 6
Use Cases:
- Thematic biome difficulty
- Progressive exploration
Config Location:
mods/levelingcore_LevelingCore/data/config/mobbiomemapping.csv
Config Example:
biome,lvl
River_Plains_Smooth,5Description:
Mob level is based on the current world zone.
Behavior:
- Uses the active zone name
- Reads from zone-to-level mappings
- Defaults to level 1
Use Cases:
- MMO-style regions
- Structured progression maps
Config Location:
mods/levelingcore_LevelingCore/data/config/mobinstancemapping.csv
Config Example:
zone,lvl
Emerald_Wilds,5Description:
Mob level is based on the current world instance.
Behavior:
- Uses the instance/world name
- Reads from instance-to-level mappings
- Defaults to level 1
- Logs a warning if the instance name is invalid
Use Cases:
- Dungeons
- Raids
- Scaled private instances
Config Location:
mods/levelingcore_LevelingCore/data/config/mobzonemapping.csv
Config Example:
instance,lvl
default,5If an invalid LevelMode value is provided:
- A warning is logged
- The system automatically falls back to NEARBY_PLAYERS_MEAN
This ensures mobs always receive a valid level.
