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.

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.
• /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:


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).

Usage Examples
In Tab List (with TAB plugin)
# In tab.yml
TABLIST:
header: "&6&lXLifeSteal Server\n&7Hearts: %xlifesteal_hearts_formatted%"
footer: "&7Status: %xlifesteal_status%"

In Scoreboard
# In a scoreboard plugin config
lines:
- "&6&lPlayer Stats"
- "&7Hearts: &c%xlifesteal_hearts_symbol%"
- "&7Mode: &e%xlifesteal_mode%"
- "&7Status: &a%xlifesteal_status%"

In Chat Format (with EssentialsX Chat)
# In essentials/config.yml
chat:
format: "<{DISPLAYNAME}> &7[&c%xlifesteal_hearts%&7] {MESSAGE}"

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 from heart loss.
• CombatLogX: For preventing combat logging exploits.
• DeluxeCombat: For validating PvP kills.
• PvPManager: For checking players' PvP state.

Compatibility
Platform Compatibility

• Minecraft Versions: 1.20.1 - 1.21.4.
• Server Software: Spigot, Paper, Purpur.

Plugin Integrations

• PlaceholderAPI: Full integration for displaying heart data in other plugins.
• WorldGuard: Region-based protection from heart loss in specific areas.
• CombatLogX: Prevents combat logging exploits with proper integration.
• DeluxeCombat: Validates legitimate PvP kills for heart transfers.
• PvPManager: Respects player's PvP toggle state for heart mechanics.
• Tab plugins: Compatible with TAB, TabList, and similar plugins.
• Chat plugins: Works with EssentialsX Chat, LPC, and other formatting plugins.
• Scoreboard plugins: Integrates with most scoreboard plugins that support PlaceholderAPI.

Custom Heart Textures (Resource Pack)
The plugin includes support for custom heart textures through a resource pack:

1. Navigate to the LifeStealTexturePack folder inside the plugin directory.
2. Edit the heart textures in the resource pack:
   • assets/minecraft/textures/gui/sprites/hud/heart/container.png - Empty heart container texture.
   • assets/minecraft/textures/gui/sprites/hud/heart/full.png - Full heart texture.
   • assets/minecraft/textures/gui/sprites/hud/heart/half.png - Half heart texture.
3. Customize the heart item textures if you're using a custom material:
   • Use the correct path based on your selected heart item material.
   • Default is assets/minecraft/textures/item/totem_of_undying.png.
4. Ensure PNG files have transparent backgrounds and maintain the original dimensions.
5. Test with different screen resolutions to ensure proper display.
6. Compress the resource pack folder into a ZIP file.
7. Host the resource pack on a file hosting service or your own server.
8. Add the resource pack URL to your server's server.properties file:
   resource-pack=YOUR_RESOURCE_PACK_URL_HERE
   resource-pack-prompt=Your custom heart textures await!
   
   
9. Restart your server for the changes to take effect.

Developer

• Author: GodXPro
• Discord: godxpro.exe