- 版权类型
- 原创
- 插件中文名称
- 防假死插件
- 插件英文名称
- PlsGoDieFix
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- 语言支持
- 中文（简体）
- 前置组件
- 无
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
插件简介
PlsGoDieFix 是一款面向 Paper 1.21.11 的轻量级 Bukkit/Paper 插件，用于处理玩家受到致死伤害后没有正常进入死亡/重生流程的问题。当玩家出现“血量已接近死亡，但服务端没有正确判定死亡”的异常状态时，插件会自动进行检测，并通过安全的强制补刀方式重新触发原版死亡流程。
插件也提供管理员手动修复命令，可对自己或指定在线玩家执行一次假死修复。
适用场景
- 玩家死亡后卡住，无法正常进入重生界面。
- 某些插件、技能、伤害机制导致玩家进入异常低血量状态。
- 管理员需要快速处理在线玩家的假死问题。
- 希望在不修改核心玩法的前提下，补充一个轻量修复机制。
插件特点
- 自动检测致死伤害后的异常状态。
- 支持玩家进服后的轻量假死检查。
- 支持管理员手动修复自己或指定玩家。
- 支持命令 Tab 补全。
- 支持 MiniMessage 消息格式。
- 配置简单，所有提示文本均可自定义。
- 依赖不打包进插件 Jar，Paper API 使用 provided 作用域。
命令说明
主命令：/plsgodie别名：
/pgd| 命令 | 说明 |
|---|---|
/plsgodie fix | 对自己执行一次假死修复。 |
/plsgodie fix <玩家> | 对指定在线玩家执行一次假死修复。 |
/plsgodie reload | 重载插件配置。 |
权限说明
| 权限 | 默认 | 说明 |
|---|---|---|
plsgodie.use | OP | 使用插件主命令。 |
plsgodie.reload | OP | 重载插件配置。 |
plsgodie.fix.others | OP | 修复其他在线玩家。 |
默认配置
代码：
# 是否启用自动假死修复
enabled: true
# 假死判定阈值：
# 玩家生命值小于等于该值且未死亡时，插件会尝试执行强制补刀
suspect-health-max: 0.5
# 同一玩家两次自动补刀的最小间隔，单位：毫秒
# 用于防止短时间内重复触发
force-kill-cooldown-ms: 2000
# 玩家加入服务器时是否执行一次轻量检查
fix-on-join: true
# 插件消息，支持 MiniMessage 格式
messages:
prefix: "<gray>[<gold>PlsGoDie</gold>]</gray> "
fixed-self: "<green>已执行假死修复，请查看是否进入正常重生流程。</green>"
fixed-other: "<green>已对玩家 <yellow>{player}</yellow> 执行假死修复。</green>"
no-fix-needed: "<gray>当前未检测到假死状态。</gray>"
no-permission: "<red>你没有权限执行这个操作。</red>"
player-not-found: "<red>未找到该玩家或玩家不在线。</red>"
reload-done: "<green>配置已重载。</green>"
usage: "<yellow>用法: /plsgodie <fix|reload> [玩家]</yellow>"工作原理
插件会监听玩家受到伤害的事件。当一次伤害理论上会导致玩家死亡时，插件会在下一 Tick 对玩家状态进行检查。如果玩家仍然在线、没有被 Bukkit 标记为死亡，并且当前生命值低于配置阈值，插件会将玩家生命值设置为
0，从而让服务端重新进入正常死亡流程。如果开启
fix-on-join，玩家进服 20 Tick 后也会进行一次轻量检查，用于处理重连后仍处于异常低血量状态的情况。安装方法
- 下载或构建插件 Jar。
- 将插件放入服务器
plugins/目录。 - 重启服务器。
- 修改配置后，执行：
/plsgodie reload注意事项
- 本插件不会替代死亡管理、复活管理或惩罚类插件，只负责补救异常假死状态。
- 如果担心自动修复过于敏感，可以调低 suspect-health-max。
- 如果不希望玩家进服时执行检测，可以关闭 fix-on-join。
- 建议确认服务器、插件配置和编辑器均使用 UTF-8 编码，避免中文配置显示异常。
推荐配置调整
更保守的假死判定：suspect-health-max: 0.1
关闭进服检测：
fix-on-join: false
延长自动修复冷却：
force-kill-cooldown-ms: 5000
