安装插件与模组

用实例的「资源」标签从 Modrinth 一键安装插件、模组和数据包,或通过文件管理、SFTP 手动上传,以及版本冲突的处理方法。

Minecraft · 更新于

先确认核心能装什么

核心 可安装 安装目录
Paper、Purpur、Spigot 插件、数据包 /plugins
Folia 仅声明支持 Folia 的插件、数据包 /plugins
Forge、Fabric 模组、数据包 /mods
Mohist、Arclight、CatServer 模组、插件、数据包 /mods、/plugins
Waterfall、Velocity 代理插件 /plugins
NukkitX Nukkit 插件(需手动上传) /plugins
Bedrock 不支持插件和模组 -

数据包安装在世界目录下的 datapacks 文件夹,默认为 /world/datapacks;如果改过 server.properties 里的 level-name,则对应新的世界目录。

客户端和服务端的模组要分清:只在客户端生效的模组(小地图、光影、界面美化等)不要装到服务器上,否则可能导致启动失败。

方式一:用「资源」标签安装(推荐)

Minecraft Java 版实例的详情页有一个「资源」标签,里面的「资源中心」可以从 Modrinth 搜索并安装仅服务端可用的资源,下载后自动上传到实例对应目录。

确认识别信息

打开「资源」标签后,顶部会显示三项信息:

  • 服务端核心:自动识别当前实例的核心。
  • MC 版本:从环境变量、核心版本变量或服务端日志中自动识别。识别不到时会提示"未识别到 MC 版本",请在下拉框中手动选择,选择会保存在当前浏览器。代理端显示"不限"。
  • 安装目录:资源将被上传到的目录。

如果提示"暂不支持该服务端核心",说明当前核心不能使用资源中心,请改用下文的手动上传。

搜索和安装

  1. 在资源类型中选择「模组」「插件」或「数据包」(只显示当前核心支持的类型)。
  2. 在搜索框输入名称或关键词,可以按「相关度」「下载量」「关注数」「最新发布」「最近更新」排序。结果较多时点「加载更多」。
  3. 点击一个资源,打开详情。「兼容版本」列表只显示适合当前核心和 MC 版本的版本,标有「已安装」「可更新」「含必需前置」等标记。
  4. 在要安装的版本右侧点击「安装」。
  5. 在安装窗口中确认要安装的文件:「主资源」是你选择的资源,「必需前置」是它依赖的其他资源,默认一并勾选。
  6. 点击「开始安装」,等待每个文件依次显示「下载中」「校验中」「上传中」「已安装」。需要中途中止可以点「停止」。
  7. 完成后点「完成」,然后重启服务器使资源生效。

安装说明:

  • 文件经资源网关下载到浏览器,校验 SHA-512 后上传到实例。
  • 目标目录已有同名文件时会跳过,不会覆盖。
  • 作者标注为仅客户端的资源会提示"该资源不支持服务端",不提供安装。
  • 实例到期后文件为只读,需要续费后才能安装资源;实例安装中也不能添加资源。

疑似旧版本提示

如果安装窗口提示"目录中可能已有其他版本",说明目录里有名称相近的文件。同一模组或插件的两个版本并存会导致启动失败或只加载其中一个,请安装后到「文件管理」中删除旧文件。

平台按文件名判断是否已安装,改过名的文件无法识别。

方式二:手动上传

适用于 Modrinth 上没有的资源、NukkitX 插件、付费插件,或者整批迁移已有的模组。

通过文件管理

  1. 先在本地确认文件与核心和 MC 版本匹配。插件一般是 .jar,模组是 .jar,数据包是 .zip 或文件夹。
  2. 打开「文件管理」,进入 plugins 或 mods 目录(第一次使用前如果目录不存在,可以先开机一次让服务端生成,或用「新建目录」创建)。
  3. 点击「上传」按钮,或直接把文件拖进文件列表。文件很多时,可以在本地压缩成 zip 上传,再右键选择「解压」。
  4. 重启服务器。

网页上传单个文件有大小限制,大文件或大量文件建议使用 SFTP。

通过 SFTP

点击实例页面顶部的「SFTP」按钮获取连接信息,用 FileZilla、WinSCP 等客户端连接后,把文件拖到 plugins 或 mods 目录即可。详细步骤见 SFTP 连接。

安装后检查

  1. 重启后切到「控制台」,观察启动日志中是否有报错。
  2. 插件服可以在控制台执行 plugins(或 pl)查看已加载的插件列表,没有出现在列表里的插件说明加载失败,可在启动日志中搜索它的名字查看原因。
  3. 模组服如果启动失败,日志中通常会写明缺少哪个前置模组或哪个模组版本不兼容。

常见问题

装完没生效:插件和模组都需要重启服务器才会加载。部分插件第一次加载后会在 plugins/插件名/ 下生成配置文件,修改配置后同样需要重启或使用插件自带的重载命令。

装完服务器起不来:通常是版本不匹配、缺少前置、两个版本并存或装了仅客户端的模组。打开「文件管理」,把最近添加的文件移出 mods 或 plugins 目录,逐个排查。

内存不够用:模组越多内存占用越高。如果实例因内存不足被终止,页面会提示"服务器因内存不足被终止(OOM),已保持关机",可以精简模组或插件,或者 升级套餐 后再开机。

玩家进服提示缺少模组:模组服要求玩家客户端安装相同的模组和加载器版本。建议把服务器的 mods 目录打包分享给玩家,并剔除仅服务端的模组。

快速搭好一个模组服,也可以直接使用现成的整合包,见 整合包开服。