👻 SoulsPlugin

Manage player lives, death timers, soul crafts, and powerful Superior Souls! Compatible with Paper / Spigot 1.21+ — Full in-game admin control & permissions integration.

---

Note on Development: Part of the code for this project was developed with the assistance of Artificial Intelligence (AI).

---

SoulsPlugin brings a complete life and soul management system to your server. Players can track their remaining souls, craft unique items via a custom recipe menu, and withdraw souls into tradeable Soul Gems. Administrators benefit from a feature-rich GUI panel, allowing complete configuration directly in-game.

The plugin also features 10 unique Superior Souls with distinct passive abilities, dynamic death spawn locations, and permission-based tab completion.

---

✨ Key Features

• 💎 Soul & Gem System: Track player souls, view death timers, and convert personal souls into physical Soul Gems.
• 🔮 10 Superior Souls: Unique soul abilities (cieux, terrestre, vitalite, abysses, furtive, celeste, dimensionnelle, oceanique, infernale, supreme).
• 📜 In-Game Recipe Menu: Browse custom recipes directly through /souls recettes.
• 🛠️ In-Game Admin GUI Panel: Manage the entire plugin on the fly via /souls adminames.
• 🛡️ Emergency Lockdown: If disabled, all features are locked except the admin panel to allow easy re-activation.
• 🔒 Smart Tab Completion: Command auto-completion dynamically filters subcommands based on player permissions.

---

🖥️ Commands & Permissions

👤 Player Commands (Accessible to everyone)

Command	Description
/souls ames	Display your remaining souls
/souls tempsmort	Check remaining time before revival
/souls recettes	Open the custom crafting recipe menu
/souls retirerame	Withdraw 1 soul as a Soul Gem (Requires > 1 soul)

🛠️ Admin Commands (Default: OP)

Command	Permission	Description
/souls adminames	soulsplugin.adminames	Open the full admin panel GUI
/souls ressusciter <player>	soulsplugin.ressusciter	Revive a dead player immediately
/souls spawnmort	soulsplugin.spawnmort	Set death/ban spawn at current location
/souls donner gemme <player>	soulsplugin.donnergemme	Give a Soul Gem to a player
/souls donner bangemme <player>	soulsplugin.donnerbangemme	Give a Ban Gem to a player
/souls donner debangemme <player>	soulsplugin.donnerdebangemme	Give an Unban Gem to a player
/souls donner ame <id_ame> <player>	soulsplugin.donnerame	Give a Superior Soul to a player
/souls retirer gemme <player>	soulsplugin.retirergemme	Remove a Soul Gem from a player
/souls retirer bangemme <player>	soulsplugin.retirerbangemme	Remove a Ban Gem from a player
/souls retirer debangemme <player>	soulsplugin.retirerdebangemme	Remove an Unban Gem from a player
/souls retirer ame <player>	soulsplugin.retirerame	Remove a player's absorbed Superior Soul

Valid <id_ame> values: cieux, terrestre, vitalite, abysses, furtive, celeste, dimensionnelle, oceanique, infernale, supreme.

---

📦 Installation

1. Download the latest .jar file and place it into your plugins/ directory.
2. Restart your server.
3. Configure administrative settings in-game via /souls adminames or in config.yml.