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