Paper服务器添加或更新插件:核对版本、依赖和实际权限

Minecraft Java原版服务端不会因为出现一个plugins文件夹就能加载插件。本文适用于已经正常运行的Paper服务器,处理Paper兼容插件;Fabric、Forge等模组、基岩版扩展,以及需要特殊支持的Folia场景不按这套方法混装。

下载前核对四项信息

  1. 记录当前Minecraft版本、Paper构建号和实际Java版本。
  2. 在插件发布说明中确认支持这些版本,并核对下载的是Paper或Bukkit兼容插件JAR,不是客户端模组、源码压缩包或代理服务器专用插件。
  3. 列出插件必需的前置依赖及对应版本。不能看到“缺少依赖”就从陌生网盘随便找一个同名文件。
  4. 确认来源可信。插件运行后可能访问服务器文件和网络,只安装自己能核验的发布文件,不使用所谓破解整合插件包。

先在副本里安装一项

正常停服并备份完整游戏目录,至少保留世界、plugins目录、配置及与插件有关的数据。使用外部数据库时,另做相应备份。建议先在隔离测试副本中安装,测试副本必须与生产数据库和其他可写服务分开。

  1. 确认这次启动脚本实际使用的服务端工作目录。把插件JAR放到它的plugins目录直接下面,不多套一层压缩包或文件夹。
  2. 更新同一个插件时,先把旧JAR移到plugins之外的备份位置,再放入新版本,避免同时存在两个版本。原配置和数据是否需要迁移,按插件说明处理。
  3. 同一轮先只变更一个功能及它必需的依赖,记录文件名和版本,方便定位。
  4. 使用原启动方式重新启动Paper。不要把reload当作安装、升级插件的替代步骤。

检查加载结果,再测试真实功能

启动完成后,在服务端控制台输入:

plugins

游戏内由有权限的管理员执行时可用/plugins。插件出现在列表且为启用状态只是第一步,还要检查logs/latest.log中加载阶段的错误,并用普通玩家账号测试需要的命令和操作。

现象 先检查哪里
列表中完全没有 是否放到本次进程的plugins目录、文件是否是正确JAR、是否重启了正确实例。
列出但未启用 看启动日志中的依赖、版本或配置错误,不只截列表颜色。
管理员能用,普通玩家不能用 按插件实际权限节点配置需要的权限,不直接给所有玩家OP。
命令可用,功能数据不对 核对插件配置、数据库、世界范围和迁移步骤,不能认定安装已完成。

出问题时怎样退回

先正常停服,保留本次错误日志。仅新增且没有迁移数据的插件,可以先移出该JAR,在副本中验证原功能恢复。若新版本已转换配置、数据库或世界相关数据,必须按插件的回退要求恢复成套备份,不能只降级JAR。

插件提供世界物品、领地、经济或权限等功能时,移除可能改变玩家体验和数据访问。不要为了让服务端勉强启动就删除所有插件文件夹,也不要在正式世界里反复换一批插件试错。

验收应包括正常加载、普通玩家权限正确、实际功能可用,以及正常停服后重新启动数据仍在。相关文档:Minecraft Java基础开服 · SFTP上传文件 · 日志截图脱敏。