PlayerMutations - Minecraft Java Plugin

PLUGIN IS STILL IN VERY DEVELOPMENT.

Website

A behavioral evolution system that mutates players based on their playstyle. Every cycle (default 3 days), the plugin analyzes player behavior and triggers mutations that fundamentally change how they play.

Features

⚠️ IMPORTANT: One Mutation Rule

Players can only have ONE mutation active at a time! This is by design for game balance. When a new mutation evolves, it replaces the old one (unless the old one is permanent). This creates meaningful choices and prevents overpowered combinations.

🧬 8 Unique Mutations

Mutation	Trigger Behavior	Effects	Downside
⛏ Miner (Deep-Sight)	Mining blocks, time underground	Night vision, ore detection through walls, haste	None
🗡 Predator (Lethal Claws)	PvP kills, damage dealt	Increased damage, devastating crits	Cannot use shields
🌿 Harvester (Nature's Embrace)	Farming crops, breeding animals	Animals follow you, luck effect	None
💎 Hoarder (Weighted Greed)	Hoarding diamonds/netherite	None (pure curse)	Permanent slowness
🌀 Void-Walker (Dimension Shifter)	Ender pearls, time in End/Nether	Blink teleport (sneak), fall immunity	Water/rain deals damage
⚗ Chemist (Volatility)	Splash/lingering potions, TNT	Explosion immunity, extended potions	No natural health regen
🍖 Glutton (Bottomless)	Eating food, overeating	Extra hearts, strength after eating	Slowness/weakness when hungry
🔥 Pyromaniac (Ember-Born)	Starting fires, fire damage	Fire resistance, ignite on punch	Cold biomes deal damage

⚡ Activated Abilities

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

Mutation	Ability	Activation Item	Effect
⛏ Miner	Seismic Stun	Diamond Pickaxe	Stun all nearby enemies for 2s, reveal ores in 15-block radius
🗡 Predator	Blade Cyclone	Netherite Sword	Throw spectral swords in 360°, deal massive damage + Bleed
🌿 Harvester	Overgrowth Slam	Diamond Hoe	Root all enemies within 7 blocks for 4 seconds
💎 Hoarder	Greed Pulse	Gold Ingot	Massive knockback based on inventory item count
🌀 Void-Walker	Rift Step	Ender Pearl	Teleport 8 blocks, deal void damage + Wither II to enemies passed through
⚗ Chemist	Lingering Cloud	Brewing Stand	10x10 toxic cloud (Poison/Wither/Slowness), heals you inside it
🍖 Glutton	Berserker Roar	Cooked Beef	Consume all hunger for Resistance V + Strength III for 10s
🔥 Pyromaniac	Fire Ring	Blaze Powder	Expanding fire ring, massive damage + unextinguishable burn

⚡ Core Mechanics

Evolution Cycles: Every 72 hours (configurable), player behavior is analyzed
Progressive Levels: Each mutation has 5 levels - stronger effects with progression
Permanent Mutations: High-level mutations have a chance to become permanent (written into DNA!)
Decay System: Inactive players will see their mutations fade (unless permanent)
Visual Feedback: Particles, sounds, and titles for immersive evolution events

Commands

Player Commands

Command	Description
`/mutations`	View your current mutations
`/mutations check`	View your activity statistics
`/mutations list`	List all available mutations
`/mutations help`	Show help menu

Aliases: /mut, /evolve

Admin Commands

Command	Description
`/mutationadmin give <player> <mutation> [level]`	Grant a mutation (level 1-5)
`/mutationadmin remove <player> <mutation>`	Remove a mutation
`/mutationadmin reset <player>`	Reset all mutations, permanent status, and stats
`/mutationadmin permanent <player> <mutation>`	Make a mutation permanent
`/mutationadmin force-evolve <player>`	Force an evolution check
`/mutationadmin reload`	Reload configuration
`/mutationadmin debug <player>`	Show debug info

Mutation Names: MINER, PREDATOR, HARVESTER, HOARDER, VOIDWALKER, CHEMIST, GLUTTON, PYROMANIAC

Permissions

Permission	Description	Default
`mutations.use`	Use basic mutation commands	true
`mutations.admin`	Use admin commands	op
`mutations.bypass`	Bypass mutation effects	op

Configuration

All settings are customizable in config.yml:

Evolution cycle timing (default: 72 hours)
Behavior thresholds for each mutation
Effect strengths and multipliers
Permanent mutation chances
Decay settings
Messages

Changelog

v1.1.1

CRITICAL FIX: Mutations are now mutually exclusive - only ONE active at a time
Evolution cycle now picks the dominant playstyle behavior
New mutations replace old ones (unless permanent)
Fixed balance issues from stacking multiple mutations

v1.1.0

Added 8 unique activated abilities (one per mutation)
Seismic Stun, Blade Cyclone, Overgrowth Slam, Greed Pulse
Rift Step, Lingering Cloud, Berserker Roar, Fire Ring
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 with 8 mutations
Full configuration system
Admin commands
Permanent mutation system
Decay system

Strategic Gameplay

This plugin creates emergent faction strategies:

Mining Guilds: Players with Deep-Sight become invaluable scouts for resources
Assassin Clans: Predator-mutated players deal massive damage but cannot defend with shields
Farming Communes: Harvesters attract animals, making them perfect for food production
Dimension Raiders: Void-Walkers can blink around but must avoid water at all costs
Alchemist Corps: Chemists are immune to explosions but need potions to heal
Tank Units: Gluttons have massive health pools but must stay fed
Arsonists: Pyromanics are fire-immune but vulnerable in cold biomes
The Cursed Hoarders: Those who can't let go of loot become slow but wealthy

Factions must balance their roster - a team of all Predators has no defense!

Shorten headers 4 headers in your description are too long. Headers should be concise and act as section titles, not full sentences.

Player Mutations