Skip to content

PushpkGoat/PlayerMutation-Plugin-Minecraft

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

PlayerMutations - Minecraft Java Plugin

VISIT THE 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

About

A behavioral evolution system for Minecraft that mutates players based on their playstyle. Every 3 days, your actions trigger one of 8 unique mutations—from the lethal Predator to the dimension-shifting Void-Walker. Gain powerful abilities like ore-sensing or teleportation, but balance them against unique downsides. Evolve or go extinct.

Topics

Resources

License

Stars

Watchers

Forks

Contributors