⚔️ MacesAndSpears SMP

Premium Cinematic Weapon Abilities for Minecraft SMP

Transform your SMP with cinematic weapon abilities powered by real Minecraft items.

Giant maces crash from the sky.
Titan spears pierce through enemies.
Legendary powers bend reality itself.

⚔️ POWERS & ABILITIES

🔨 MACE — The Power of Overwhelming Force

Ability	Description	Cooldown
Giant Mace	A massive Mace crashes down from above, crushing your enemy with devastating force	15s
Aerial Mace	Launch your enemy skyward, then follow them for a cinematic aerial finisher	45s

🗡️ SPEAR — The Power of Speed & Precision

Ability	Description	Cooldown
Titan Spear Throw	Hurl a giant Spear at extreme speed — it flies through the world and impales on impact	10s
Impale Rush	Summon a colossal Spear, dash through your enemy at blinding speed, then finish them with a thrust	30s

🌀 LEGENDARY — The Power of Legendary Destruction

Ability	Description	Cooldown
Void Lance	A giant Ender Eye fires a sweeping beam of void energy that damages everything in its path	12s
Gravity Collapse	Create a black hole that pulls enemies in, then implodes with massive AoE damage	40s

💪 STRENGTH SYSTEM

Fight to unlock your full potential.

  Strength 0        Strength 1-2       Strength 3+
┌────────────┐    ┌────────────┐    ┌────────────┐
│ Ability 1  │    │ Ability 1  │    │ Ability 1  │
│     ✓      │    │     ✓      │    │     ✓      │
│            │    │            │    │            │
│ Ability 2  │    │ Ability 2  │    │ Ability 2  │
│     ✗      │    │     ✗      │    │     ✓      │
└────────────┘    └────────────┘    └────────────┘

Kill a player → +1 Strength
Die → -1 Strength
3 Strength → Unlock Ability 2
Withdraw & deposit Strength as physical items

🎮 COMMANDS

Command	Description
`/ability 1`	Activate your first ability
`/ability 2`	Activate your second ability
`/abilities`	View your unlocked abilities
`/strength`	View your current Strength
`/strength withdraw [amount]`	Withdraw Strength as items
`/strength deposit [amount]`	Deposit Strength items
`/power`	View your assigned Power
`/power set <player> <power>`	(OP) Change a player's Power
`/power reset <player>`	(OP) Reset a player's Power

⚙️ CONFIGURATION

Every aspect is fully configurable:

abilities:
  mace:
    giant-mace:
      cooldown: 15
      damage: 8
      scale: 8.0
      launch-power: 2.5
      height: 12
    aerial-mace:
      cooldown: 45
      damage: 14
      scale: 7.0
      launch-height: 15

  spear:
    titan-throw:
      cooldown: 10
      damage: 9
      scale: 5.0
      speed: 3.5
      max-distance: 40
    impale-rush:
      cooldown: 30
      damage: 12
      scale: 6.0
      dash-speed: 2.5

  legendary:
    ability-1:
      cooldown: 12
      damage: 10
      scale: 5.0
    ability-2:
      cooldown: 40
      damage: 16
      scale: 8.0

strength:
  gain-on-kill: 1
  lose-on-death: 1
  ability-1-required: 0
  ability-2-required: 3

✨ FEATURES

Real Minecraft Items — All weapons use actual Mace, Trident, and Ender Pearl models via ItemDisplay — no resource packs required
Cinematic Animations — Smooth interpolation, rotation, scaling, and particle effects
Automatic Power Selection — New players get a random power on first join with a spinning animation
Persistent Data — Strength, cooldowns, and powers survive restarts
Exploit-Proof — Cooldown bypass prevention, duplicate activation blocking, Strength item validation via PersistentDataContainer
Full Cleanup — All display entities and tasks are removed on disconnect, death, or ability cancellation
Lightweight — Optimized with no entity leaks, no permanent entities, no memory leaks
Fully Configurable — Damage, cooldowns, scale, speed, knockback, sounds, and more

📋 REQUIREMENTS

Dependency	Version
Server Software	Paper 1.21.4+
Java	21+
Minecraft	1.21.4

📦 INSTALLATION

Download MacesAndSpears-1.0.0.jar
Place it in your server's plugins/ folder
Restart the server
Edit plugins/MacesAndSpears/config.yml to customize
Players are automatically assigned a power on first join

🎬 HOW IT WORKS

Player joins
     │
     ▼
┌─────────────────────┐
│ Random Power Assigned│
│   MACE / SPEAR /     │
│   LEGENDARY           │
└─────────────────────┘
     │
     ▼
┌─────────────────────┐
│  /ability 1          │
│  Check: Power ✓      │
│  Check: Strength ✓   │
│  Check: Cooldown ✓   │
│  ────────────────     │
│  ACTIVATE ABILITY    │
└─────────────────────┘
     │
     ▼
┌─────────────────────┐
│ Kill Enemy           │
│ +1 Strength          │
│                      │
│ 3 Kills              │
│ Ability 2 UNLOCKED   │
└─────────────────────┘

📜 LICENSE

MIT License — Free to use, modify, and distribute.

Built with ❤️ for the SMP community