!VoidDeath Banner

☠️ VoidDeath

Lives and death-ban system for Hardcore Minecraft servers.

VoidDeath gives every player a configurable number of lives. Each death consumes one life, and losing the last one applies a timed or permanent death ban.

!VoidDeath Features

✨ Features

Everything needed to make death meaningful without making server management difficult.

• Configurable lives for every player
• Timed or permanent death bans (30s, 10m, 2h, 1d, perm)
• Automatic life restoration after ban expiry or staff revival
• Persistent UUID and last-known-name storage
• Optional built-in PlaceholderAPI expansion
• Fully customizable messages, kick screen, and help menu
• Permission-aware commands and tab completion

!VoidDeath Workflow

⚙️ How It Works

VoidDeath turns every elimination into a clear, predictable process.

1. A player joins with the configured number of lives.
2. Every death removes one life.
3. Losing the final life applies the configured death ban.
4. The player returns when the ban expires or staff revives them.
5. Their lives are restored for the next attempt.

!VoidDeath Commands

🛠️ Commands

/vd is an alias for /voiddeath and works with every subcommand. /revive is the only standalone shortcut.

Command	Alias	Description	Permission
/voiddeath	/vd	Display the help menu	voiddeath.help
/voiddeath help	/vd help	Display the help menu	voiddeath.help
/voiddeath reload	/vd reload	Reload and validate config.yml	voiddeath.admin
/voiddeath revive <name-or-uuid>	/vd revive <name-or-uuid>, /revive <name-or-uuid>	Remove a death ban and restore lives	voiddeath.revive
/voiddeath check <name-or-uuid>	/vd check <name-or-uuid>	Check status, lives, and remaining ban time	voiddeath.check
/voiddeath setlives <name-or-uuid> <0-max>	/vd setlives ...	Change remaining lives; 0 applies a death ban	voiddeath.admin
/voiddeath deadlist	/vd deadlist	List active death bans	voiddeath.admin
/voiddeath cleardeadlist	/vd cleardeadlist	Remove every active death ban	voiddeath.admin

🔐 Permissions

Permission	Default	Description
voiddeath.help	OP	Use /voiddeath, /vd, and their help subcommand
voiddeath.admin	OP	Reload configuration, set lives, and manage the death-ban list
voiddeath.revive	OP	Revive death-banned players
voiddeath.check	OP	Check a player's lives and death-ban status
voiddeath.bypass	No	Prevent life loss when admin bypass is enabled

voiddeath.admin automatically grants voiddeath.revive, voiddeath.check, and voiddeath.bypass.

!VoidDeath Configuration

⚡ Configuration

Control the number of lives, ban duration, bypass behavior, update checks, and every player-facing message through config.yml.

The example below shows only a small part of config.yml. The complete configuration includes all messages, command responses, the help menu, kick-screen content, and additional customization options.

# Notify administrators about new releases
update-check: true

# Positive value using s, m, h or d — or exactly "perm"
ban-duration: "perm"

# Ignore players with voiddeath.bypass
admin-bypass: true

# Lives assigned to new and revived players (1-1000)
lives:
  default: 1

messages:
  prefix: "&4&lVoidDeath &r&8»&7"
  elimination-broadcast: "%prefix% &f%player% &7was consumed by the darkness."
  life-lost: "%prefix% You lost a life. Remaining: &f%lives%&7/&f%max_lives%&7."

Invalid durations or required message values stop the plugin safely instead of silently creating an unintended permanent ban.

!VoidDeath PlaceholderAPI

🧩 PlaceholderAPI

When PlaceholderAPI is installed, VoidDeath registers its built-in expansion automatically. No separate eCloud download is required.

Placeholder	Value
%voiddeath_lives%	Remaining lives
%voiddeath_max_lives%	Configured maximum lives
%voiddeath_is_dead%	true or false
%voiddeath_status%	alive or dead
%voiddeath_time_left%	Remaining time, permanent, or 0s

!VoidDeath Privacy

🔒 Privacy & Data

VoidDeath uses only a small number of transparent, optional online services.

Feature	Description
bStats	Sends anonymous server and plugin usage statistics. It can be disabled in plugins/bStats/config.yml.
Update Checker	Reads the public version.json file when update-check is enabled.
PlaceholderAPI	Optional local integration used only when PlaceholderAPI is installed.
Local Storage	Stores UUIDs, last-known names, lives, and ban expiration timestamps in plugins/VoidDeath/data.yml.

Player progress is written to the local data.yml file.

!VoidDeath Support

💬 Support

Questions, bug reports, or feature requests? Join the official Discord server and we'll be happy to help.

Discord: https://discord.gg/jdWeSJbcKx

!VoidDeath Footer

❤️ Thank You

Every life tells a story.

Thank you for making VoidDeath a part of yours.