UltimateLifeSteal

** UltimateLifeSteal

The Ultimate LifeSteal SMP Experience

| Version | Minecraft | Java | API | |:---|:---|:---|:---| | 1.0.0 | 1.21.1+ | 21+ | Paper |

📖 Description

UltimateLifeSteal is a comprehensive, feature-rich LifeSteal SMP plugin designed for Minecraft 1.21.1+ Paper servers. It transforms your survival server into an intense, high-stakes PvP experience where every kill matters and every death has permanent consequences.

What is LifeSteal? LifeSteal is a popular SMP (Survival Multiplayer) game mode where: * Revival is possible - The killer gains permanent health. * Revival is possible - The victim loses permanent health. * Revival is possible - Players are banned until revived. * Revival is possible - Teammates can craft special items to bring back eliminated players.

Why Choose UltimateLifeSteal?

| Feature | UltimateLifeSteal | Other Plugins | |---|---|---| | Languages | Paper 1.21.1 + Adventure | Outdated Bukkit | | Languages | ✅ Full MiniMessage | ❌ Limited | | Languages | ✅ HikariCP Pool | ❌ Often SQLite only | | Languages | ✅ PDC Validation | ❌ Easy to fake | | Languages | ✅ Custom Flags | ❌ Limited | | Languages | ✅ Full API + Events | ❌ None | | Languages | ✅ 13+ Languages | ❌ English only |

---

⭐ Key Features

💗 Heart Mechanics * Visuals: (Default: 10) * Visuals: (Default: 20) * Visuals: (Default: 0 - leads to elimination) * Visuals: Set hearts gained/lost per kill or death. * Visuals: Health bar updates in real-time.

⚔️ PvP Heart Stealing * Anti-Abuse: Kill a player to gain their heart instantly. * Anti-Abuse: Satisfying sound effects, particles, and screen notifications. * Anti-Abuse: Tracks Kills, Deaths, Hearts Stolen, and K/D Ratio. * Anti-Abuse: Cooldowns for killing the same player repeatedly to prevent farming.

☠️ Elimination System Choose what happens when a player reaches 0 hearts: * Kick Mode: Player is banned from the server until revived. * Kick Mode: Player becomes a spectator; can watch but not play. * Kick Mode: Player is kicked and re-kicked on join.

💚 Revival System * Broadcasts: Craftable item to bring back eliminated players. * Broadcasts: Inventory GUI to select who to revive. * Broadcasts: Built-in checks to prevent accidents. * Broadcasts: Server-wide announcement when someone is revived.

📦 Heart Withdraw System * Safety: Convert your hearts into tradeable items. * Safety: Allows players to trade hearts as currency. * Safety: Minimum heart protection prevents withdrawing if HP is too low.

🛡️ Game Rules & Balancing * Disabled Worlds: Option to make Totems of Undying ineffective. * Disabled Worlds: Prevent End Crystal PvP. * Disabled Worlds: Optional setting to lose hearts slowly over time. * Disabled Worlds: Disable LifeSteal mechanics in specific worlds (e.g., Lobby).

🗄️ Database Support * MySQL / MariaDB: Zero config, perfect for single servers. * MySQL / MariaDB: High performance, perfect for Bungee/Velocity networks.

---

🎯 How It Works

Basic Gameplay Flow 1. Revive Crystal Starts with default hearts (e.g., 10 Hearts). 2. Revive Crystal * Revive Crystal They gain +1 Heart. * Revive Crystal They lose -1 Heart. 3. Revive Crystal * If hearts drop to 0, the player is Revive Crystal (Banned/Spectator). 4. Revive Crystal * A teammate crafts a Revive Crystal. * They use the crystal to unban the eliminated player. * The player returns with default hearts.

Heart Economy * Trading: Kill players, use Heart Items, or Admin commands. * Trading: Die to players, die to environment (optional), or withdraw hearts. * Trading: Withdraw hearts into physical items to trade with others.

---

💻 Commands

Player Commands | Command | Description | Permission | |---|---|---| | `/withdraw <amount>` | Withdraw hearts into items | `ultimatelifesteal.withdraw` | | `/hearts` | View your current heart count | `ultimatelifesteal.hearts` | | `/hearts <player>` | View another player's hearts | `ultimatelifesteal.hearts.others` | | `/recipes` | Open custom recipe viewer | `ultimatelifesteal.recipes` |

