LifeWars

# LifeWars ## **What You Should Know!** LifeWars is my own Minecraft plugin that introduces the popular **lifesteal mechanic** to your **server or gameplay**. LifeWars is designed to be highly configurable, with **25+ configuration options** allowing you to customize how lifesteal works on your server. --- ## **Why I Made LifeWars** I made LifeWars because I wanted a lifesteal plugin that I could actually use for my own communities and servers. I also wanted to make something that gives server owners **more control** over their lifesteal experience instead of being stuck with a fixed system. --- ## **Things YOU Can Do** *(Only a small part of the plugin!)* * ✅ **Enable / Disable** the entire plugin * ✅ **Enable / Disable** Reviving * ✅ **Enable / Disable** Heart usage and equipping * ✅ **Set** Maximum Health * ✅ **Set** Revive Health * ✅ **Toggle** Commands * ✅ **Enable / Disable** Custom Recipes * ✅ **Enable / Disable** Heart Recipes * ✅ **Enable / Disable** Revive Recipes * ✅ **Set** Custom Messages * ✅ **Change** Item Names * ✅ **Change** Item Lore * ✅ **Customize** Heart Items * ✅ **Customize** Revive Items * ✅ **Customize** Crafting Recipes * ✅ **Edit Recipes** directly in-game * ✅ **Spawn** LifeWars items through admin commands * ✅ **Manage** eliminated/banned players * ✅ **Configure** almost every part of the plugin --- ## **Custom Crafting Recipes** LifeWars now supports **fully configurable crafting recipes**. You can customize the layouts for: **|- Heart Recipe:** **|- Revive Recipe:** Recipes can also be edited **in-game** using the recipe editor, allowing server administrators to change recipes without manually editing the configuration. --- ## **Commands** LifeWars includes several commands for both players and administrators. Most of the commands are **admin-related**, allowing server owners to manage health, revives, configuration, recipes, and LifeWars items. Some of the available functionality includes: * **Admin Revive** * **Eliminate** * **Set Health** * **Reload Configuration** * **Edit Configuration** * **Admin Item Spawning** * **Recipe Editing** --- ## **Permissions** * **LifeWars**.adminrevive.**use** * **LifeWars**.EditConfig.**use** * **LifeWars**.sethealth.**use** * **LifeWars**.eliminate.**use** * **LifeWars**.reloadconfig.**use** * **LifeWars**.adminspawnitem.**use** --- # **How to Use Items** ## **|- Revive Item** ### **Step 1** Craft the **Revive Item**. Depending on your configuration, the recipe may not appear in the crafting recipe book because Minecraft does not recognize the custom Heart ingredient normally. ### **Step 2** Rename the Revive Item to the name of the **eliminated player** you want to revive. ### **Step 3** Right-click with the renamed Revive Item. If the player is eliminated, they will be revived. --- ## **|- Heart Item** ### **Step 1** Craft the **Heart** using the configured recipe. ### **Step 2** Done! You can use Hearts to: * ❤️ Give health to another player * ❤️ Equip/use a Heart * ❤️ Use Hearts in the Revive recipe --- # **Heart System** Hearts are the main item used by the LifeWars lifesteal system. Players can configure how Hearts work, including whether they can be used or equipped and how much health players can have. LifeWars also supports **custom item models and CustomModelData**, allowing resource packs to give the Heart item a completely custom appearance. --- # **Elimination & Reviving** When a player reaches the configured elimination condition, they can be added to the LifeWars banned/eliminated player system. The plugin includes: * Player elimination * Automatic ban handling * Ban and kick functionality * Unbanning through the revive system * Offline-player handling * Revive item validation * Configurable revive health * Banned players are stored in a dedicated **BannedPlayers.yml** file. --- # **Configuration** LifeWars is built around configuration. You can edit the plugin's `config.yml` to change things such as: * Maximum health * Revive health * Heart settings * Revive settings * Item names * Item lore * Messages * Crafting recipes * PvP restrictions * Banned items * Plugin features The configuration also contains comments explaining what different settings do. ### **Basic Configuration** ```yaml features: reviveBookEnabled: true heartUseEnabled: true withdrawCommandEnabled: true gameplay: maxHealth: 40 reviveHealth: 8 dropHeartsIfMax: true items: # Heart heartName: "<bold><#d9252e>Heart" heartLore: "<gray>Right-click to use!" # New string-based item model key (1.21+ style). Example: "lifewars:defaultheart" # If set, this is used instead of heartCustomModelData. heartItemModel: "lifewars_defaultheart" heartCustomModelData: -1 # Revive Book reviveBookName: "<aqua>Revive Book" reviveBookLore: "<dark_aqua>Rename this book to the player name you want to revive, then right-click to revive that player!" recipes: customRecipesEnabled: true