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.