Admin Commands | Command | Description | Permission | |---|---|---| | `/uls help` | Show help menu | `ultimatelifesteal.admin` | | `/uls sethearts <player> <amount>` | Set a player's hearts | `ultimatelifesteal.sethearts` | | `/uls giveitem <type> [player]` | Give custom items | `ultimatelifesteal.giveitem` | | `/uls revive <player>` | Revive an eliminated player | `ultimatelifesteal.revive` | | `/uls reset <player>` | Reset a player's data | `ultimatelifesteal.reset` | | `/uls reload` | Reload configuration | `ultimatelifesteal.reload` |

---

🔐 Permissions

Permission List * `ultimatelifesteal.admin` - Gives access to all admin commands. * `ultimatelifesteal.withdraw` - Allow withdrawing hearts. * `ultimatelifesteal.recipes` - Allow viewing recipes. * `ultimatelifesteal.use.heart` - Allow using heart items. * `ultimatelifesteal.use.revive` - Allow using revive crystals. * `ultimatelifesteal.craft.heart` - Allow crafting hearts. * `ultimatelifesteal.craft.revive` - Allow crafting revive crystals.

Bypass Permissions * `ultimatelifesteal.bypass.max` - Bypass max heart limit. * `ultimatelifesteal.bypass.elimination` - Cannot be eliminated. * `ultimatelifesteal.bypass.heartloss` - Does not lose hearts on death.

---

📊 Placeholders (PlaceholderAPI)

Basic Stats | Placeholder | Description | |---|---| | `%ultimatelifesteal_hearts%` | Current hearts | | `%ultimatelifesteal_max_hearts%` | Maximum hearts allowed | | `%ultimatelifesteal_health%` | Current health points | | `%ultimatelifesteal_kills%` | Total kills | | `%ultimatelifesteal_deaths%` | Total deaths | | `%ultimatelifesteal_kdr%` | Kill/Death ratio |

Leaderboards Replace `1` with any rank number (1-100). * `%ultimatelifesteal_top_kills_1%` - Name of 1 Killer * `%ultimatelifesteal_top_kills_1_value%` - Kills of 1 Killer * `%ultimatelifesteal_top_hearts_1%` - Name of player with most hearts * `%ultimatelifesteal_top_hearts_1_value%` - Heart count of player

---

🎁 Custom Items & Crafting

❤️ Heart Item * Validation: Right-click to consume and gain +1 Permanent Heart. * Validation: Uses PersistentDataContainer (Players cannot fake hearts by renaming items in an anvil).

Bottom Row: * Bottom Row: Diamond, Gold Block, Diamond * Bottom Row: Gold Block, Nether Star, Gold Block * Bottom Row: Diamond, Gold Block, Diamond

✦ Revive Crystal * Usage: Right-click to open the Revival Menu and bring back a banned player.

Bottom Row: * Bottom Row: Emerald Block, Beacon, Emerald Block * Bottom Row: Totem of Undying, Nether Star, Totem of Undying * Bottom Row: Emerald Block, Beacon, Emerald Block

*> Note: All recipes are fully customizable in `recipes.yml`.*

---

⚙️ Configuration

The plugin generates the following files: * `config.yml` - Main settings. * `recipes.yml` - Edit crafting recipes. * `languages/` - Translate messages (en-US, es-ES, de-DE, etc).

Example: Hearts Config ```yaml hearts: starting: 10 max: 20 min: 0 per-kill: 1 per-death: 1 lose-on-natural-death: false lose-on-pvp-death: true ```

Example: Elimination Config ```yaml elimination: enabled: true action: ban Options: ban, spectator, kick broadcast: true ```

---

📥 Installation

1. Run the JAR file. 2. Run it into your server's `/plugins/` folder. 3. Run your server. 4. Run `config.yml` to your liking. 5. Run `/uls reload` to apply changes.

Requirements: * Paper 1.21.1 or higher (Spigot is not supported due to modern API usage). * Java 21 or higher.

---

Made with ❤️ for the Minecraft Community**