ControlMobs
Advanced Boss System & Friendly Mob Protection Plugin (1.20.4)
ControlMobs is a high-performance Spigot/Paper plugin designed to give server owners complete control over boss encounters, mob behaviors, and player statistics with full PlaceholderAPI support.

Built for survival, RPG, hardcore, and competitive PvE environments.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CORE FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Advanced Boss System (boss.yml)

Create epic boss encounters with:
• Custom health, damage, speed, and armor
• Equipment loadouts (helmet, chestplate, legs, boots, weapon)
• Custom names with dynamic HP display
• Per-boss ability configurations
• Phase transitions with bonuses
• Enrage system for low-HP fury

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
20+ BOSS ABILITIES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Devastating Offensive Abilities:

Meteor Strike
Rain meteors from the sky onto players.
Each meteor deals configurable damage on impact.
Smoke and flame particles trail the falling rocks.

⚡ Chain Lightning
Electrocute multiple targets in a chain reaction.
Configurable jump radius between targets.
Lightning effect visually connects all victims.

Life Drain
Steal life force from targets over time.
Boss heals for percentage of damage dealt.
Visible heart particles connect boss to target.

Teleport
Blink behind players with total surprise.
Applies blindness effect to nearby players.
Sound effect announces the teleport.

Fireball Barrage
Launch multiple explosive fireballs.
Configurable explosion strength.
Fire particles trail each projectile.

Beam Attack
Continuous energy beam locks onto target.
Particles stream from boss to player.
Damage ticks every 10 ticks.

❄️ Arrow Rain
Volley of arrows rains from above.
Arrows spawn high and fall with gravity.
Configurable amount and damage.

Explosion
Self-destruct ability with area damage.
Configurable explosion power and radius.
Fire spread option available.

Defensive & Debuff Abilities:

️ Shield
Invulnerability barrier protects the boss.
Must be broken by sustained damage.
Visual diamond particles surround boss.

❄️ Freeze
Immobilize players in ice.
Extreme slowness and mining fatigue.
Snowflake particles cover the ground.

☠️ Poison Cloud
Lingering poison with hunger effect.
Radius-based application.
Happy villager particles (ironic effect).

️ Blind
Vision impairment with slowness.
Dark cloud particles surround victims.
Perfect for escape abilities.

⬇️ Gravity Trap
Launch players high into the air.
Multiplies fall damage on landing.
Flap sound effect as they rise.

Control & Summon Abilities:

Minion Summon
Call forth helper creatures.
Configurable mob type and amount.
Minions copy boss equipment.

Clone
Spawn illusionary copies of the boss.
Copies have separate health pools.
Invisibility effect on spawn.

Summon Ride
Summon a mount and ride players.
Configurable mount entity type.
Phantom swoop sound effect.

⚡ Knockback
Repel all nearby players with force.
Vertical knockup component available.
Ravager roar sound effect.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
5 PRE-CONFIGURED BOSSES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FireLord (Fire/Earth Elemental)
Abilities: Meteor, Fireball, Explosion
Passive: Fire aura, regeneration
Theme: Molten core with flame particles

❄️ IceColossus (Frozen Giant)
Abilities: Freeze, Chain Lightning, Arrow Rain
Passive: Ice aura, speed boost
Theme: Glacial mass with frost aura

ShadowWraith (Dark Assassin)
Abilities: Teleport, Life Drain, Blind
Passive: Invisibility, poison aura
Theme: Ethereal darkness with whispers

️ GuardianSentinel (Mechanical Guardian)
Abilities: Shield, Beam, Explosion
Passive: Regeneration, speed boost
Theme: Arcane technology with hum

NatureGuardian (Forest Protector)
Abilities: Poison, Minions, Knockback
Passive: Poison aura, regeneration
Theme: Overgrown with vine particles

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BOSS PHASES & ENRAGE SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Phase Transitions:
• HP threshold triggers (e.g., 75%, 50%, 25%)
• Speed bonuses per phase
• Damage multipliers per phase
• Custom broadcast messages
• Particle and sound effects per phase

Enrage System:
• Activates when boss HP drops below threshold
• Damage multiplier increases
• Custom enrage message broadcasts
• Visual effects on enrage activation

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FRIENDLY MOB PROTECTION SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Protect your server's friendly mobs:

Protection Toggle
Enable/disable friendly mob protection globally.
Protected mobs cannot be damaged by players.
Toggle via command: /cmobs friendly protect [on/off]

⚔️ Attack Toggle
Control if friendly mobs attack players.
Peaceful mode: Friendly mobs ignore players.
Toggle via command: /cmobs friendly attack [on/off]

Status Command
View current protection settings at a glance.
/cmobs friendly status

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ADVANCED MOB CUSTOMIZATION (mobs.yml)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Each mob type can be individually configured:

• Custom damage values
• Custom health and attributes
• Explosion ability (with cooldown)
• Teleport ability (safe location detection)
• Disable default drops
• Fully configurable custom drops
• World-based enable/disable

