跳到主要内容

Resource Pack Manager 故障排除

本页仅涵盖 ResourcePackManager 代码库中当前已确认的行为。

玩家未收到资源包​

请先检查以下内容：

  • 如果您希望 ResourcePackManager 自动发送其托管的资源包，必须启用 autoHost
  • 合并的资源包必须存在且已成功上传
  • 玩家仅在加入时或在当前运行期间完成新上传后接收资源包

如有需要：

  1. 运行 /rspm reload。
  2. 查看控制台输出，检查上传或远程服务器错误。
  3. 重新加载完成后，用测试玩家重新加入。

如果您使用自托管而非自动托管，ResourcePackManager 不会为您推送自定义 URL。在该设置中，您仍然需要自己的服务器端资源包分发流程。

ItemsAdder 已安装，但其内容在最终资源包中缺失​

这通常意味着 ItemsAdder 的配置仍然阻止 ResourcePackManager 读取或托管其输出。

使用：

/rspm itemsadder configure

该命令目前会：

  • 启用 resource-pack.hosting.no-host.enabled
  • 禁用 protection_1、protection_2 和 protection_3
  • 运行 /iazip
  • 稍后重新加载 ResourcePackManager

如果命令提示 ItemsAdder 已在托管自己的资源包，请先手动禁用 ItemsAdder 的托管，然后重新运行该命令。

合并的资源包无效或上传失败​

ResourcePackManager 的自动托管集成明确处理以下服务器端错误类型：

  • 缺少必需文件
  • 文件过大
  • 文件格式无效
  • 缺少会话
  • 远程服务器不可用

如果遇到以上情况：

  1. 运行 /rspm reload 重建资源包。
  2. 检查是否有源资源包格式错误、已加密或无法读取。
  3. 检查最终合并的资源包根目录是否仍包含有效的 pack.mcmeta 和 pack.png。

插件会跳过无法正常解压的资源包，并在控制台记录警告。

一个插件的资源覆盖了另一个插件的资源​

这由以下文件中的 priorityOrder 控制：

plugins/ResourcePackManager/config.yml

上方的条目优先于下方的条目。

对于不可合并的文件，ResourcePackManager 替换低优先级的文件。对于可合并的 JSON 文件，它会合并内容。当前可合并的 JSON 类别为：

  • sounds.json
  • 语言文件
  • minecraft/models/item 中的原版物品模型 JSON
  • 图集文件
  • 字体文件

如果您需要检查上次合并期间发生了什么，请查看：

plugins/ResourcePackManager/collision_log.txt

GUI 文本或基于字体的元素显示异常​

字体文件是 ResourcePackManager 合并的 JSON 类别之一，但这并不保证两个不同的字体系统在 Minecraft 中能正常协同工作。

如果基于字体的菜单或 HUD 显示异常：

  1. 更改 priorityOrder，使您希望优先的资源包排在更高位置。
  2. 运行 /rspm reload。
  3. 检查 collision_log.txt 确认冲突发生在预期位置。

资源包更改未立即显示​

ResourcePackManager 有一个针对受支持资源包源的监视器。

它等待已更改的资源包保持不变 3 秒，然后一旦所有被监视的资源包都稳定，重新合并会立即发生。

如果您正在积极重新生成另一个插件的资源包，请在文件写入停止后等待几秒钟。如有疑问，请在上游插件完成后运行 /rspm reload。

自动托管无法连接远程服务器​

ResourcePackManager 的内置主机与以下地址通信：

https://magmaguy.com/rsp/

如果该连接失败，插件会记录通信警告，并在成功重新连接之前无法自动托管。

您的选择是：

  1. 修复服务器的出站 HTTPS 连接
  2. 等待远程服务恢复可用
  3. 禁用 autoHost 并改为自托管生成的 zip 文件

我想自托管合并的资源包​

代码支持的设置是：

  1. 设置 autoHost: false。
  2. 如果您希望 ResourcePackManager 将额外副本写入现有文件夹，请设置 resourcePackRerouting。
  3. 自行托管 ResourcePackManager_RSP.zip。

resourcePackRerouting 相对于 plugins 目录解析，目标文件夹必须已经存在。

我需要检查此服务器存储了哪些远程数据​

使用：

/rspm data_compliance_request

如果自动托管有活跃的远程会话，ResourcePackManager 会将响应下载到：

plugins/ResourcePackManager/data_compliance

如果没有远程会话，命令会报告没有可请求的远程数据。