MineColonies Mages Integration
Description
Transform your MineColonies guards into powerful spellcasters using Iron's Spellbooks.
This mod allows any citizen to become a mage by unlocking the "Mage Troops" research in the Combat tech tree. Once unlocked, you can assign a citizen to the Mage job in any military building, and they will automatically request spellbooks from Iron's Spellbooks to cast spells in combat.
Features
Intelligent Combat AI
- Dynamic spell selection: automatically heals when low on health, casts offensive spells against enemies, and supports wounded allies
- Smart threat detection: only casts spells when real hostiles are nearby (8-second combat memory)
- Adaptive cooldowns: prevents spell spam with a type-aware cooldown system
- Validated targeting: line-of-sight checks with a 32-block detection range
Progressive Spell Mastery
- Automatic book requests: mages request better spellbooks as they gain experience
- Five-tier progression system based on citizen levels
- No skill restrictions: full access to all Iron's Spellbooks spells
- Smart equipment system: automatically equips the best available spellbook
Smooth Combat Movement
- Orbiting behavior: maintains optimal combat distance (8–12 blocks) while circling enemies
- Strategic positioning: advances when far and retreats when too close
- Consistent targeting: always faces the enemy during combat movement
Requirements
- Minecraft 1.20.1 (Forge)
- MineColonies (latest compatible version)
- Iron's Spellbooks (latest compatible version)
Getting Started
-
Install the mod in the mods folder
-
Research "Mage Troops" in the colony Combat tech tree
-
Assign a citizen as a Mage in any military building (e.g., Guard Tower)
-
Provide a spellbook with at least one spell
-
Your mage is ready to defend the colony using magic
How It Works
Mages will:
- Detect enemies within a 32-block radius
- Heal themselves when below 50% health
- Use offensive spells against enemies
- Support allies with healing magic
- Automatically request better spellbooks
- Avoid spell spam through intelligent cooldowns
- Move strategically using advanced combat behavior inspired by Iron's Spellbooks
