VengeanceVow

# VengeanceVow Turn player deaths into cooperative adventures! **VengeanceVow** is a highly engaging, fully localized survival utility plugin that introduces a unique gameplay mechanic: when a player is killed by a monster, a rescue mission is declared. Other players can accept the mission to hunt down the killer (now a glowing, protected Nemesis mob), rescue their friend's soul, and claim XP rewards. --- ## ⚡ Core Features * **Interactive Death Broadcasts:** When a player dies, a server-wide announcement with clickable `` and `` buttons is sent. * **Vengeance Missions:** Accepting a mission starts a 15-minute countdown (tracked with a neat BossBar) to hunt down the Nemesis mob. * **Dynamic XP Rewards:** The rescuer receives 5% of the dead player's pre-death XP as a reward upon success. * *If `keepInventory` is enabled:* 5% of the dead player's XP is safely sacrificed for their rescuer upon success. The dead player loses no XP if the mission fails/times out. * *If `keepInventory` is disabled:* The dead player never loses XP. However, if the mission has been accepted by a rescuer and fails/times out, the rescuer who accepted the mission loses 5% of the dead player's XP as a penalty. * **Anti-Sabotage & Safety Checks:** * Only the assigned rescuer (and the dead player) can damage the Nemesis. Other players cannot steal the kill. * Environmental protections keep the Nemesis from burning in daylight (`CombustEvent` protection). * If the Nemesis dies from environmental sources (lava, falling) or the rescuer logs out, the mission is safely cancelled with **no penalty**. * **Self-Revenge:** The dead player can fight and kill their own killer to successfully close the mission without any penalties. * **Full Internationalization:** Out-of-the-box support for **English, Turkish, German, Spanish, and Russian**. The plugin dynamically sends translations based on each player's Minecraft client language! * **bStats Integration:** Built-in lightweight metrics reporting to track plugin usage. --- ## 🎮 Commands & Permissions All players need the `vengeancevow.use` permission to interact with the plugin, and admins need `vengeancevow.admin` to manage it. | Command | Permission | Description | | :--- | :--- | :--- | | `/vv accept <id>` | `vengeancevow.use` | Accepts a pending vengeance mission. | | `/vv reject <id>` | `vengeancevow.use` | Rejects a pending vengeance invitation. | | `/vv cancel` | `vengeancevow.use` | Cancels your currently active accepted mission. | | `/vv reload` | `vengeancevow.admin` | Reloads configuration files and languages. | --- ## 🔧 Configuration The configuration allows full control over the plugin mechanics: ```yaml # Settings for VengeanceVow settings: # The timeout in seconds for accepting a mission (Default: 5 minutes) accept-timeout: 300 # The time limit in seconds to kill the Nemesis (Default: 15 minutes) mission-duration: 900 # bStats Integration (Official ID: 32596) bstats: enabled: true ``` ## 🌐 Dynamic Localization The plugin automatically detects the client language. You can customize the language files inside the plugins/VengeanceVow/lang/ folder. Default files: en.json (English) tr.json (Turkish) de.json (German) es.json (Spanish) ru.json (Russian)