Lifesteal-Plugin

LifeSteal Plugin

A lightweight lifesteal plugin for Paper 1.21 and above build by theTWIXhunter

Features

- /giftheart: When a player kills another player, the victim loses 1 heart and the killer gains it - /giftheart: Execute custom commands when a player reaches less than 1 heart - /giftheart: Only active in configured worlds - /giftheart: Fully customizable through config.yml - /giftheart: Players can gift other players hearts, gifting hearts to an eliminated player revives them.

Default Configuration

```yaml

+--------------------------------------------------------------------------+

| ------====== Lifesteal PLUGIN ======------ |

| --- By TheTWIXhunter --- |

+--------------------------------------------------------------------------+

| | |

| More information about this config file can be found here: (WIP) |

| https://thetwixhunter.nekoweb.org/lifesteal/guides/configuration.html |

| |

+--------------------------------------------------------------------------+

+--------------------------------------------------------------------------+

| ------====== GENERAL SETTINGS ======------ |

+--------------------------------------------------------------------------+

Messages file (located in the plugin's folder)

Set to 'messages.yml' to use the default messages file

You can create custom message files and reference them here

messages-file: "messages.yml"

Worlds where lifesteal is enabled

enabled-worlds: - world - world_nether - world_the_end

+--------------------------------------------------------------------------+

| ------====== ELIMINATION & REVIVE SETTINGS ======------ |

+--------------------------------------------------------------------------+

Commands to run when a player reaches the elimination threshold (with operator permissions)

Use %player% placeholder for the player's name

elimination-commands: - "kick %player% You have been eliminated!" - "broadcast %player% has been eliminated from the server!" - "ban %player% You ran out of hearts!" # REMOVE IF YOU DON'T WANT PLAYERS TO BE BANNED UPON ELIMINATION

Revive settings

Commands to run when a player is revived by an operator

Users can revive other users by gifting them hearts.

revive:

Hearts to set when a player is revived by an opertator (using the /lifestealplugin revive command.)

hearts: 10.0

Commands to run when a player is revived (with operator permissions)

Use %player% placeholder for the player's name

commands: - "broadcast %player% has been revived!" - "pardon %player% You have been revived by an operator!" # REMOVE IF YOU DON'T WANT PLAYERS TO BE UNBANNED UPON REVIVAL

+--------------------------------------------------------------------------+

| ------====== HEARTS SETTINGS ======------ |

+--------------------------------------------------------------------------+

| The settings below are in hearts, not health points. |

| (1 heart = 2 health points.) |

| Please always check this to avoid issues with heart values. |

| You can use decimal values for hearts but only .5 increments |

| (e.g., 0.5 = 1 health point, Minecraft's minimum). |

+--------------------------------------------------------------------------+

hearts:

Amount of hearts a new player starts with

starting: 10.0

Amount of hearts gained/lost per kill (1 heart = 2 health points)

amount: 1.0

Hearts at or below which a player gets eliminated (0.5 = 1 health point, Minecraft's minimum)

eliminate-at: 0.5

Maximum hearts a player can have

maximum: 20.0

Heart crafting recipe

crafting:

Enable or disable heart crafting

enabled: true

Recipe pattern (3x3 crafting grid)

Use material names from https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

recipe: row1: "DIAMOND,GOLD_INGOT,DIAMOND" row2: "REDSTONE,NETHER_STAR,REDSTONE" row3: "DIAMOND,EMERALD,DIAMOND"

```

Building

Run `mvn clean package` to build the plugin. The compiled JAR will be in the `target` folder.

Installation

1. Build the plugin or download the JAR 2. Place the JAR in your server's `plugins` folder 3. Restart the server 4. Configure the plugin in `plugins/LifeSteal/config.yml` 5. Reload or restart the server

Author

me.thetwixhunter