promotional bannermobile promotional banner
premium banner
Adds a new guard type called: "Mage" to MineColonies that casts any Iron's Spellbooks spells intelligently. Auto-progression, threat detection, and smooth Iron's Spellbooks spells combat movement.

Description

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