在 Minecraft Java 上安装插件
通过控制面板里的 Plugins 页面，或者自己上传 .jar 文件，把插件添加到你在 GuavaHost 上的 Minecraft Java 服务器。
阅读约 3 分钟 · 更新于 2026年10月21日 · 作者：GuavaHost Team
插件让你在不碰游戏自身代码的前提下，给服务器加上额外功能，从领地圈地到经济系统都有。在 GuavaHost 上安装它们有两种方式：通过控制面板里的 Plugins（插件）页面，或者自己上传文件。本文两种都讲。
先说一个硬性前提。插件只会在支持插件的服务端类型上加载，比如 Paper、Spigot 或 Purpur。原版 Minecraft 对你丢进去的任何东西都只是忽略：没有报错，没有提示，什么都没有。你可以在服务器菜单里 Minecraft tools 下面的 Version 页面查看和更改服务端类型（参见 怎么更改 Minecraft Java 服务器版本），所以如果你不确定自己跑的是什么，先去那里看看。
方法 1：Plugins 页面
在 Paper、Spigot、Bukkit、Purpur 或 Folia 服务器上，你的服务器菜单在 Minecraft tools 下面会有一个 Plugins 页面。它会替你搜索 Modrinth，并把插件直接下载到你的服务器上。
- 打开你的服务器，点击 Minecraft tools 下面的 Plugins。
- 打开 Find plugins 标签，按名称搜索，比如
EssentialsX或LuckPerms。结果会按你的 Minecraft 版本和服务端类型过滤。 - 在你想要的插件旁边点击 Install。会弹出一个窗口显示它将要下载的文件，并在 Also needed 下面列出这个插件还需要的其他东西，除非你取消勾选，它们会一起被安装。
- 在那个窗口里点击 Install。文件会直接下载到你的服务器上。
- 当页面提醒你的时候重启服务器（Restart now），这样新插件才会加载。
Installed 标签列出你 plugins 文件夹里的每一个插件文件，每一项都有一个 Remove 按钮。移除插件会删掉它的文件；它的设置文件夹会留下，所以之后重新装回来，你的配置还在。
如果你在服务器菜单里看不到 Plugins，那你的服务器跑的是 Vanilla 或者某个模组加载器。在 Version 页面切换它，或者用下面的手动方法。
方法 2：手动上传 .jar
每个插件都是单独一个 .jar 文件。你把它下载下来，放进 plugins 文件夹，然后重启。整件事就是这么个思路，而且它对那些不在 Modrinth 上的插件也管用。
- 从可信来源下载插件的
.jar。确认版本和你的 Minecraft 版本对得上，否则它可能加载失败。 - 打开 Files 标签，进入
plugins文件夹。 - 点击 Upload files 选中那个
.jar，或者直接把它拖到文件列表里。如果你更习惯，也可以用 Settings 标签上 Connection details 下面的信息通过 SFTP 丢进去（参见 用 SFTP 上传文件）。 - 上传完成后，用页面顶部的 Restart 按钮重启服务器。
- 启动过程中盯着 Console 看。你应该会看到一行确认插件已加载的内容。
很多插件在第一次启动时会在 plugins 里创建自己的文件夹，里面有一个配置文件，你之后可以在 Files 标签里编辑。
有些服务器还会跑一个游戏内的插件管理器，它本身就是一个能安装其他插件的插件。如果你的服务器有，查一下它的文档了解搜索和安装命令，在 Console 里执行，然后按它的提示重启。
故障排查
插件什么反应都没有，控制台也从没提到它。 这几乎总是意味着你的服务端类型是 Vanilla。在 Version 页面切换到 Paper、Spigot 或 Purpur，然后重启。
启动时控制台显示和该插件相关的报错。 通常是版本不匹配。确认这个插件支持你那个确切的 Minecraft 版本，并拿到对应的构建。
它说缺少某个依赖。 有些插件需要另一个插件先跑起来，常常是经济或权限类插件。报错里会点出它要什么。把那个也装上，然后重启。
上传了却没出现。 确认文件就在 plugins 里面、不在某个子文件夹里，而且它是 .jar 不是 .zip。然后重启，不要只是 reload。
还没搞定吗？来 discord.gg/GuavaHost 加入我们的 Discord，团队会帮你解决。
- plugins
- minecraft
- java
- paper
- spigot
Host a Minecraft Java server From $3.99/mo, with instant setup and DDoS protection.
还是没解决？ 我们的团队 7x24 小时在线，随时解答你的问题。