Back to mods
MineColonies Mages (IronSpells integration) project artwork

CurseForge · Minecraft mod

MineColonies Mages (IronSpells integration)

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which MineColonies Mages (IronSpells integration) release should I use?

Updated 4 months ago
Latest stable file minecolonies-mages-v2.3-forge-1.20.1.jar
Game version 1.20.1
Loader Forge

MineColonies Mages (IronSpells integration) minecolonies-mages-v2.3-forge-1.20.1.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 11 required mods have matching files.

Where it goes

Is MineColonies Mages (IronSpells integration) required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does MineColonies Mages (IronSpells integration) minecolonies-mages-v2.3-forge-1.20.1.jar need?

minecolonies-mages-v2.3-forge-1.20.1.jar. Change the file and its required mods may change too.

All 11 required mods have matching files

Install Iron's Spells 'n Spellbooks, MineColonies, playerAnimator, Curios API and 7 more first. We found matching files for this game-version and loader setup. 10 come through another mod in the chain.

2 listed on this file 10 pulled in by those mods
Iron's Spells 'n Spellbooks Needed by MineColonies Mages (IronSpells integration) minecolonies-mages-v2.3-forge-1.20.1.jar
required
Matching file found Matched file: v1.20.1-3.16.4
MineColonies Needed by MineColonies Mages (IronSpells integration) minecolonies-mages-v2.3-forge-1.20.1.jar
required
Matching file found Matched file: minecolonies-1.20.1-1.1.1318.jar
playerAnimator Needed by Iron's Spells 'n Spellbooks
pulled in
Matching file found Matched file: player-animation-lib-forge-1.0.2-rc1+1.20.jar
Curios API Needed by Iron's Spells 'n Spellbooks
pulled in
Matching file found Matched file: curios-forge-5.14.1+1.20.1.jar
Iron's Lib Needed by Iron's Spells 'n Spellbooks
pulled in
Matching file found Matched file: irons_lib-1.20.1-2.4.0
GeckoLib Needed by Iron's Spells 'n Spellbooks
pulled in
Matching file found Matched file: geckolib-forge-1.20.1-4.8.4.jar
BlockUI Needed by MineColonies
pulled in
Matching file found Matched file: blockui-1.20.1-1.0.193.jar
Structurize Needed by MineColonies
pulled in
Matching file found Matched file: structurize-1.20.1-1.0.826.jar
TownTalk Needed by MineColonies
pulled in
Matching file found Matched file: TownTalk 1.20 1.1.0
Domum Ornamentum Needed by MineColonies
pulled in
Matching file found Matched file: domum_ornamentum-1.20.1-1.0.296-universal.jar
Multi-Piston Needed by MineColonies
pulled in
Matching file found Matched file: multipiston-1.20-1.2.43-RELEASE.jar
bendy-lib Needed by playerAnimator
pulled in
Matching file found Matched file: bendy-lib-forge-4.0.0.jar

10 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add MineColonies Mages (IronSpells integration) without breaking your instance.

Built for MineColonies Mages (IronSpells integration) minecolonies-mages-v2.3-forge-1.20.1.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use minecolonies-mages-v2.3-forge-1.20.1.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Iron's Spells 'n Spellbooks, MineColonies, playerAnimator, Curios API and 7 more first. We found matching files for this game-version and loader setup. 10 come through another mod in the chain.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside minecolonies-mages-v2.3-forge-1.20.1.jar. It opens that exact file at the source.

About this project

What does MineColonies Mages (IronSpells integration) add?

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

Project description from CurseForge.

Pick your setup

MineColonies Mages (IronSpells integration) by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

MineColonies Mages (IronSpells integration) versions and loaders

8 of 8 releases match

Looking for an older file? The official CurseForge project page is in Resources.