❤️ FrozenLives
A hardcore-style lives system: players lose a life on death and gain one on a kill, and once a player runs out of lives they're punished automatically (ban, kick, or spectator). Download it if you want a Hardcore/UHC-style stakes mechanic on a normal-difficulty server, with MySQL support for syncing lives across a network of servers and an anti-farm system to stop players from cheesing kills for extra lives.
👤 Author Info
- Author: DrFrozenXD
✅ Versions / Compatibility / Software Support
- API Version: 1.21
- Server software: Paper and forks
- Folia support: ✅ Supported (
folia-supported: true) - Required dependency: Vault (for the in-game lives shop)
- Soft dependency: PlaceholderAPI (optional — enables placeholders below)
- Storage: YAML (single server, default) or MySQL (cross-server/network sync)
🔐 Permissions
| Permission | Default | Purpose |
|---|---|---|
frozenlives.use |
true | Use basic lives commands |
frozenlives.admin |
op | Full access to admin commands (add/remove/set lives) |
frozenlives.owner |
false | Use /revive — bypasses the zero-lives ban. Not granted to op by default; intended only for the server owner or fully trusted staff |
⌨️ Commands
| Command | Aliases | Usage | Description |
|---|---|---|---|
/lives |
/life, /hearts |
/lives [add|remove|set] <player> <amount> |
Check your own or another player's lives; admins can add, remove, or set a player's life count |
/revive |
— | /revive <player> |
Instantly unbans a zero-lives-banned player and restores their lives |
🎯 Uses
- 💀 Lose a configurable number of lives per death; gain lives back for getting kills.
- ⚖️ Configurable punishment when a player hits zero lives — temporary ban, kick, or spectator mode.
- 🩹
/revivelets trusted staff instantly lift a zero-lives ban and restore lives, without waiting out the ban. - 🎮 Optional hardcore-mode handling — intercepts the vanilla instant-death-on-zero-hearts and respawns the player instead, consuming one life.
- 🚫 Anti-farm protection with a per-kill cooldown and same-victim cooldown, so players can't repeatedly farm the same target for free lives.
- 🌍 Exclude specific worlds from the lives system entirely (deaths/kills there won't affect life counts).
- 🛒 In-game lives shop (Vault-powered) so players can buy extra lives with in-game currency.
- 🌐 MySQL storage option keeps a player's lives synced across every server on a network.
🧩 PlaceholderAPI Placeholders
| Placeholder | Returns |
|---|---|
%frozenlives_lives% |
The player's current life count |
%frozenlives_kills% |
The player's total kills tracked by FrozenLives |
%frozenlives_deaths% |
The player's total deaths tracked by FrozenLives |
⚙️ Key Config Areas (config.yml)
lives.*— default/max/min life count for new and existing playersdeath.*— lives lost per death, excluded worlds, zero-lives punishment (ban/kick/spectator)revive.lives-restored— how many lives/revivegrantshardcore.handle-hardcore-respawn— toggle hardcore-mode respawn handlingkills.*— whether kills grant lives, and how manyanti-farm.*— kill cooldown and same-victim cooldown settingsstorage.*— YAML or MySQL storage, including connection pool settingsmessages.*— every user-facing message, with full color code support

