🔨 MaceSMP — The Ultimate Custom Mace Weapon System

Transform your SMP's combat experience with MaceSMP, a high-powered Paper/Spigot plugin tailored for Minecraft 1.21.1+. Instead of standard vanilla weapons, MaceSMP introduces three unique, high-tier weapon paths featuring custom execution matrices, celestial mechanics, and leveling progression.

---

🌟 Core Loop & Progression System

Every weapon starts at Level 1 with baseline modifiers.

• Upgrade by Domination: Defeating another player updates your weapon's internal data container, permanently ranking it up (+1 Level and custom density modifiers) and splashing a server-wide visual achievement!
• The Hard-Core Risk: If you die, your weapon loses 1 Level and drops a physically floating Mace Level Container on the ground. Anyone can steal your lost level container and right-click it to upgrade their own weapon!
• Crafting Alternative: Don't want to hunt players? Assemble a Mace Level Container using rare vanilla assets (Gold Blocks, Diamonds, and an Eye of Ender) to advance your weapon potential safely.

---

☄️ Weapon Archetypes & Mechanics

🪽 The Angel Mace (Celestial & Utility)

• Level 1 — Astral Projection: Right-click to depart your physical frame! Enter a 10-second Spectator Mode to scout enemy lines. If your physical body is attacked, you immediately snap back. If it takes a fatal blow, trigger an automatic Angel Resurrection to restore your life and take flight!
• Level 2 — Beyond Potential: Unleash creative-style flight for 10 seconds, leaving a vortex of wind trails behind you. Upon expiration, explode violently to blow back your pursuers—with built-in fall damage protection!
• Level 3 — Angel Shower: Command an orbital bombardment, striking all nearby entities with cascading lightning matrices.
• Bonus Action — Angel Beam: Right-clicking while flying or resurrected shoots a 30-block energy beam, dealing precision instant damage.

💨 The Breeze Mace (Kinetic & Agility)

• Level 1 — Wind Burst: Right-click to launch yourself forward/upward into the sky using raw kinetic velocity. Full fall-damage immunity included!
• Level 2 — Thunderous Smash: Landing a smash attack from a fall distance strikes your target with real lightning, multiplying damage scales based on how high you fell.
• Level 3 — Cloud Jump: Drop a massive shockwave circle beneath you, leaping extraordinarily high. When you finally hit the deck, a heavy kinetic explosion clears out the battlefield.

🩸 The Damage Mace (Raw Power & Berserker)

• Level 1 — Heavy Criticals: Passively scales an extra +15 flat physical damage onto your base hits, spawning heavy particle trails.
• Level 2 — Adrenaline Rush: Right-click to inject yourself with a 20-second burst of Strength II and Speed II to turn the tide of an asymmetric fight.
• Level 3 — Absolute Strength: Arm an absolute blow. Your next successful attack bypasses standard calculations to instantly strike for 250.0 damage, vaporizing your opponent in a flash of thunder.

---

🛠️ Commands & Configuration

Admin commands require operator status or the macesmp.admin permission node.

• /givemace breeze — Spawns the baseline Level 1 Breeze Mace structure.
• /givemace damage — Spawns the baseline Level 1 Damage Mace structure.
• /givemace angel — Spawns the baseline Level 1 Angel Mace structure.

🚀 Join Gift

To get the action started instantly, the plugin detects when a player logs into your SMP for the very first time and automatically gifts them one random custom Mace archetype to kick off their journey!

---

📦 Installation

1. Ensure your server runs Paper or Purpur (1.21.1 or higher).
2. Drag and drop the MaceSMP.jar into your server's plugins folder.
3. Completely restart your server console.
4. Log in, become OP, and type /givemace to start testing!