跳到主要内容

ResourcePackManager 安装设置

本页面介绍单服务器（独立）的安装流程。如果你运行 BungeeCord / Waterfall / Velocity 网络，请改为参阅 Proxy networks — 代理安装方式不同，且需要单独的 jar 文件。

推荐安装步骤（独立服务器）​

  1. 将 ResourcePackManager.jar 放入服务器的 plugins/ 目录。
  2. 启动一次服务器，让插件生成配置文件、mixer、blueprint、output 以及 proxy-extension 文件夹。
  3. 决定你是否希望：
    • 启用自托管（默认开启）
    • 启用 MagmaGuy 的免费 auto-host 回退（默认开启）
    • 强制客户端接受资源包
    • 通过 mixer 文件夹手动添加自定义资源包
  4. 修改配置或手动添加自定义资源包后，运行 /rspm reload。

正常流程到此就完成了。使用默认设置时，RSPM 会优先尝试自托管，一旦发现任何异常就自动回退到 MagmaGuy 的 CDN。

核心命令​

  • /rspm setup — 打印一行提示，告诉你直接编辑配置文件（没有 GUI 菜单）
  • /rspm reload — 重新构建并重新托管合并后的资源包
  • /rspm status — 打印完整的诊断信息：资源包状态、托管模式、网络密钥、集成情况
  • /rspm itemsadder configure — 自动为 RSPM 托管配置 ItemsAdder（见下文）
  • /rspm itemsadder dismiss — 根据玩家 UUID 永久关闭 ItemsAdder 警告
  • /rspm data_compliance_request — 下载本服务器在远程存储的全部数据

根命令为 /resourcepackmanager，/rspm 是它的别名。

权限：

  • /rspm setup 需要 resourcepackmanager.setup，仅允许玩家执行（它只是打印一行指向配置文件的提示）。
  • /rspm reload、/rspm status、/rspm itemsadder <configure|dismiss> 以及 /rspm data_compliance_request 都需要 resourcepackmanager.*。

ItemsAdder​

目前推荐的 ItemsAdder 接入方式不再是纯手动配置。

请使用：

/rspm itemsadder configure

该助手会更新相关 ItemsAdder 设置、运行 /iazip，然后重新加载 ResourcePackManager。具体来说它会：

  • 将 resource-pack.hosting.no-host.enabled 设为 true
  • 禁用 resource-pack.zip.protect-file-from-unzip 下的 protection_1、protection_2 与 protection_3
  • 调度 /iazip
  • 暂停 5 秒后重新加载 ResourcePackManager

如果 ItemsAdder 已被配置为自托管资源包（self-host、external-host 或 lobfile），助手命令会停止执行，并提示你先手动禁用 ItemsAdder 的托管。

基岩版 / GeyserMC 支持​

RSPM 会自动将合并后的 Java 资源包转换为可供 GeyserMC 使用的基岩版资源包。转换流程支持任何使用 1.21.4+ 物品定义格式的插件资源包——不仅是 FreeMinecraftModels——包括 3D 手持物品、自定义盔甲和带模型的装备。

bedrockConversionEnabled 默认为 true，所以在已装有 GeyserMC 的服务器上全新安装后即可直接使用。

对于独立服务器，只要满足以下任一条件即可触发转换：本服务器装有 Geyser-Spigot；本服务器装有 Floodgate；或 RSPM 检测到处于代理模式（详见 Proxy networks）。

完整的流水线说明、输出路径和显示偏移调优请参阅 Bedrock / Geyser conversion。

验证安装​

在控制台中或以 OP 身份运行 /rspm status。输出分为多个部分：

  • Plugin meta — 版本与部署模式（独立 vs network-backend）
  • Java Pack — 是否已合并、大小、SHA1 前缀
  • Bedrock Pack — 是否已转换、是否有映射文件；若转换被跳过会给出诊断提示
  • Hosting — 当前激活的分发路径（自托管 / 远程 / 尚未就绪）、客户端将看到的 URL、解析得到的外部主机名、自动检测到的公网 IP
  • Proxy extension jars — 已捆绑的 Velocity/Bungee jar 路径（即使在独立服务器上也会解压——以备日后接入代理时使用）
  • Integrations — Floodgate / Geyser-Spigot 检测情况、在线玩家数

如果有异常，请查看 Troubleshooting。

下一步​