Behavioral Evolution System for Minecraft

Behavioral Evolution

Your actions reshape your character. Every 3 days, your playstyle triggers mutations.

⚠️ One Mutation Rule

Players can only have ONE mutation active at a time! This is intentional for game balance. When a new mutation evolves, it replaces the old one (unless permanent). No stacking allowed!

How It Works

The plugin tracks your behavior — mining, fighting, farming, hoarding, dimension travel, potion usage, eating habits, and fire activities. Every 72 hours, it analyzes your stats and evolves your character with one of 8 unique mutations.

8 Unique Mutations

⛏

The Miner

Night vision and ore detection through walls.

🗡

The Predator

Devastating crits, but no shields allowed.

🌿

The Harvester

Animals follow you instinctively.

💎

The Hoarder

Permanent slowness from greed.

🌀

The Void-Walker

Blink teleport, but water burns you.

⚗

The Chemist

Explosion immune, no natural regen.

🍖

The Glutton

Extra hearts, but hunger cripples you.

🔥

The Pyromaniac

Fire immune, but cold biomes hurt.

All 8 Mutations

Detailed breakdown of each mutation's triggers, effects, and downsides.

⛏

The Miner - Deep-Sight

ID: MINER

Trigger

Mining blocks, time spent underground

Effects

Night vision, ore detection particles, haste at level 3+

Downside

None

🗡

The Predator - Lethal Claws

ID: PREDATOR

Trigger

PvP kills, damage dealt, critical hits

Effects

Bonus damage, enhanced critical multiplier

Downside

Cannot hold or use shields

🌿

The Harvester - Nature's Embrace

ID: HARVESTER

Trigger

Harvesting crops, breeding animals, planting seeds

Effects

Animals follow you, luck effect at level 4+

Downside

None

💎

The Hoarder - Weighted Greed

ID: HOARDER

Trigger

Hoarding diamonds/netherite, keeping inventory full

Effects

None (pure curse)

Downside

Permanent slowness, gold dust particles

🌀

The Void-Walker - Dimension Shifter

ID: VOIDWALKER

Trigger

Using ender pearls, time in End/Nether

Effects

Sneak to blink teleport, fall damage immunity

Downside

Water and rain deal damage

⚗

The Chemist - Volatility

ID: CHEMIST

Trigger

Using splash/lingering potions, TNT explosions

Effects

Explosion immunity, extended potion durations

Downside

No natural health regeneration

🍖

The Glutton - Bottomless

ID: GLUTTON

Trigger

Consuming food, overeating when full

Effects

Extra hearts, strength buff after eating

Downside

Massive slowness/weakness when hungry

🔥

The Pyromaniac - Ember-Born

ID: PYROMANIAC

Trigger

Starting fires, taking fire damage, igniting entities

Effects

Fire resistance, ignite enemies on punch

Downside

Cold biomes deal damage over time

⚡ Activated Abilities

Each mutation grants a powerful ability. Sneak + Right-click with the activation item to use.

How to Activate

Hold the required item → Hold Sneak → Right-click. Cooldowns reduce by 10% per mutation level.

⛏ Seismic Stun

Diamond Pickaxe

Slam the ground to Stun (freeze) all nearby enemies for 2 seconds and reveal all ores within a 15-block radius for 3 seconds.

Cooldown: 45s

🗡 Blade Cyclone

Netherite Sword

Throw spectral swords in a 360° radius that deal massive damage and apply Bleed (damage over time) to all nearby players.

Cooldown: 30s

🌿 Overgrowth Slam

Diamond Hoe

Slam the ground to summon massive spectral vines that Root (freeze) all enemies within 7 blocks for 4 seconds.

Cooldown: 40s

💎 Greed Pulse

Gold Ingot

Emit a massive kinetic blast that knocks back nearby players with force proportional to how many items are in your inventory.

Cooldown: 35s

🌀 Rift Step

Ender Pearl

Instantly teleport 8 blocks forward; teleporting through enemies deals 2 hearts of void damage and applies Wither II.

Cooldown: 20s

⚗ Lingering Cloud

Brewing Stand

Release a 10x10 cloud of mixed negative effects (Slowness, Wither, Poison) for 8 seconds. Heals you while you stand in it.

Cooldown: 60s

🍖 Berserker Roar

Cooked Beef

Consume your entire hunger bar to gain Resistance V and Strength III for 10 seconds. Basically god mode.

Cooldown: 90s | Requires 50% hunger

🔥 Fire Ring

Blaze Powder

Create an expanding ring of fire that deals massive damage and inflicts Burn II (cannot be extinguished by water for 3 seconds).

