本页内容
插件与模组:区别是什么?
开始之前:使用 Paper 或 Spigot
如何逐步安装插件
值得首先安装的必备插件
更新和移除插件
插件无法加载?如何修复
常见问题
插件是把一个普通生存世界变成真正服务器的最快方式——等级、领地保护、传送点、防破坏和小游戏。Paper 和 Spigot 最棒的地方在于一切都在服务器端运行:你只需安装一次插件,玩家使用未经修改的 Minecraft 客户端加入,无需下载任何内容。
本指南将从头到尾覆盖整个流程:去哪里安全地获取插件,如何在几分钟内在 Minecraft 服务器上安装插件,大多数服务器都会用到的必备插件,以及当某个插件拒绝加载时如何更新、移除和排查问题。
插件与模组:区别是什么?
在下载任何东西之前,先确认你真正需要的是不是插件。人们经常把插件和模组这两个词混用,但在服务器上它们其实是两种完全不同的东西。
插件模组
运行于Paper、Spigot、Purpur(Bukkit API)Forge、Fabric、NeoForge
玩家需要安装吗?不需要——仅服务器端需要——每个玩家都要装相同的模组
改变游戏本身?很少——增加功能和规则是——新方块、生物、维度
典型用途等级、领地、小游戏、防破坏科技、魔法与探索类整合包
插件挂接在 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 服务器开始。
记下你的 Minecraft 版本。版本切换器会准确显示你的服务器运行的是哪个 Minecraft 版本。把它记下来——下一步你将下载为同一版本构建的插件,提前确认这一点可以避免大多数「无法加载」的麻烦。
如何逐步安装插件
在 Paper 或 Spigot 运行的情况下,安装插件只需几个简单步骤,整个过程只需几分钟。
从可信来源下载插件 JAR 文件。值得信赖的插件来源包括 SpigotMC、Modrinth 和 Hangar(PaperMC)。下载 .jar 文件,并确认页面标明支持你的 Minecraft 版本——为 1.20 构建的插件通常无法在 1.21 上加载。
上传到 plugins 文件夹。打开面板的 Files 标签,进入 plugins 目录,上传该 JAR 文件——支持拖放操作。要一次安装多个?用面板中提供的凭据通过 SFTP 连接,直接把文件复制到 plugins 中。自建服务器?plugins 文件夹就在你的 server.jar 旁边。
重启服务器。插件只在启动时加载,所以在面板中点击 Restart——普通的重新加载不会识别全新的插件。观察控制台启动过程:每个插件启用时都会自我宣告。
确认已加载。在控制台命令框中输入 /plugins(或简写 /pl)。你的新插件应出现在列表中,以绿色显示。绿色表示已加载并运行;红色表示失败——如果看到红色,请跳转到故障排除部分。
进行配置。首次成功启动会创建 plugins/
GameCP 控制台:重启服务器,在日志中观察每个插件启用,然后在命令框中输入 /plugins 确认已加载。旁边的 Files 标签就是把 JAR 文件放入 plugins 文件夹的地方。
只从可信来源安装插件。插件是在你的服务器上运行的可执行代码,拥有对你的世界和控制台的完全访问权限。「破解版」、去授权或重新上传的付费插件是夹带恶意软件、后门和挖矿程序的常见手法。请坚持使用 SpigotMC、Modrinth 和 Hangar——并且绝不要安装其标注的 Minecraft 版本与你的服务器不匹配的 JAR 文件,因为版本不匹配是插件无法加载或损坏存档最常见的原因。
省去摸索的过程——HytHost 的 Paper 服务器提供文件管理器、SFTP 和一键备份,几分钟内即可安装插件。
查看 Minecraft 套餐
值得首先安装的必备插件
你可以花一整个周末浏览插件,但几乎每一个运营良好的生存或 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/
每次改动前先备份。在添加、更新或移除插件之前,在面板中一键备份。如果新版本出问题,你可以在几秒内恢复,而不必在损坏的存档里翻找。先存快照,再做实验。
插件无法加载?如何修复
当插件在 /plugins 中显示为红色或完全没有反应时,原因几乎总是以下几种之一。按顺序逐一排查:
版本不匹配。头号原因。对照插件页面和你服务器的 Minecraft 版本——为 1.20 构建的 JAR 文件常常无法在 1.21 上启用,反之亦然。下载匹配的版本,或者更改你服务器的版本以匹配插件。
缺少依赖项。许多插件需要同时安装一个辅助插件——经济插件需要 Vault,商店插件需要经济插件,或某个特定库。控制台会替你指明:查找类似 Unknown/missing dependency plugins: [Vault] 的一行。安装它要求的内容,然后重启。
服务器类型不对。如果什么都加载不了,请确认你确实运行的是 Paper 或 Spigot 而不是原版——插件需要 Bukkit API。版本切换器会显示你正在运行的内容。
配置损坏。config.yml 中一行缩进错误就足以让插件彻底停止工作。控制台的错误信息通常会指出具体的行号和列号。修正 YAML(用空格,绝不用制表符),或者删除配置文件,让插件在下次重启时重新生成一份干净的配置。
控制台在这里是你最好的朋友。无论出了什么问题,服务器都会在启动时打印原因——一行红色的 ERROR 或 WARN,指明插件和问题所在。从上到下阅读;第一个错误通常才是真正的原因。
还是卡住了?把控制台里的确切错误行复制出来搜索一下——几乎可以肯定已经有人在你之前遇到过同样的信息。使用 HytHost 套餐时,你还可以在 8:00 至 23:00(基希讷乌时间)联系在线客服,而且每台服务器都部署在配备 Voxility DDoS 防护的 NVMe SSD 硬件之后,所以「变慢」很少是插件的错。如果无法确定,恢复改动前的备份,然后逐个重新添加插件,直到找出问题所在。