MineColonies Custom Raids

Description

Transform the way your colony is attacked with fully customizable and scalable raid events.

This mod expands MineColonies by allowing you to create your own raid system from scratch, using entities from any mod. Instead of relying on fixed and often predictable raids, you gain full control over how enemies spawn, scale, and challenge your colony over time.

Instead of random attacks, raid enemies now follow intelligent, objective-based behavior, regardless of which mob is used.

Design unique raid scenarios, balance progression, and create truly dangerous invasions tailored to your playstyle or modpack.

Important Raid Level Note (v1.2+)

Raid level is calculated by MineColonies itself, not by this mod.
Custom Raids reads the value provided by MineColonies and uses it to validate your custom raid rules.

MineColonies uses its own internal formula (citizens, skills, buildings, research, and population factor), so raids may trigger even when players expect a lower level.

Since MineColonies does not provide a native in-game command to check this value, starting in version 1.2 this mod adds:

/customraids colonyinfo <colonyId>

Use it to view your colony’s current raid level directly in-game and configure raid requirements more accurately.

Features

Fully Customizable Raid System

Create custom raid types using entities from any mod
Define spawn count, minimum colony level, and raid weight
Build your own raid pool with complete control over progression

Advanced Raid AI

Objective-based behavior applied to any entity from any mod
Enemies act with purpose instead of random movement
Targets guards first, then civilians, and finally the Town Hall
Creates structured and escalating invasions
Forces real defensive strategy instead of reactive combat

Dynamic Difficulty and Progression

Scale raids based on colony development
Adjust difficulty curves to match early, mid, and late game
Create rare, high-impact raids using weighted probabilities

Seamless MineColonies Integration

Optionally link custom raids to native MineColonies raid types
Natural spawning behavior outside colony borders for smoother attacks
Designed to feel like a native extension of the base system

In-Game Configuration Tools

Full configuration directly in-game (default key: H)
Filter mods and entities for fast and intuitive setup
Create, edit, and manage raid types in just a few clicks

Immersive Raid Experience

Boss bar displaying raid name and progression
Clear raid messages for better player awareness
Cleaner attack flow with improved spawn positioning
Raid outcome states for victory and breach scenarios

Powerful Admin Control

Commands to create, edit, force, and reload raids
JSON-based system for easy expansion and customization
Perfect for modpacks and multiplayer servers

Requirements

Minecraft 1.20.1 (Forge)
MineColonies (latest compatible version)
Any mod that adds entities (optional, but recommended)

Getting Started

Install the mod in your mods folder
Open the in-game config menu (default key: H)
Create a new raid type
Choose entities, configure scaling, and set weights
Save and watch your colony face new threats

How It Works

Custom raids will:

Spawn enemies outside colony borders for better flow
Scale based on colony progression and defined parameters
Select raid types using a weighted system
Apply intelligent AI behavior to all raid mobs
Integrate with native MineColonies raids
Display real-time progress through a boss bar

Who This Mod Is For

Players who feel MineColonies raids are too easy or repetitive
Modpack creators looking for deeper combat systems
Servers that want dynamic and scalable raid events
Anyone who wants full control over colony defense challenges