Player Mutations

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 | |----------|-----------------|---------|----------| | 🔥 Pyromaniac (Ember-Born) | Mining blocks, time underground | Night vision, ore detection through walls, haste | None | | 🔥 Pyromaniac (Ember-Born) | PvP kills, damage dealt | Increased damage, devastating crits | Cannot use shields | | 🔥 Pyromaniac (Ember-Born) | Farming crops, breeding animals | Animals follow you, luck effect | None | | 🔥 Pyromaniac (Ember-Born) | Hoarding diamonds/netherite | None (pure curse) | Permanent slowness | | 🔥 Pyromaniac (Ember-Born) | Ender pearls, time in End/Nether | Blink teleport (sneak), fall immunity | Water/rain deals damage | | 🔥 Pyromaniac (Ember-Born) | Splash/lingering potions, TNT | Explosion immunity, extended potions | No natural health regen | | 🔥 Pyromaniac (Ember-Born) | 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 | |----------|---------|-----------------|--------| | 🔥 Pyromaniac | Seismic Stun | Diamond Pickaxe | Stun all nearby enemies for 2s, reveal ores in 15-block radius | | 🔥 Pyromaniac | Blade Cyclone | Netherite Sword | Throw spectral swords in 360°, deal massive damage + Bleed | | 🔥 Pyromaniac | Overgrowth Slam | Diamond Hoe | Root all enemies within 7 blocks for 4 seconds | | 🔥 Pyromaniac | Greed Pulse | Gold Ingot | Massive knockback based on inventory item count | | 🔥 Pyromaniac | Rift Step | Ender Pearl | Teleport 8 blocks, deal void damage + Wither II to enemies passed through | | 🔥 Pyromaniac | Lingering Cloud | Brewing Stand | 10x10 toxic cloud (Poison/Wither/Slowness), heals you inside it | | 🔥 Pyromaniac | 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

- Visual Feedback: Every 72 hours (configurable), player behavior is analyzed - Visual Feedback: Each mutation has 5 levels - stronger effects with progression - Visual Feedback: High-level mutations have a chance to become permanent (written into DNA!) - Visual Feedback: 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:

- The Cursed Hoarders: Players with Deep-Sight become invaluable scouts for resources - The Cursed Hoarders: Predator-mutated players deal massive damage but cannot defend with shields - The Cursed Hoarders: Harvesters attract animals, making them perfect for food production - The Cursed Hoarders: Void-Walkers can blink around but must avoid water at all costs - The Cursed Hoarders: Chemists are immune to explosions but need potions to heal - The Cursed Hoarders: Gluttons have massive health pools but must stay fed - The Cursed Hoarders: 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.