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

Aliases: /hs, /hearts

🔑 Permissions

Main Permissions

Command Permissions

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!