❤ xLifeSteal - Premium Minecraft Lifesteal Plugin ❤

A comprehensive Minecraft Bukkit/Spigot plugin that innovates player interactions through a sophisticated lifesteal mechanic system, creating a dynamic heart-based economy with strategic gameplay elements and advanced visual animations.

✨ Features ✨

❤️ Heart Management System ❤️
- Dual Mode System: Choose between Physical mode (hearts drop as items) or Virtual mode (hearts transfer directly).
- Physical Mode: When a player kills another player, a heart drops as a physical item on the ground.
- Virtual Mode: When a player kills another player, hearts transfer directly with visual effects and messages.
- Three-Tier Heart Items: Basic, Enhanced, and Premium hearts with increasing values and special effects.
- Configurable Limits: Set minimum, maximum, and default heart values.
- Death Penalties: Configurable heart loss on death.
- Elimination System: Ban players who lose all hearts (optional).
- Custom Heart Textures: Support for resource pack with customized heart appearance. [Soon]

Revival System
- Command-Based Revival: Fully command-driven resurrection system.
- Revival Beacon: Place special beacons that enable revival of eliminated players.
- Multiple Cost Types: Hearts, Totem of Undying, or Revival Tokens.
- Proximity Check: Requires players to be near beacons for revival (10 blocks).

Advanced Animation System
- Customizable Effects: Fully configurable animations for all actions.
- Tier-Specific Animations: Different visuals based on heart tier.
- Intensity Control: Adjust animation intensity in config.

PlaceholderAPI Integration
- Heart Count Display: Show players' hearts in tab list and scoreboards.
- Multiple Format Options: Various formatting styles for heart counts.
- Status Indicators: Display whether a player is alive or eliminated.
- Mode Information: Show the current plugin mode.

Commands

Basic Commands
- /lifesteal info - Display your heart information.
- /lifesteal help - Show available commands.
- /lifesteal transfer <player> <amount> - Transfer hearts to another player.

Admin Commands
- /lifesteal setmode <physical|virtual> - Change the plugin mode.
- /lifesteal sethearts <player> <amount> - Set a player's hearts.
- /lifesteal giveitem <player> <type> <amount> - Give heart items to a player.
- /lifesteal revive <player> - Revive an eliminated player.
- /ls eliminate <player> <time> - Ban a player for a particular time period.
- /lifesteal recipe heart - See Heart's Recipe.
- /lifesteal recipe beacon - See Beacon's Recipe.
- /lifesteal reload - Reload the plugin configuration.

Permissions
- xls.admin.* - All admin permissions.
- xls.admin.reload - Permission to reload the plugin.
- xls.admin.setmode - Permission to change mode.
- xls.admin.sethearts - Permission to set hearts.
- xls.admin.giveitem - Permission to give items.
- xls.admin.revive - Permission to revive players.
- xls.use - Basic plugin usage (default: true).

⚙️ Configuration ⚙️
Adjust all settings in the config.yml file:

Config.yml

PlaceholderAPI Integration

Available Placeholders
- %xlifesteal_hearts% - Player's current heart count (e.g., 10).
- %xlifesteal_hearts_formatted% - Formatted heart count (e.g., ❤ x10).
- %xlifesteal_hearts_symbol% - Heart count with symbol (e.g., 10❤).
- %xlifesteal_max_hearts% - Maximum possible hearts.
- %xlifesteal_min_hearts% - Minimum possible hearts.
- %xlifesteal_mode% - Current plugin mode (e.g., PHYSICAL or VIRTUAL).
- %xlifesteal_status% - Player's status (e.g., ALIVE or ELIMINATED).

Installation
1. Place the plugin JAR file in your server's plugins folder.
2. Install PlaceholderAPI if you want to use the placeholder features.
3. Install any optional dependencies you'd like to use (see below).
4. Restart the server or use /reload confirm.
5. Edit the configuration in plugins/xLifeSteal/config.yml if needed.
6. Use /lifesteal reload to apply changes.

Dependencies
Required Dependencies
- SpigotAPI/Paper (Minecraft 1.20.1 - 1.20.4+).

Optional Dependencies
- PlaceholderAPI: For displaying heart data in other plugins and scoreboards.
- WorldGuard: For region-based protection of lifesteal mechanics.