Paper服务器添加或更新插件:核对版本、依赖和实际权限
Minecraft Java原版服务端不会因为出现一个plugins文件夹就能加载插件。本文适用于已经正常运行的Paper服务器,处理Paper兼容插件;Fabric、Forge等模组、基岩版扩展,以及需要特殊支持的Folia场景不按这套方法混装。
下载前核对四项信息
- 记录当前Minecraft版本、Paper构建号和实际Java版本。
- 在插件发布说明中确认支持这些版本,并核对下载的是Paper或Bukkit兼容插件JAR,不是客户端模组、源码压缩包或代理服务器专用插件。
- 列出插件必需的前置依赖及对应版本。不能看到“缺少依赖”就从陌生网盘随便找一个同名文件。
- 确认来源可信。插件运行后可能访问服务器文件和网络,只安装自己能核验的发布文件,不使用所谓破解整合插件包。
先在副本里安装一项
正常停服并备份完整游戏目录,至少保留世界、plugins目录、配置及与插件有关的数据。使用外部数据库时,另做相应备份。建议先在隔离测试副本中安装,测试副本必须与生产数据库和其他可写服务分开。
- 确认这次启动脚本实际使用的服务端工作目录。把插件JAR放到它的
plugins目录直接下面,不多套一层压缩包或文件夹。 - 更新同一个插件时,先把旧JAR移到plugins之外的备份位置,再放入新版本,避免同时存在两个版本。原配置和数据是否需要迁移,按插件说明处理。
- 同一轮先只变更一个功能及它必需的依赖,记录文件名和版本,方便定位。
- 使用原启动方式重新启动Paper。不要把
reload当作安装、升级插件的替代步骤。
检查加载结果,再测试真实功能
启动完成后,在服务端控制台输入:
plugins
游戏内由有权限的管理员执行时可用/plugins。插件出现在列表且为启用状态只是第一步,还要检查logs/latest.log中加载阶段的错误,并用普通玩家账号测试需要的命令和操作。
| 现象 | 先检查哪里 |
|---|---|
| 列表中完全没有 | 是否放到本次进程的plugins目录、文件是否是正确JAR、是否重启了正确实例。 |
| 列出但未启用 | 看启动日志中的依赖、版本或配置错误,不只截列表颜色。 |
| 管理员能用,普通玩家不能用 | 按插件实际权限节点配置需要的权限,不直接给所有玩家OP。 |
| 命令可用,功能数据不对 | 核对插件配置、数据库、世界范围和迁移步骤,不能认定安装已完成。 |
出问题时怎样退回
先正常停服,保留本次错误日志。仅新增且没有迁移数据的插件,可以先移出该JAR,在副本中验证原功能恢复。若新版本已转换配置、数据库或世界相关数据,必须按插件的回退要求恢复成套备份,不能只降级JAR。
插件提供世界物品、领地、经济或权限等功能时,移除可能改变玩家体验和数据访问。不要为了让服务端勉强启动就删除所有插件文件夹,也不要在正式世界里反复换一批插件试错。
验收应包括正常加载、普通玩家权限正确、实际功能可用,以及正常停服后重新启动数据仍在。相关文档:Minecraft Java基础开服 · SFTP上传文件 · 日志截图脱敏。