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

---

🔥 Inferno Mace

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 (activates when enemy HP < 30%)

---

🫀 Soul Heart System

Core mechanics & utilities

• Soul Binding Chamber
  Open with: /sm soul — bind your Soul Heart and track progression.

• Soul Forge
  Place the Soul Forge block and interact to forge maces via an in-game GUI.

• Ritual System
  Build specific block patterns to trigger rituals that grant rare upgrades and hidden rewards.

• Soul Heart Transfer
  /sm giftsoul <player> — gift/transfer your Soul Heart to another player.

• Phoenix Tear
  A rare consumable used to revive players or clear ban timers.

---

🎨 Resource Pack (Required for full visuals)

To experience custom models & textures for all 7 maces, include the official resource pack in your plugin page so players can download it.

Download (Resource Pack):
https://www.mediafire.com/file/ksijkolltekq23d/SoulMaces-Reborn.zip/file

Installation (server-side recommended):

1. Upload the ZIP to a public host (or keep this MediaFire link).
2. Set in server.properties: resource-pack=<direct-download-link>
3. Players will be prompted to download when they join the server.

---

✨ Key Features

• 7 Unique Soul Maces with distinct passives & active modes
• Soul Economy: bind a Soul Heart, collect soul energy, craft/upgrade maces
• Live Recipe Editor: admins edit recipes IN-GAME (GUI) without restart
• Double-Shift Mode Switching for instant ability swaps
• Passive Aura Manager: passive effects auto-apply while holding a mace
• Death Penalty Timer shown on Action Bar (configurable)
• Resource Pack Support via CustomModelData
• Cooldown Manager: per-ability cooldown tracking for balance

---

🔐 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, live recipe edits, phoenix items, and unbanning players.

---

📟 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 the resource pack (link above) to enable custom mace textures.
Start forging with: /sm forge → place the Soul Forge and interact to begin crafting.

---

✅ Moderator-Friendly Notes

• Keep soulmaces.admin restricted to trusted staff only.
• The plugin supports in-game recipe editing — we recommend logging recipe changes in staff audit logs.
• Death penalty and revive mechanics are configurable in config.yml — adjust to fit server rules and fairness.
• Resource pack usage is optional; the plugin functions without it (uses default placeholders).

---

© 2026 CSRohit — All Rights Reserved Core mechanics & utilities

• Soul Binding Chamber
  Open with: /sm soul — bind your Soul Heart and track progression.

• Soul Forge
  Place the Soul Forge block and interact to forge maces via an in-game GUI.

• Ritual System
  Build specific block patterns to trigger rituals that grant rare upgrades and hidden rewards.

• Soul Heart Transfer
  /sm giftsoul <player> — gift/transfer your Soul Heart to another player.

• Phoenix Tear
  A rare consumable used 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/upgrade maces
• Live Recipe Editor: admins edit recipes IN-GAME (GUI) without restart
• Double-Shift Mode Switching for instant ability swaps
• Passive Aura Manager: passive effects auto-apply while holding a mace
• Death Penalty Timer shown on Action Bar (configurable)
• Resource Pack Support via CustomModelData
• Cooldown Manager: per-ability cooldown tracking for balance

---

🔐 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, live recipe edits, phoenix items, and unbanning players.

---

📟 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 obtain a Soul Forge in-game: /sm forge → place and interact to start forging.

---

• Keep soulmaces.admin restricted to trusted staff only.
• The plugin supports in-game recipe editing — we recommend logging recipe changes in staff audit logs.
• Death penalty and revive mechanics are configurable in config.yml — adjust to fit server rules and fairness.
• Resource pack usage is optional; the plugin functions without it (uses default placeholders).

---

© 2026 CSRohit — All Rights Reserved