MacesAndSpears SMP S1

<div align="center"> # ⚔️ MacesAndSpears SMP ### *Premium Cinematic Weapon Abilities for Minecraft SMP* <br/> !(https://img.shields.io/badge/Minecraft-1.21.4-blue?style=for-the-badge&logo=minecraft) !(https://img.shields.io/badge/Paper-1.21.4-orange?style=for-the-badge&logo=papermc) !(https://img.shields.io/badge/Java-21-red?style=for-the-badge&logo=openjdk) !(https://img.shields.io/badge/License-MIT-green?style=for-the-badge) <br/> --- <br/> ## **Transform your SMP with cinematic weapon abilities powered by real Minecraft items.** <br/> **Giant maces crash from the sky.** **Titan spears pierce through enemies.** **Legendary powers bend reality itself.** <br/> --- <br/> ## ⚔️ POWERS & ABILITIES <br/> ### 🔨 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 | <br/> ### 🗡️ 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 | <br/> ### 🌀 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 | <br/> --- <br/> ## 💪 STRENGTH SYSTEM <br/> 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 │ │ ✗ │ │ ✗ │ │ ✓ │ └────────────┘ └────────────┘ └────────────┘ ``` <br/> - **Kill a player → +1 Strength** - **Die → -1 Strength** - **3 Strength → Unlock Ability 2** - Withdraw & deposit Strength as physical items <br/> --- <br/> ## 🎮 COMMANDS <br/> | 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 ` | Withdraw Strength as items | | `/strength deposit ` | 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 | <br/> --- <br/> ## ⚙️ CONFIGURATION <br/> Every aspect is fully configurable: ```yaml 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 ``` <br/> --- <br/> ## ✨ FEATURES <br/> - **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 <br/> --- <br/> ## 📋 REQUIREMENTS <br/> | Dependency | Version | |:----------:|:-------:| | **Server Software** | Paper 1.21.4+ | | **Java** | 21+ | | **Minecraft** | 1.21.4 | <br/> --- <br/> ## 📦 INSTALLATION <br/> 1. Download `MacesAndSpears-1.0.0.jar` 2.