Cooldown: 35s

🔨 Compiling

Build the plugin from source on any system.

Prerequisite: You need the source code files from this project.

Option 1: Docker (Recommended)

No system installations required. Works on any OS with Docker.

# Build the image
docker build --no-cache -t mutations-builder .

# Extract the JAR file
docker run --rm mutations-builder > PlayerMutations.jar

Option 2: Maven

If you have Maven and Java 21 installed:

# Install dependencies (Debian/Ubuntu/Kali)
sudo apt install openjdk-21-jdk maven

# Build
mvn clean package

Output: target/PlayerMutations-1.0.0.jar

Dockerfile

The working Dockerfile:

# Stage 1: Build
FROM maven:3.9-eclipse-temurin-21 AS build
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package

# Stage 2: Packaging
FROM alpine:latest
WORKDIR /app
COPY --from=build /app/target/*.jar ./PlayerMutations.jar
CMD ["cat", "PlayerMutations.jar"]

⚙️ Configuration

All settings in config.yml are customizable.

Evolution Cycle

evolution:
  cycle-hours: 72          # How often to analyze (3 days)
  min-playtime: 2          # Hours required to qualify
  broadcast-evolutions: true
  single-mutation-only: true  # IMPORTANT: Only one mutation at a time!

Ability Cooldowns

abilities:
  miner:
    cooldown-seconds: 45
    stun-duration-seconds: 2
    ore-reveal-radius: 15
    activation-item: DIAMOND_PICKAXE
  predator:
    cooldown-seconds: 30
    damage: 8.0
    bleed-duration-seconds: 5
    activation-item: NETHERITE_SWORD
  # ... see config.yml for all abilities

Thresholds

Actions needed to trigger each mutation:

thresholds:
  miner:
    blocks-mined: 500
    time-underground-minutes: 120
  predator:
    player-kills: 10
    damage-dealt: 5000
  voidwalker:
    ender-pearls-thrown: 50
    time-in-end-minutes: 60
  # ... and more

📝 Commands

Complete command reference.

Aliases: /mut /evolve

Player Commands

Permission: mutations.use (Default: true)

/mutations View your current mutations
/mutations check View your activity statistics
/mutations list List all possible mutations
/mutations help Show help menu

Admin Commands

Permission: mutations.admin (Default: OP)

/mutationadmin give <player> <mutation> [level] Grant a specific mutation (level 1-5)
/mutationadmin remove <player> <mutation> Remove a mutation from a player
/mutationadmin reset <player> Reset all mutations, permanent status, and stats
/mutationadmin permanent <player> <mutation> Make a mutation permanent (immune to decay)
/mutationadmin force-evolve <player> Force an immediate evolution check
/mutationadmin debug <player> View detailed debug stats
/mutationadmin reload Reload the configuration file

Mutation Type IDs

MINER PREDATOR HARVESTER HOARDER VOIDWALKER CHEMIST GLUTTON PYROMANIAC

📋 Changelog

Version history and updates.

v1.1.1 Balance Fix
  • • CRITICAL FIX: Mutations are now mutually exclusive - only ONE active at a time
  • • Evolution cycle now picks the dominant playstyle behavior
  • • New mutations automatically replace old ones (unless permanent)
  • • Fixed game-breaking balance issues from stacking multiple mutations
  • • Improved scoring system for mutation selection
v1.1.0 Abilities Update
  • • 8 unique activated abilities - one for each mutation
  • • ⛏ Seismic Stun - Stun enemies + reveal ores
  • • 🗡 Blade Cyclone - 360° sword throw + Bleed effect
  • • 🌿 Overgrowth Slam - Root enemies with spectral vines
  • • 💎 Greed Pulse - Knockback based on inventory size
  • • 🌀 Rift Step - Teleport through enemies + Wither damage
  • • ⚗ Lingering Cloud - Toxic cloud that heals you
  • • 🍖 Berserker Roar - Consume hunger for god mode
  • • 🔥 Fire Ring - Expanding unextinguishable fire
  • • Full ability configuration in config.yml
  • • Cooldown system with level-based reduction
  • • Activation via Sneak + Right-click with specific items
v1.0.0 Initial Release
  • • 8 unique mutations: Miner, Predator, Harvester, Hoarder, Void-Walker, Chemist, Glutton, Pyromaniac
  • • Full configuration system with thresholds and effect settings
  • • Admin commands for managing player mutations
  • • Permanent mutation system with DNA changes
  • • Decay system for inactive players
  • • Visual feedback with particles, sounds, and titles

🧬 Crafted with care for the Minecraft community

Made by humans, for humans. No AI slop.