⚔️ 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

1. Download MacesAndSpears-1.0.0.jar
2. Place it in your server's plugins/ folder
3. Restart the server
4. Edit plugins/MacesAndSpears/config.yml to customize
5. 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