🧠 UltraEvolution

Minecraft Mob Intelligence Redefined

Transform every hostile mob into a thinking, learning, adapting survival entity.
No more dumb mobs. No more predictable AI. Just pure, evolving chaos.

---

---

📖 What is UltraEvolution?

UltraEvolution is a Paper/Spigot plugin that completely overhauls mob AI in Minecraft.
Every mob learns from experience, adapts to your playstyle, cooperates with allies, builds secret bases, raids your home, and upgrades its own gear — just like a real player would.

The longer your server runs, the smarter and more dangerous the mobs become.
On Day 1 they stumble toward you. On Day 100 they coordinate ambushes, siege your walls, and steal your diamonds while you sleep.

---

✨ Feature Highlights

🤖 Self-Learning AI

Every mob species maintains a persistent memory that survives server restarts.

Player Behaviour	Mob Response
🏹 Always uses a bow	Zombies learn to zigzag and rush faster
🔥 Drops lava traps	Fire-resistant mobs lead the charge
🏰 Builds towers	Zombies construct climb routes to reach you
🛡️ Wears full diamond armor	Witches switch to Harm + Poison combos
🐢 Camps indoors	Creepers camouflage near your door

---

👥 Group Intelligence & Squads

Mobs don't swarm mindlessly — they form squads with assigned roles and execute real tactical formations.

🎖️ Role	Function
🛡️ Tank	Engages the player head-on
⚡ Flanker	Attacks from the sides
🔨 Breaker	Destroys walls and blocks
💉 Support	Witch-type healer / buffer
🎯 Sniper	Ranged covering fire
🎭 Distractor	Draws player attention away

Formations available:

• 🔴 RUSH — All mobs charge simultaneously
• ✂️ PINCER — Split attack from two sides
• 🔺 WEDGE — V-shaped push through defences
• ⭕ SURROUND — Complete encirclement

---

🌍 Secret Underground Bases

Mobs secretly build and populate hidden bases while you're not watching.

📦 Base Structure
 ├── 🚪 Entrance Tunnel     (hidden, concealed top)
 ├── 🏛️ Main Hall           (large gathering room)
 ├── 💰 Loot Storage        (chest rooms)
 ├── ⚔️ Guard Stations      (mob sentries)
 ├── 🪵 Resource Rooms      (barrels of stolen goods)
 └── 💣 Trap Corridor       (TNT + pressure plates)

• Bases generate 60–120 blocks underground away from players
• Mobs transport looted items back to storage
• Players discover them accidentally while mining
• Admin commands to list, teleport to, and destroy bases

---

⚔️ Cinematic Raid System

Raids are multi-phase, story-driven events — not random spawner dumps.

🔍 SCOUT  ──►  📋 PLAN  ──►  🥁 GATHER  ──►  ⚔️ ATTACK  ──►  💰 LOOT  ──►  🏃 RETREAT

Phase	What Happens
🔍 Scout	Mobs observe your base layout and weaknesses
📋 Plan	Formation and attack strategy is selected
🥁 Gather	Army assembles at the perimeter with a horn sound
⚔️ Attack	Up to 3 escalating waves hit your base
💰 Loot	Surviving mobs steal from your chests
🏃 Retreat	Survivors fall back to the mob base

---

🎭 Personality System

Every single mob spawns with a unique personality that shapes how it fights, retreats, and cooperates.

Personality	🎯 Behaviour
😡 Aggressive	Rushes targets, ignores low health
🧠 Smart	Prioritises strategy over brute force
😨 Cowardly	Retreats early, hit-and-run tactics
🤝 Loyal	Stays near squad, buffs allies
🥷 Sneaky	Prefers ambushes and stealth
🛡️ Defensive	Holds position, counters attacks
💀 Fearless	Never retreats, fights to the death

---

🦴 Mob Intelligence Breakdown

🧟 Zombies — Siege Masters

• Break blocks to create attack routes through walls
• Build dirt-step climb routes to reach elevated players
• Form squads with tank/breaker/flanker roles
• Commander Zombie variant buffs all nearby zombies with Strength & Speed
• Loot dropped player items and equip better gear
• Learn to zigzag when the player uses a bow

💀 Skeletons — Tactical Snipers

• Seek high ground before engaging
• Duck into cover while reloading
• Predict player movement and lead their shots
• Fire special arrows: 🔥 Fire · ☠️ Poison · 💥 Explosive · 🐌 Slow · 🌑 Blindness
• Strafe backward while shooting when the player gets close
• Unlock Power-enchanted bows at higher difficulty levels

🕷️ Spiders — Silent Hunters

• Stalk players slowly from the shadows at night
• Climb to ceilings and drop ambush attacks from above
• Apply venom effects on hit: Slowness, Blindness, Weakness, Nausea
• Re-initiate ambush if interrupted
• Cowardly spiders fall back and reposition rather than die

