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

1. Install the mod in the mods folder

2. Research "Mage Troops" in the colony Combat tech tree

3. Assign a citizen as a Mage in any military building (e.g., Guard Tower)

4. Provide a spellbook with at least one spell

5. 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