Description
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