HealthSteal

Steal hearts from your enemies in PvP combat!

📖 Overview

HealthSteal is an exciting PvP plugin that adds a unique twist to combat - when you kill another player, you steal one of their hearts! Players start with 10 hearts (20 HP) and can gain up to 20 hearts by defeating opponents. But beware - if you lose all your hearts, you'll face the ultimate punishment!

Perfect for hardcore survival servers, UHC events, or any server looking to add high-stakes PvP mechanics!

✨ Key Features

Core Mechanics

🎯 Heart Stealing System - Kill a player to steal their heart
⚙️ Configurable Heart Limits - Set minimum and maximum hearts (default: 1-20)
🔒 PvP Only - Only player kills count, not mob deaths or environmental damage
🎨 Creative Mode Protection - Players in creative mode are excluded from the system
💀 Punishment System - Ban, spectator mode, or kick when losing the last heart

Advanced Features

🤝 Simultaneous Kill Handling - Three modes for mutual kills
🌍 World-Specific - Enable only in specific worlds
🛡️ Bypass Permissions - Exempt certain players from heart stealing
📊 Tab Display - Show heart count next to player names
💾 Auto-Save System - Automatic data saving

Visual & Audio Effects

❤️ Heart Gain Animation - Beautiful heart-shaped particle animation with totem sound
💔 Heart Loss Animation - Damage particles and smoke effects
🔊 Custom Sounds - Configurable sound effects for all events
✨ Particle Effects - Fully customizable particle types and amounts
🎛️ All Effects Toggleable - Disable any animation or sound individually

🎮 Commands

Command	Description
`/healthsteal help`	Show help menu
`/healthsteal reload`	Reload configuration
`/healthsteal set <player> <amount>`	Set player's hearts
`/healthsteal add <player> <amount>`	Add hearts to player
`/healthsteal remove <player> <amount>`	Remove hearts from player
`/healthsteal check [player]`	Check heart count
`/hearts`	Check your own hearts

Aliases: /hs, /hearts

🔑 Permissions

Permission	Description	Default
`healthsteal.*`	Access to all commands	OP
`healthsteal.admin`	Administrative commands	OP
`healthsteal.check.self`	Check own hearts	Everyone
`healthsteal.bypass`	Bypass heart stealing mechanics	OP

⚙️ Configuration

Everything is configurable! Here are some key options:

# Basic settings
starting-hearts: 10
minimum-hearts: 1
maximum-hearts: 20
hearts-per-kill: 1

# Punishment
punishment-type: BAN  # BAN, SPECTATOR, or KICK
ban-duration: 0       # 0 = permanent

# Special cases
simultaneous-kill-mode: BOTH_LOSE  # BOTH_LOSE, BOTH_KEEP, FIRST_KILLER_WINS
count-indirect-kills: true
enabled-worlds: []

# Display
show-hearts-in-tab: true
tab-format: "&c{hearts}❤ &f{player}"

# Animations
animations:
  enabled: true
  on-heart-gain:
    enabled: true
    particles:
      type: "HEART"
      amount: 30

All messages are customizable with color codes and support placeholders!

📦 Installation

Download the plugin JAR file
Place it in your server's plugins/ folder
Restart your server
Configure in plugins/HealthSteal/config.yml
Use /healthsteal reload to apply changes

Requirements:

Minecraft 1.16.5
Spigot or Paper
Java 8+

🎯 Usage Examples

Standard Kill:

Player A (12 hearts) kills Player B (11 hearts)
Result: Player A = 13 hearts, Player B = 10 hearts

Maximum Hearts:

Player A (20 hearts - max) kills Player B (10 hearts)
Result: Player A = 20 hearts (unchanged), Player B = 9 hearts

Final Death:

Player A (5 hearts) kills Player B (1 heart)
Result: Player A = 6 hearts, Player B gets banned

Simultaneous Kill:

Player A and Player B kill each other at the same time
Result: Both players lose 1 heart (BOTH_LOSE mode)

🌟 Why Choose HealthSteal?

✅ Fully Customizable - Every aspect can be configured
✅ Beautiful Animations - Professional particle effects
✅ Performance Optimized - Minimal server impact
✅ Active Development - Regular updates and support
✅ Easy to Use - Simple setup and configuration
✅ No Dependencies - Works standalone

📄 License

Made with ❤️ for the Minecraft community

If you enjoy this plugin, please leave a review and rating!