
☠️ VoidDeath
为极限生存 Minecraft 服务器设计的生命与死亡禁令系统。
VoidDeath 为每位玩家分配可配置的生命次数。每次死亡会消耗一次生命,失去最后一次生命后将施加限时或永久的死亡禁令。

✨ 功能特性
所有让死亡变得有意义且不影响服务器管理的必要功能。
- 为每位玩家配置生命值
- 限时或永久死亡禁令(
30s、10m、2h、1d、perm)
- 禁令过期或管理员复活后自动恢复生命值
- 持久化存储 UUID 和最后已知用户名
- 可选内置 PlaceholderAPI 扩展支持
- 完全自定义的消息、踢出屏幕和帮助菜单
- 基于权限的命令与 Tab 补全

⚙️ 工作原理
VoidDeath 将每一次淘汰转化为清晰、可预测的流程。
- 玩家以配置好的生命值数量加入服务器。
- 每次死亡扣除一条生命。
- 失去最后一条生命时应用配置的死亡禁令。
- 当禁令过期或被管理员复活时,玩家返回游戏。
- 他们的生命值将在下一次尝试中恢复。

?️ 命令
/vd 是 /voiddeath 的别名,适用于所有子命令。/revive 是唯一独立的快捷命令。
| 命令 |
别名 |
描述 |
权限 |
/voiddeath |
/vd |
显示帮助菜单 |
voiddeath.help |
/voiddeath help |
/vd help |
显示帮助菜单 |
voiddeath.help |
/voiddeath reload |
/vd reload |
重新加载并验证 config.yml |
voiddeath.admin |
/voiddeath revive <name-or-uuid> |
/vd revive <name-or-uuid>, /revive <name-or-uuid> |
解除死亡禁令并恢复生命值 |
voiddeath.revive |
/voiddeath check <name-or-uuid> |
/vd check <name-or-uuid> |
查看状态、生命值及剩余禁令时间 |
voiddeath.check |
/voiddeath setlives <name-or-uuid> <0-max> |
/vd setlives ... |
更改剩余生命值;设为 0 则施加死亡禁令 |
voiddeath.admin |
/voiddeath deadlist |
/vd deadlist |
列出当前生效的死亡禁令 |
voiddeath.admin |
/voiddeath cleardeadlist |
/vd cleardeadlist |
移除所有生效的死亡禁令 |
voiddeath.admin |
? 权限
| 权限 |
默认值 |
描述 |
voiddeath.help |
OP |
使用 /voiddeath、/vd 及其 help 子命令 |
voiddeath.admin |
OP |
重载配置、设置生命值及管理死亡禁令列表 |
voiddeath.revive |
OP |
复活被禁止的玩家 |
voiddeath.check |
OP |
查看玩家的寿命和死亡禁令状态 |
voiddeath.bypass |
No |
启用管理员豁免时防止生命值减少 |
voiddeath.admin 会自动授予 voiddeath.revive、voiddeath.check 和 voiddeath.bypass。

⚡ 配置
通过 config.yml 控制生命值数量、禁令时长、豁免行为、更新检查以及所有面向玩家的消息。
以下示例仅展示 config.yml 的一小部分。完整配置包含所有消息、命令响应、帮助菜单、踢出屏幕内容以及其他自定义选项。
# 通知管理员新版本发布
update-check: true
# 正数值,使用 s, m, h 或 d — 或者精确设置为 "perm"
ban-duration: "perm"
# 忽略拥有 voiddeath.bypass 权限的玩家
admin-bypass: true
# 新加入和被复活玩家的生命值 (1-1000)
lives:
default: 1
messages:
prefix: "&4&lVoidDeath &r&8»&7"
elimination-broadcast: "%prefix% &f%player% &7被黑暗吞噬。"
life-lost: "%prefix% 你失去了一条生命。剩余: &f%lives%&7/&f%max_lives%&7."
无效的时长或必需的消息值会使插件安全停止运行,而不是静默地创建意外的永久禁令。

? PlaceholderAPI
当安装了 PlaceholderAPI 时,VoidDeath 会自动注册其内置扩展。无需单独从 eCloud 下载。
| 占位符 |
值 |
%voiddeath_lives% |
剩余生命值 |
%voiddeath_max_lives% |
配置的最大生命值 |
%voiddeath_is_dead% |
true 或 false |
%voiddeath_status% |
alive 或 dead |
%voiddeath_time_left% |
剩余时间、permanent 或 0s |

? 隐私与数据
VoidDeath 仅使用少量透明的可选在线服务。
| 功能 |
描述 |
| bStats |
发送匿名的服务器和插件使用统计数据。可在 plugins/bStats/config.yml 中禁用。 |
| Update Checker |
当 update-check 启用时读取公共 version.json 文件。 |
| PlaceholderAPI |
本地集成,仅在安装 PlaceholderAPI 时使用。 |
| Local Storage |
在 plugins/VoidDeath/data.yml 中存储 UUID、最后已知名称、生命值和禁令过期时间戳。 |
玩家进度写入本地 data.yml 文件。

? 支持
有问题、Bug 报告或功能请求?加入官方 Discord 服务器,我们将很乐意为您提供帮助。
Discord:

❤️ 感谢有你
每一条生命都在诉说故事。
感谢你让 VoidDeath 成为你旅程的一部分。

☠️ 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.

✨ 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

⚙️ How It Works
VoidDeath turns every elimination into a clear, predictable process.
- A player joins with the configured number of lives.
- Every death removes one life.
- Losing the final life applies the configured death ban.
- The player returns when the ban expires or staff revives them.
- Their lives are restored for the next attempt.

?️ 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.

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

? 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 |

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

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

❤️ Thank You
Every life tells a story.
Thank you for making VoidDeath a part of yours.
评论 0
登录后参与评分
还没有评论,来抢沙发吧