💣 Creepers — Terror Units

• Camouflage by crouching silently near player structures
• Fake retreat to lure players into chasing them
• Dash toward the player at low health before detonating
• Target the foundation of towers rather than walls
• Move silently (setSilent(true)) during approach
• 10% chance to spawn as Powered Creeper at difficulty 8+

👁️ Endermen — Shadow Assassins

• Observe players from a distance before striking
• Teleport behind the player to attack from blind spots
• Chain rapid teleports to disorient and confuse
• Apply Darkness and Nausea effects at high difficulty
• Steal valuable blocks (chests, iron blocks, crafting tables) from your base
• Carry stolen blocks back to mob loot storage

🧙 Witches — Adaptive Alchemists

• Analyse player equipment and combat style to pick the right potion
• Counter melee players with Slowness + Weakness
• Counter bow players with Blindness
• Bypass heavy armor with Harm + Poison combos
• Heal nearby monsters when they drop below 40% health
• Buff allies with Strength, Speed, and Resistance at high difficulty

🏘️ Villagers — Intelligent Survivors

• Sound alarm bells to warn nearby villagers and players
• Flee toward shelter (doors/houses) when threatened
• Build cobblestone walls during peaceful periods
• Alert other villagers to danger in a 24-block radius

---

📈 Dynamic Difficulty Scaling

The plugin tracks in-game days elapsed and automatically escalates mob intelligence.

Day 1   ░░░░░░░░░░  Difficulty 1  — Basic AI, slow learning
Day 10  ██░░░░░░░░  Difficulty 2  — Squads begin forming
Day 30  ████░░░░░░  Difficulty 4  — Special arrows, gear upgrades
Day 50  ██████░░░░  Difficulty 6  — Bases generated, raids active
Day 80  ████████░░  Difficulty 8  — Powered creepers, chain teleports
Day 100 ██████████  Difficulty 10 — Full intelligence, max terror

---

⚙️ Configuration

Everything is configurable in config.yml. Enable or disable any system independently.

# Toggle entire subsystems
ai:
  enabled: true
  learning-rate: 0.5
  persist-memory: true

raids:
  enabled: true
  nightly-raid-chance: 20      # % chance each night
  cooldown-minutes: 30

bases:
  enabled: true
  max-bases-per-world: 5
  generation-interval-minutes: 60

difficulty:
  start-level: 1
  max-level: 10
  increment-interval-days: 10

performance:
  max-ai-mobs-per-player: 10
  ai-disable-chunk-distance: 6

---

🖥️ Commands

Command	Description	Permission
/ue status	Show full system status	ultraevolution.admin
/ue difficulty <1-10>	Force-set difficulty level	ultraevolution.admin
/ue raid <player>	Manually trigger a raid	ultraevolution.admin
/uereload	Reload config.yml	ultraevolution.admin
/uereset	Wipe all AI memory	ultraevolution.admin
/uestats mob	Active mob AI count & squads	ultraevolution.admin
/uestats base	List all active mob bases	ultraevolution.admin
/uestats raid	Show ongoing raids	ultraevolution.admin
/uestats memory	Dump AI learning data	ultraevolution.admin
/uebase list	List bases with coordinates	ultraevolution.admin
/uebase tp <id>	Teleport to a mob base	ultraevolution.admin
/uebase destroy <id>	Destroy a mob base	ultraevolution.admin

---

🔐 Permissions

Permission	Default	Description
ultraevolution.admin	OP	Full access to all commands
ultraevolution.bypass	false	Mobs will never target this player
ultraevolution.notify	OP	Receive raid/base alert messages

---

📦 Installation

# 1. Download UltraEvolution-1.0.0.jar
# 2. Drop into your /plugins/ folder
# 3. Restart your server
# 4. Edit plugins/UltraEvolution/config.yml
# 5. Run /uereload

Requirements:

• ☕ Java 17+
• 🗂️ Paper or Spigot 1.20.4+
• 🧩 No external dependencies

---

⚡ Performance

Designed for 50–200 player servers without causing TPS drops.

Optimisation	Detail
🔁 Async processing	AI decisions run off the main thread where safe
📏 Distance culling	Mobs beyond 6 chunks of any player get AI suspended
🎯 Per-player AI cap	Max 10 fully active AI mobs per online player
🗃️ Pathfind throttle	Max 5 pathfinding recalculations per tick
🧹 Dead mob pruning	Dead AI instances cleaned each tick cycle
💾 Lazy memory saves	Memory only written to disk on clean shutdown

---

👤 Author

Pawan — Plugin Author
Built with ❤️ for survival server communities who want truly terrifying mobs.

---

📜 License

This project is licensed under the MIT License.
You are free to use, modify, and distribute this plugin with attribution.

---