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

Main Permissions

Permission	Description	Default
healthsteal.*	Access to all commands	OP
healthsteal.admin	Administrative commands (includes all admin permissions)	OP
healthsteal.bypass	Bypass heart stealing mechanics (immune to heart loss)	OP

Command Permissions

Permission	Description	Default
healthsteal.reload	Reload plugin configuration	OP
healthsteal.set	Set player's heart count	OP
healthsteal.add	Add hearts to player	OP
healthsteal.remove	Remove hearts from player	OP
healthsteal.check.self	Check your own heart count	Everyone
healthsteal.check.others	Check other players' hearts	OP
healthsteal.give	Give hearts to other players	Everyone
healthsteal.revive	Revive dead players (costs hearts)	Everyone
healthsteal.revive.admin	Revive players without cost	OP
healthsteal.stats.self	View own statistics	Everyone
healthsteal.stats.others	View other players' statistics	OP

Note: Permissions with "Everyone" default are available to all players. Permissions with "OP" default require operator status.

---

⚙️ 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

1. Download the plugin JAR file
2. Place it in your server's plugins/ folder
3. Restart your server
4. Configure in plugins/HealthSteal/config.yml
5. 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

---

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