SoulMaces Reborn V1

# ⚔️ SOULMACES

### Soul Economy • God Forge • Ultimate Mace Power

Bring **soul-powered weapons** and a **fully immersive soul economy** to your Minecraft server.  

Forge **7 god-tier maces**, bind your **Soul Heart**, and unleash powerful abilities in PvP, SMP, or RPG servers.

> Designed for **Lifesteal • RPG • SMP • PvP**

---

# 📋 Plugin Information

| Property | Value |

|------------------|------------------|

| **Plugin Name** | SoulMaces |

| **Version** | 1.0.0 |

| **API Version** | 1.21+ |

| **Platform** | Bukkit / PaperMC |

| **Author** | CSRohit |

| **Total Maces** | 7 Unique Types |

---

# ⚔️ Soul Maces — Arsenal Overview

Each mace includes:  

• **1 Passive Ability**  

• **2–3 Active Modes**  

Players switch modes instantly with: `⇧⇧ (Double Shift)`

### Maces (summary)

- **Inferno** — Passive: Fire Resistance — Modes: Fireball Launch, Fire Nova Explosion  

- **Aero Smasher** — Passive: Jump Boost II — Modes: Wind Charge, Aero Dash  

- **Wither's Bane** — Passive: Regeneration — Modes: Wither Skull, Soul Drain  

- **Sculk Crusher** — Passive: Night Vision + Haste — Modes: Sonic Boom, Sculk Pulse  

- **Thunderstrike** — Passive: Speed II — Modes: Lightning Strike, Thunder Dash  

- **Void Hammer** — Passive: Ender Dodge — Modes: Ender Pearl Throw, Homing Bullet  

- **Dragon's Fury** — Passive: Resistance II — Modes: Dragon Fireball, Dragon Roar, Execute (HP < 30%)

---

# 🫀 Soul Heart System

- **Soul Binding Chamber** — `/sm soul` to bind your Soul Heart and track progression.  

- **Soul Forge** — Place the Soul Forge block and use the GUI to forge maces.  

- **Ritual System** — Build specific block patterns to unlock rare upgrades and hidden rewards.  

- **Soul Heart Transfer** — `/sm giftsoul <player>` to gift/transfer your Soul Heart.  

- **Phoenix Tear** — Rare consumable to revive players or clear ban timers.

---

# ✨ Key Features

- 7 Unique Soul Maces with distinct passives & active modes  

- Soul Economy: bind a Soul Heart, collect soul energy, craft and upgrade maces  

- Live Recipe Editor: admins edit recipes IN-GAME (GUI) without restart  

- Double-Shift Ability Switching for instant mode swap  

- Passive Aura Manager: auto-applies passive buffs while holding a mace  

- Death Penalty Timer shown on Action Bar (configurable)  

- Resource Pack Support via `CustomModelData`  

- Cooldown Manager for balanced abilities

---

# 🔐 Permissions

| Permission | Description | Default |

|--------------------|----------------------------------------|---------|

| `soulmaces.admin` | Access all admin commands & GUIs | OP only |

**Warning:** Only grant `soulmaces.admin` to trusted staff (it allows spawning maces, recipe edits, phoenix items, and unbanning).

---

# 📟 Commands

**Main:** `/soulmaces` — **Alias:** `/sm`

## Player Commands (Everyone)

- `/sm soul` — Open Soul Binding Chamber  

- `/sm recipes` — View crafting recipes  

- `/sm giftsoul <player>` — Gift your Soul Heart  

- `/sm help` — Show help menu

## Admin Commands (Requires `soulmaces.admin`)

- `/sm give <mace>` — Give a mace (inferno · aero · wither · sculk · thunder · void · dragon)  

- `/sm phoenix` — Give a Phoenix Tear  

- `/sm forge` — Give a Soul Forge block  

- `/sm customrecipe <item>` — Edit recipe live via GUI (items: inferno, aero, wither, sculk, thunder, void, soulforge, phoenixtear)  

- `/sm unban <player>` — Remove player's death penalty/ban timer  

- `/sm reload` — Reload config & recipes

---

# 📦 Installation

1. Download `SoulMaces.jar`  

2. Place inside server `/plugins/` folder  

3. Restart the server

On first run the plugin creates: `config.yml`, `data.yml`, `messages.yml`

(Optional) Provide a resource pack to enable custom mace textures. To get a Soul Forge in-game: `/sm forge` → place and interact to start forging.

---

# 🎨 Official Resource Pack (Recommended)

**Required for full custom mace models & textures.** Using the resource pack is recommended for the intended visual experience; the plugin remains functional without it (default placeholders).

**Download:**  

https://www.mediafire.com/file/ksijkolltekq23d/SoulMaces-Reborn.zip/file

**What it adds:** custom models for all 7 maces, unique weapon textures, and visual ability effects (uses CustomModelData).

**Server tip:** add to `server.properties` to auto-push: