跳到主要内容

ResourcePackManager 安装设置

本页面介绍单服务器（独立）的安装流程。如果你运行 BungeeCord / Waterfall / Velocity 网络，请改为参阅 Proxy networks — 你在代理上安装的是同一个 ResourcePackManager.jar，但它会生成自己的配置并扮演代理侧的角色。

ResourcePackManager 2.x 以单个通用 jar 的形式发布。完全相同的 ResourcePackManager.jar 既能运行在 Bukkit/Paper 后端上，也能运行在 Velocity / BungeeCord / Waterfall 代理上——它会根据自身所运行的加载器自动检测平台。不再有单独的 resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar 文件，也不再有需要解压并复制到别处的捆绑“代理扩展”。

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

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

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

核心命令​

  • /rspm setup — 打开一个游戏内 GUI 设置菜单（插件更新状态、推荐插件、自动更新开关，以及一个带有指向 wiki、Discord 和你的 Nightbreak 账户令牌的可点击链接的信息按钮）
  • /rspm reload — 重新构建并重新托管合并后的资源包
  • /rspm status — 打印完整的诊断信息：资源包状态、托管模式、网络密钥、集成情况
  • /rspm itemsadder configure — 自动为 RSPM 托管配置 ItemsAdder（见下文）
  • /rspm itemsadder dismiss — 根据玩家 UUID 永久关闭 ItemsAdder 警告
  • /rspm data_compliance_request — 下载本服务器在远程存储的全部数据

根命令为 /resourcepackmanager，/rspm 是它的别名。RSPM 还继承了一些共享的 MagmaCore/Nightbreak 子命令（例如 /rspm recommendedplugins、/rspm downloadall），设置菜单中的按钮就指向这些命令。

权限：

  • /rspm setup 需要 resourcepackmanager.setup，仅允许玩家执行（它会打开一个物品栏 GUI，因此无法从控制台运行）。
  • /rspm reload、/rspm status、/rspm itemsadder <configure|dismiss> 以及 /rspm data_compliance_request 都需要 resourcepackmanager.*。

ItemsAdder​

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

请使用：

/rspm itemsadder configure

该助手会更新相关 ItemsAdder 设置、重新生成 ItemsAdder 的资源包，然后重新加载 ResourcePackManager。具体来说它会：

  • 将 resource-pack.hosting.no-host.enabled 设为 true
  • 禁用 resource-pack.zip.protect-file-from-unzip 下的 protection_1、protection_2 与 protection_3
  • 将 resource-pack.zip.compress-json-files 设为 false（RSPM 需要未压缩、可解析的模型 JSON 供 mixer 和基岩版转换器使用）
  • 调度 /iareload，再调度 /iazip
  • 大约 15 秒后重新加载 ResourcePackManager，给 ItemsAdder 留出重载和重新生成的时间

如果 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 deployment — 提醒你网络代理 jar 就是同一个 ResourcePackManager.jar；在网络上，把它复制到代理的 plugins/ 文件夹
  • Integrations — Floodgate / Geyser-Spigot 检测情况、在线玩家数

如果有异常，请查看 Troubleshooting。

下一步​