📖 Spawner Configuration (In-Game GUI) 

 Every Ultimate Spawner can be fully configured through an intuitive GUI.

General Settings

• Mode (At Level / Above / Below) - Controls spawn height relative to the block using V.Offset.
• Spawn Delay - Time between spawn cycles.
• Max Entities - Maximum number of mobs maintained by this spawner.
• Day Spawn / Dark Only - Time and light condition requirements.
• Torch Spawn - Allows spawning even in high block light.
• Destroyable - Allows or prevents Survival players from breaking the spawner.

 ⚔️ Trial System

Spawners can operate as scalable trial encounters.

• Key Mode - Converts the spawner into a Trial encounter with rewards and progression mechanics.
• Auto Range - Horizontal player detection range.
• V.Radius - Vertical detection range across floors.
• Min Players - Required players to activate the trial.
• Mobs Per Player - Dynamically scales difficulty based on nearby players.

Total spawned mobs scale automatically with multiplayer participation and respect the configured entity cap.

🧟 Mob List

Each spawner supports multiple entity entries.

• Uses standard modid:entity_name format
• Up to 16 different mobs per spawner
• At least one entity entry is required

👾 Per-Mob Configuration (Mob CFG)

Each entity can be customized individually:

• Weight - Relative selection chance compared to other mobs
• Sun Immune - Prevents burning in sunlight
• Custom Name - Assigns a custom display name

🎁 Loot & Rewards

Ultimate Spawners includes a fully configurable reward system.

Custom Loot

• OFF → Uses default mob drops
• ON → Uses configured loot table

Each item supports:

• Individual drop chance
• Minimum and maximum stack size

⚠️ IMPORTANT:
If Custom Loot is enabled and the loot list is empty, mobs will drop nothing.
This can be intentionally used to disable farming or create challenge encounters.

Depending on configuration, custom loot can replace or extend vanilla drops.

🌍 Automatic Vanilla Spawner Integration

Ultimate Spawners can automatically integrate into existing worlds:

• Replace vanilla spawners automatically
• Import existing mob data
• Apply configuration profiles
• Restrict behavior per dimension
• Convert generated structures on chunk load

Perfect for modpacks and existing saves.

🧰 For Modpack Creators

Global behavior can be configured inside:

config/ultimatespawners-common.toml

The config includes detailed comments explaining every available option, including:

• automatic spawner replacement
• default trial behavior
• vault and key systems
• spawn safety checks
• profile assignment
• performance controls

Advanced customization can be done through:

ultimatespawners_user_content

This folder allows adding custom profiles, assets, and extended configuration without modifying the mod itself.

⚠️ IMPORTANT - Updating From Older Versions

If you are upgrading from a previous version, it is highly recommended to perform a clean configuration reset to avoid crashes or data conflicts.

Before launching the new version, delete:

• config/ultimatespawners-common.toml
• ultimatespawners_user_content folder

The files will be regenerated automatically on next launch.