LifeSteal Plugin

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

Features

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

Default Configuration

# +--------------------------------------------------------------------------+
# |              ------====== 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