如何在 Minecraft 服务器上安装插件（Paper 与 Spigot）

插件与模组：区别是什么？

在下载任何东西之前，先确认你真正需要的是不是插件。人们经常把插件和模组这两个词混用，但在服务器上它们其实是两种完全不同的东西。

插件挂接在 Paper 和 Spigot 暴露出来的 Bukkit API 上。它们完全运行在服务器上，因此玩家使用原版 Minecraft 客户端连接，从不需要下载任何文件——这正是插件服务器如此容易搭建和发展的原因。

模组则完全是另一回事：它们会改变游戏客户端本身，所以服务器和每一位玩家都必须使用相同的加载器和相同的模组列表，通常打包成一个整合包发布。如果这才是你想要的，本篇不适合你——请查看如何搭建 Modded Minecraft 服务器。想了解各加载器的完整对比及适用场景，请参阅最佳 Minecraft 服务器软件。

开始之前：使用 Paper 或 Spigot

插件只能在支持 Bukkit API 的服务器上加载。Mojang 提供的原版 server.jar 并不支持——把插件放在它旁边什么都不会发生。你需要以下其中一种：

• Paper——标准之选。该系列中速度最快，持续维护，并且兼容庞大的 Bukkit/Spigot 插件生态。从这里开始。
• Spigot——大多数插件仍以此为基准进行开发和测试的较老版本。Paper 是它的直接超集，因此标注「适用于 Spigot」的插件也能在 Paper 上运行。
• Purpur——Paper 的一个分支，带有额外的玩法开关。插件相同，选项更多。

如果你还在用原版，切换很快。在 HytHost Minecraft 套餐上，GameCP 面板内置了版本切换器：选择 Paper（或 Spigot/Purpur）和 Minecraft 版本，点一下，正确的版本就会自动安装——你的存档不会受影响。自建服务器？下载 Paper 的 jar 文件，用它替代原版启动即可。想了解如何在 vanilla、Paper、Forge 和 Fabric 之间做选择，请阅读最佳 Minecraft 服务器软件；如果你还没有搭建过服务器，请从如何搭建 Minecraft 服务器开始。

如何逐步安装插件

在 Paper 或 Spigot 运行的情况下，安装插件只需几个简单步骤，整个过程只需几分钟。

1. 从可信来源下载插件 JAR 文件。值得信赖的插件来源包括 SpigotMC、Modrinth 和 Hangar（PaperMC）。下载 .jar 文件，并确认页面标明支持你的 Minecraft 版本——为 1.20 构建的插件通常无法在 1.21 上加载。
2. 上传到 plugins 文件夹。打开面板的 Files 标签，进入 plugins 目录，上传该 JAR 文件——支持拖放操作。要一次安装多个？用面板中提供的凭据通过 SFTP 连接，直接把文件复制到 plugins 中。自建服务器？plugins 文件夹就在你的 server.jar 旁边。
3. 重启服务器。插件只在启动时加载，所以在面板中点击 Restart——普通的重新加载不会识别全新的插件。观察控制台启动过程：每个插件启用时都会自我宣告。
4. 确认已加载。在控制台命令框中输入 /plugins（或简写 /pl）。你的新插件应出现在列表中，以绿色显示。绿色表示已加载并运行；红色表示失败——如果看到红色，请跳转到故障排除部分。
5. 进行配置。首次成功启动会创建 plugins/<PluginName>/config.yml。在文件管理器中编辑该文件来调整插件，然后运行其重载命令或重启服务器。YAML 对缩进很敏感——用空格缩进，绝不要用制表符，否则文件将无法解析。

值得首先安装的必备插件

你可以花一整个周末浏览插件，但几乎每一个运营良好的生存或 SMP 服务器都建立在同一份简短清单之上。先安装这些：

• EssentialsX——万能瑞士军刀：/home、/spawn、/tpa、礼包、传送点、一套基础经济系统以及数十个日常命令。如果你只装一个插件，就装它。
• LuckPerms——权限管理器。它决定谁能执行哪些命令，并为你提供等级和用户组。大多数其他插件都依赖它，所以一旦你有一个以上的管理员，它实际上就是必需品。
• WorldEdit + WorldGuard——WorldEdit 让你能快速构建和编辑地形；WorldGuard 保护区域（出生点、商店、竞技场）免受破坏，并控制 PvP 区域。两者通常成对使用。
• Vault——一个安静的桥接插件，让经济、权限和聊天插件能够相互通信。多个插件将其列为依赖项；装上它然后就不用再管了。
• CoreProtect——方块记录与回滚。当有破坏者攻击你的出生点时，CoreProtect 能准确显示是谁干的，并在几秒内回滚。在你需要它之前就先装上。

关于权限的说明：开箱即用时，大多数命令类插件只响应服务器管理员。要让普通等级的玩家使用类似 /home 的命令，你需要在 LuckPerms 中把对应的权限节点（这里是 essentials.home）授予该组。几乎每个人都会遇到一次这种情况——当一个命令对普通玩家「毫无反应」时，几乎总是缺少权限，而不是插件坏了。

你添加的每一个插件都会占用一些内存，所以繁忙的插件服务器比纯原版需要更多余量——运行上述必备插件的 Paper 服务器请规划4-6 GB内存。如果不确定该分配多少，我们关于Minecraft 服务器需要多少内存的指南按玩家数和配置做了详细拆解。

更新和移除插件

插件不过是同一个文件夹里的文件，这让日常维护变得简单。

更新插件

下载新版本，从 plugins 文件夹中删除旧的 JAR 文件（不要动插件的配置文件夹，以保留你的设置），上传新的 JAR 文件，然后重启。保持插件更新很重要：Minecraft 版本升级后服务器立即出问题，通常都是过时插件在作怪，所以每次更换 Minecraft 版本时都应更新插件。

移除插件

重启或停止服务器，从 plugins 中删除该插件的 JAR 文件，下次启动时它就消失了。它在 plugins/<PluginName> 下的配置文件夹会保留下来，除非你也删除它——留着无妨，但如果你彻底不再使用该插件，清理干净会更整洁。

插件无法加载？如何修复

当插件在 /plugins 中显示为红色或完全没有反应时，原因几乎总是以下几种之一。按顺序逐一排查：

1. 版本不匹配。头号原因。对照插件页面和你服务器的 Minecraft 版本——为 1.20 构建的 JAR 文件常常无法在 1.21 上启用，反之亦然。下载匹配的版本，或者更改你服务器的版本以匹配插件。
2. 缺少依赖项。许多插件需要同时安装一个辅助插件——经济插件需要 Vault，商店插件需要经济插件，或某个特定库。控制台会替你指明：查找类似 Unknown/missing dependency plugins: [Vault] 的一行。安装它要求的内容，然后重启。
3. 服务器类型不对。如果什么都加载不了，请确认你确实运行的是 Paper 或 Spigot 而不是原版——插件需要 Bukkit API。版本切换器会显示你正在运行的内容。
4. 配置损坏。config.yml 中一行缩进错误就足以让插件彻底停止工作。控制台的错误信息通常会指出具体的行号和列号。修正 YAML（用空格，绝不用制表符），或者删除配置文件，让插件在下次重启时重新生成一份干净的配置。

控制台在这里是你最好的朋友。无论出了什么问题，服务器都会在启动时打印原因——一行红色的 ERROR 或 WARN，指明插件和问题所在。从上到下阅读；第一个错误通常才是真正的原因。