如何在您的 Paper、Spigot 或 Purpur Minecraft 服务器上安装插件

插件是您扩展 Paper、Spigot 或 Purpur 服务器的方式，可以添加新命令、小游戏、世界生成、反破坏工具、经济系统以及您能想到的几乎所有其他功能。所有这三种服务器的安装过程都相同：将 .jar 文件放入 plugins/ 文件夹，重启服务器，然后进行配置。本指南将详细介绍 ServerPrism 上的工作流程，并指出新服务器所有者常遇到的陷阱。

确保您的服务器可以运行插件

插件仅适用于实现 Bukkit API 的服务器软件。这包括 Paper、Spigot、Purpur 和 Folia — 但不包括原版 Minecraft、Forge、NeoForge 或 Fabric。这些模组加载器服务器使用模组（mods/ 文件夹中的 .jar 文件），这是一个不同的系统。

在 ServerPrism 上，打开您服务器仪表板中的 Startup 选项卡，并确认 Server Jar 行显示类似 paper-X.X.jar、spigot-X.X.jar 或 purpur-X.X.jar 的内容。如果您看到 vanilla、forge 或 fabric，则插件将无法加载 — 您需要先重新安装为 Paper（在切换 Egg 后，通过 Settings → Reinstall）。

还要检查您想要的插件是否支持您确切的 Minecraft 版本。为 1.20 构建的插件不一定总能在 1.21 上运行。

查找插件

以下是主要查找地点：

• Modrinth — 界面简洁，支持版本筛选，现代默认选择。
• Hangar — 官方 PaperMC 存储库。
• SpigotMC — 最大的目录，但质量参差不齐。请阅读评论。
• BukkitDev — 较旧，但仍托管着未在其他地方重新发布的插件。

在每个网站上，根据您的 Minecraft 版本进行筛选并下载 .jar 文件（如果附带配置文件，则下载 .zip — 请先解压，您需要的是 .jar 文件）。

上传并加载插件

1. 登录您的 ServerPrism 仪表板并打开您的服务器。
2. 点击侧边栏中的 File Manager。
3. 打开 plugins/ 文件夹。
4. 将 .jar 文件拖入文件夹，或点击 Upload。
5. 从 Console 选项卡重启服务器。插件只在启动时被发现。

您可以一次安装多个插件 — 只需在重启前放入多个 .jar 文件即可。

验证是否加载

服务器启动后，在游戏内聊天或仪表板的 Console 选项卡中运行 /plugins。插件名称应显示为绿色。如果显示为红色，则插件加载失败 — 打开 logs/latest.log 中的最新日志，查找第一行 ERROR。它通常会告诉您是版本错误、缺少依赖项还是服务器类型不兼容。

配置插件

大多数插件在首次启动时会在 plugins/<plugin-name>/ 内部生成一个 config.yml 文件。通过 File Manager 编辑它，并重启服务器以使更改生效。

一些插件支持 /reload <plugin-name> 以在不完全重启的情况下应用更改。仅当插件自己的文档明确推荐时才使用它 — reload 已知会在不期望它的插件上导致细微的错误（损坏的事件处理程序、泄漏的任务）。

常见问题

• 插件未显示在 /plugins 中： 服务器软件不兼容 Bukkit（您使用的是 Forge/Fabric/vanilla），或者 .jar 文件损坏或不完整 — 请重新下载。
• 控制台中出现 UnsupportedClassVersionError： 插件是为比您服务器运行的 Java 版本更新的版本编译的。检查插件所需的 Java 版本，并在 Startup 选项卡中切换您服务器的 Docker 镜像（java_17、java_21）。
• NoClassDefFoundError： 缺少依赖插件。大多数插件在其下载页面上列出了它们的依赖项 — 也请安装这些依赖项。
• 版本不匹配警告： 1.20 插件在 1.21 上可能“能用”，但会随机崩溃。请使用为您的 Minecraft 版本构建的版本。
• 安装后服务器卡顿： 某些插件很重。一次禁用一个（将 .jar 文件移出 plugins/，重启）以找出罪魁祸首。

热门入门插件

• LuckPerms — 权限和等级，几乎所有服务器都在使用。
• EssentialsX — 家园、传送点、工具包、经济基础。经典的工具箱。
• CoreProtect — 方块日志和回滚，是应对破坏行为的救星。
• WorldEdit + WorldGuard — 区域保护和批量世界编辑。
• ViaVersion — 允许使用旧版 Minecraft 客户端的玩家加入您的新版服务器。

后续步骤

一旦您熟悉了插件安装，就可以使用 LuckPerms 设置权限系统，并养成在添加任何新内容之前备份 plugins/ 目录的习惯 — 配置错误的插件可能会在关闭时清除配置文件。在仪表板的 Backups 选项卡中，一键即可完成备份。