安装插件与模组
用实例的「资源」标签从 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 版本",请在下拉框中手动选择,选择会保存在当前浏览器。代理端显示"不限"。
- 安装目录:资源将被上传到的目录。
如果提示"暂不支持该服务端核心",说明当前核心不能使用资源中心,请改用下文的手动上传。
搜索和安装
- 在资源类型中选择「模组」「插件」或「数据包」(只显示当前核心支持的类型)。
- 在搜索框输入名称或关键词,可以按「相关度」「下载量」「关注数」「最新发布」「最近更新」排序。结果较多时点「加载更多」。
- 点击一个资源,打开详情。「兼容版本」列表只显示适合当前核心和 MC 版本的版本,标有「已安装」「可更新」「含必需前置」等标记。
- 在要安装的版本右侧点击「安装」。
- 在安装窗口中确认要安装的文件:「主资源」是你选择的资源,「必需前置」是它依赖的其他资源,默认一并勾选。
- 点击「开始安装」,等待每个文件依次显示「下载中」「校验中」「上传中」「已安装」。需要中途中止可以点「停止」。
- 完成后点「完成」,然后重启服务器使资源生效。
安装说明:
- 文件经资源网关下载到浏览器,校验 SHA-512 后上传到实例。
- 目标目录已有同名文件时会跳过,不会覆盖。
- 作者标注为仅客户端的资源会提示"该资源不支持服务端",不提供安装。
- 实例到期后文件为只读,需要续费后才能安装资源;实例安装中也不能添加资源。
疑似旧版本提示
如果安装窗口提示"目录中可能已有其他版本",说明目录里有名称相近的文件。同一模组或插件的两个版本并存会导致启动失败或只加载其中一个,请安装后到「文件管理」中删除旧文件。
平台按文件名判断是否已安装,改过名的文件无法识别。
方式二:手动上传
适用于 Modrinth 上没有的资源、NukkitX 插件、付费插件,或者整批迁移已有的模组。
通过文件管理
- 先在本地确认文件与核心和 MC 版本匹配。插件一般是
.jar,模组是.jar,数据包是.zip或文件夹。 - 打开「文件管理」,进入
plugins或mods目录(第一次使用前如果目录不存在,可以先开机一次让服务端生成,或用「新建目录」创建)。 - 点击「上传」按钮,或直接把文件拖进文件列表。文件很多时,可以在本地压缩成 zip 上传,再右键选择「解压」。
- 重启服务器。
网页上传单个文件有大小限制,大文件或大量文件建议使用 SFTP。
通过 SFTP
点击实例页面顶部的「SFTP」按钮获取连接信息,用 FileZilla、WinSCP 等客户端连接后,把文件拖到 plugins 或 mods 目录即可。详细步骤见 SFTP 连接。
安装后检查
- 重启后切到「控制台」,观察启动日志中是否有报错。
- 插件服可以在控制台执行
plugins(或pl)查看已加载的插件列表,没有出现在列表里的插件说明加载失败,可在启动日志中搜索它的名字查看原因。 - 模组服如果启动失败,日志中通常会写明缺少哪个前置模组或哪个模组版本不兼容。
常见问题
装完没生效:插件和模组都需要重启服务器才会加载。部分插件第一次加载后会在 plugins/插件名/ 下生成配置文件,修改配置后同样需要重启或使用插件自带的重载命令。
装完服务器起不来:通常是版本不匹配、缺少前置、两个版本并存或装了仅客户端的模组。打开「文件管理」,把最近添加的文件移出 mods 或 plugins 目录,逐个排查。
内存不够用:模组越多内存占用越高。如果实例因内存不足被终止,页面会提示"服务器因内存不足被终止(OOM),已保持关机",可以精简模组或插件,或者 升级套餐 后再开机。
玩家进服提示缺少模组:模组服要求玩家客户端安装相同的模组和加载器版本。建议把服务器的 mods 目录打包分享给玩家,并剔除仅服务端的模组。
快速搭好一个模组服,也可以直接使用现成的整合包,见 整合包开服。
