如何安装 Minecraft 插件

分步说明

1. 1.确认你的服务器能运行插件

   插件需要基于 Bukkit 的服务端软件：游戏服务器用 Paper、Spigot、Purpur 或 Folia，代理端用 BungeeCord 或 Velocity。原版服务器，以及 Fabric 或 Forge 服务器，都不会加载插件。

2. 2.检查插件的版本

   插件页面或文件会写明它支持哪些 Minecraft 版本。为比你服务器更新的版本构建的插件，通常会拒绝加载。

3. 3.停止服务器并复制 .jar

   把 .jar 文件放进服务器 .jar 旁边的 plugins/ 文件夹。如果用的是托管面板，就用文件管理器或 SFTP 上传。不要解压它。

4. 4.安装它的依赖

   如果插件需要其他插件（Vault、PlaceholderAPI、ProtocolLib、LuckPerms），也把它们的 .jar 文件放进 plugins/。

5. 5.启动服务器并查看控制台

   在启动日志中找插件的名字。出现“Enabling <Plugin>”且后面没有报错，就说明加载成功了。

6. 6.在游戏中检查并配置

   运行 /plugins：已加载的插件显示为绿色，启用失败的插件显示为红色。它的设置在 plugins/<PluginName>/config.yml 中；修改后重启。

文件放在哪里

装了一个插件并首次启动后，典型的服务器文件夹是这样的：

• paper.jar（或 spigot.jar）：服务器本身。
• plugins/MyPlugin.jar：你添加的插件。
• plugins/MyPlugin/：插件创建的文件夹，里面有 config.yml、消息和它保存的数据。
• logs/latest.log：本次运行的日志，加载错误会写在这里。

重启，不要 /reload

/reload 会在不重启服务器的情况下卸载并重新加载所有插件。很多插件不支持它：监听器会注册两次、数据丢失或内存泄漏。添加、移除或更新插件后，务必重启服务器。有些插件有自己的重载命令（例如 /myplugin reload），只重载自己的配置：这种可以放心使用。

在正式服务器上安装之前

• 备份服务器文件夹，至少备份 plugins/ 和世界。
• 先在副本上试：和正式服务器相同的软件、版本和其他插件。参见如何测试插件。
• 一次只装一个插件：出了问题，你就知道是哪一个导致的。
• 从作者的页面下载（SpigotMC、Hangar、Modrinth、GitHub），不要用别人重新上传的版本。

用 Codexe 制作的插件

在 Codexe 上制作的插件会以一个以项目命名的、已构建好的 .jar 交付，你拿到之前已经过检查：它必须包含编译后的类和 plugin.yml。在安装到任何地方之前，你都可以在私人测试服务器上试用，所有套餐都免费；测试服务器会为你安装列为依赖的插件。为你自己的服务器下载 .jar 需要套餐或下载包。

常见问题