插件出问题时先冻结现场
出现启动失败、命令消失或进入世界后报错,先不要连续更新所有插件。记录发生时间、最近改动、核心版本和报错内容,并备份当前plugins目录与配置。这样即使需要回退,也能恢复到问题发生前的状态。
用命令确认加载状态
Paper启动后在控制台输入:
plugins游戏内由有权限的管理员输入:
/plugins核对插件是否缺失、是否有红色状态,再查看logs/latest.log中对应名称附近的错误。启动日志里的第一条异常通常比最末尾的停止信息更有排查价值。
检查依赖与文件放置
Paper插件JAR应直接位于plugins目录。检查插件页面是否声明依赖,例如权限、经济或协议支持插件;依赖缺失时不要复制不明来源的文件。确认同一个插件没有同时放置旧版和新版,也确认下载得到的确实是JAR而不是HTML错误页。
一次只移除一个变量
- 正常关闭服务器并备份世界和配置。
- 把最近新增的插件移出plugins目录。
- 重启服务器,观察原问题是否消失。
- 逐个恢复插件,每次重启并记录结果。
- 找到冲突项后检查兼容版本或替代方案。
不要用插件热重载作为主要排错手段;插件可能持有任务或数据状态,完整重启更容易得到干净结果。若错误涉及世界数据,先停止写入再恢复备份。
服主求助时提供完整启动日志、核心版本、Java版本和插件清单,并删除日志中的服务器地址、凭据或其他隐私信息。信息越完整,越容易判断是依赖缺失、版本不兼容还是两个插件同时改写同一功能。