# 👻 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 ` | `soulsplugin.ressusciter` | Revive a dead player immediately | | `/souls spawnmort` | `soulsplugin.spawnmort` | Set death/ban spawn at current location | | `/souls donner gemme ` | `soulsplugin.donnergemme` | Give a Soul Gem to a player | | `/souls donner bangemme ` | `soulsplugin.donnerbangemme` | Give a Ban Gem to a player | | `/souls donner debangemme ` | `soulsplugin.donnerdebangemme` | Give an Unban Gem to a player | | `/souls donner ame ` | `soulsplugin.donnerame` | Give a Superior Soul to a player | | `/souls retirer gemme ` | `soulsplugin.retirergemme` | Remove a Soul Gem from a player | | `/souls retirer bangemme ` | `soulsplugin.retirerbangemme` | Remove a Ban Gem from a player | | `/souls retirer debangemme ` | `soulsplugin.retirerdebangemme` | Remove an Unban Gem from a player | | `/souls retirer ame ` | `soulsplugin.retirerame` | Remove a player's absorbed Superior Soul | > **Valid `` 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`.

paupieraxel