Special Mob Effects:
• Fire aura - Burns nearby players
• Ice aura - Slows nearby players
• Speed boost - Temporary speed increase
• Knockback on touch - Pushes attackers away
• Explosion on death - Final defiant blast
• Spawn minions on death - Reinforcements
• Glowing effect - Always visible
• Custom name colors - Visual distinction

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CUSTOM DROP SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Per-mob drop configuration:

• Drop chance (%)
• Material type
• Amount range (min-max)
• Custom display names
• Enchantment support
• Unbreakable items
• Disable vanilla drops

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PvE STATISTICS SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

All data is stored automatically in:

plugins/ControlMobs/player_data.yml

Tracked Statistics:

⚔️ Mob Kills
Number of hostile mobs killed by the player.

Animal Kills
Number of passive animals killed by the player.

Mob Deaths
Counts when a hostile mob kills the player.

KD Ratio
Calculated as: mob_kills / mob_deaths
If deaths = 0 → equals kill count.

Data is stored per UUID and auto-saved.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
REWARD SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Boss rewards per ranking:

Top Damage Dealers
Top 1-5 receive progressively better rewards.
Participation rewards for all contributors.
Final hit bonus for killing blow.

Reward Types:
• Console commands (eco rewards, ranks, etc.)
• Custom items with names and enchants
• Experience points
• Title announcements

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI Integration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Prefix: %cmobs_%

Player Placeholders:
• %cmobs_boss_hp% - Current boss HP
• %cmobs_boss_max_hp% - Maximum boss HP
• %cmobs_boss_name% - Boss display name
• %cmobs_bosses_active% - Active boss count
• %cmobs_player_damage% - Player's damage dealt

Legacy Placeholders (for older versions):
• %cm_mob_kills%
• %cm_animal_kills%
• %cm_mob_dead%
• %cm_kd%

Fully compatible with:
• Scoreboards
• TAB
• Holograms
• GUIs
• Chat formats

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TOP 10 LEADERBOARDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Dynamic Top 10 placeholders:

Mob Kills:
• %cm_top_mob_kills_1% through 10%

Animal Kills:
• %cm_top_animal_kills_1% through 10%

Mob Deaths:
• %cm_top_mob_dead_1% through 10%

Leaderboard format fully configurable:

top-format:
mob_kills: "&6#%position% &f%player% &7- &a%value%"
animal_kills: "&e#%position% &f%player% &7- &a%value%"
mob_dead: "&c#%position% &f%player% &7- &4%value%"

unknown-player: "Unknown"
empty-slot: "&7No data"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Command Permission Description
/cmobs spawn <boss> cmobs.spawn Spawn a configured boss
/cmobs list cmobs.list List all available bosses
/cmobs reload cmobs.reload Reload all configurations
/cmobs stats [player] cmobs.stats View player statistics
/cmobs bosslist cmobs.admin List active bosses
/cmobs bosskill <boss> cmobs.admin Kill a specific boss
/cmobs friendly attack <on/off> cmobs.friendly Toggle friendly attacks
/cmobs friendly protect <on/off> cmobs.friendly Toggle protection
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permission Description
cmobs.* All permissions
cmobs.spawn Spawn bosses
cmobs.list List available bosses
cmobs.reload Reload configurations
cmobs.stats View statistics
cmobs.admin Admin commands
cmobs.friendly Friendly mob commands
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WORLD-BASED CONTROL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Mob systems can be enabled or disabled per world.

Perfect for:
• Lobby separation
• PvP/PvE world separation
• Minigame integration
• Creative vs Survival distinctions

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERFORMANCE & COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Spigot/Paper 1.20.4
• Java 17+
• Lightweight architecture
• Metadata-based cooldown handling
• UUID-based storage
• PlaceholderAPI compatible
• OfflinePlayer leaderboard support
• Tick-based scheduler for stability

Designed to run efficiently even on larger survival servers.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
IDEAL FOR
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Survival Servers
• RPG Servers
• Hardcore Mode
• Boss Raid Events
• PvE Competition Servers
• Leaderboard-driven gameplay

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ARCHITECTURE OVERVIEW
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Modular structure:

• BossManager - Boss spawning and ability execution
• BossData - Boss configuration handling
• MobManager - Mob configuration system
• MobListener - Event handling
• AbilityTask - Tick-based ability engine
• PlayerStatsManager - Statistics storage
• CMPlaceholder - PlaceholderAPI expansion
• CustomDrop - Advanced drop system

The plugin is structured for future expansion:

• MySQL support
• Cached leaderboard system
• GUI-based stat displays
• Boss category tracking
• World-specific statistics

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ControlMobs provides complete boss encounter control combined with competitive statistics, making it suitable for both casual survival servers and advanced RPG environments.




LostDev discord server:
✱ https://discord.gg/6S6jxC5h67
(Join for MORE INFO!)