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