Player Mutations

# PlayerMutations - Minecraft Java Plugin **PLUGIN IS STILL IN VERY DEVELOPMENT.** # (https://mutation-plugin.pages.dev/) 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> ` | 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 do