Packed Packs

• 添加额外文件夹以查找资源包。
• 在 config/packed_packs.json 的 resourcepacks 或 datapacks 中，将路径添加到 additionalFolders 数组进行配置。
• 如果该数组不存在，可以手动创建，或打开并关闭 Packed Packs 界面以更新配置文件。
• 路径可以是绝对路径，也可以是相对于游戏目录的路径。
• 正确添加的文件夹会作为上下文菜单中的 打开资源包文件夹 选项显示。
• 需要重启游戏才能生效。

• 任何不含 pack.mcmeta 的文件夹都会被视为文件夹资源包。
• 在文件夹根目录添加 pack.png，即可设置自定义图标。
• 文件夹可以嵌套。
• 可以打开文件夹查看并重新排列其中的内容。顺序会保存到文件夹根目录中的 packed_packs.folderpack.json。
• 可以锁定文件夹资源包，使其表现得像普通资源包一样，可在行和列之间移动。这类文件夹也称为 module。
  • 子项无法移出已锁定的文件夹资源包。锁定文件夹资源包时，其中的子项会自动归回。
  • 已锁定的文件夹资源包也会锁定所有作为文件夹的后代项。
  • 可以在选项菜单中设置新发现的文件夹默认锁定。
• 在 packed_packs.folderpack.json 中指定后，可以将内置资源包添加到文件夹资源包中。
  • 示例：

    {
      "module": false,
      "packIds": [
        "continuity:default",
        "examplenamespace:examplepath"
      ] 
    }

  • 注意：只能在 Packed Packs 界面之外进行此操作，因为 packed_packs.folderpack.json 文件只会在进入界面时加载一次，以防未保存的状态被覆盖。

• 关闭时自动应用资源包。
• 替换默认的资源包和数据包界面。
• 移除不兼容整合包上的红色背景。
• 默认锁定文件夹整合包。
• 重新打开界面时记住上次查看的配置文件。

• 切换开发者模式 — `Ctrl` + `Shift` + `I` | `F12`
• 在开发者模式下，右键菜单中会显示其他选项。
• 偏好设置：切换特定小组件的显示状态。
• 锁定配置档：锁定的配置档无法删除、重命名或修改。
• 覆盖整合包属性：
  • 覆盖设置按配置档分别配置，且仅应用于对应配置档，除非将其设为默认值。
  • 覆盖整合包的 必需 属性。也可以禁用必需整合包。
  • 覆盖整合包的 位置 属性。也可以移动固定整合包。
  • 隐藏整合包。
• 默认配置档：
  • 默认配置档的覆盖设置会对所有配置档全局生效，即使没有配置档也会生效，包括原始界面。
  • 默认配置档中启用的整合包会自动标记为兼容。
  • 在以下情况下会自动加载默认配置档：
    • 资源包：缺少 options.txt或 config/packed_packs/__version.json 时。
    • 数据包：创建新世界时。
• 整合包别名：为整合包 ID 添加别名
  • 旨在帮助整合包开发者在需要更新时迁移资源包/数据包，而不影响用户配置的整合包选择和顺序。
  • 仅当整合包已被选中但不存在时才会使用。匹配从别名映射表的顶部开始，并解析为第一个匹配项，详见 config.meta.json 文件。
  • 支持正则表达式（必须以 regex: 为前缀）；设置正确后，编辑别名对话框中的文本颜色会改变。
  • 无论在别名映射表中的位置如何，精确匹配始终优先于正则表达式匹配（例如，整合包 ID file/test-v1.2 始终会匹配 "file/test-v1.2": "file/test-v1.4"，而非 "regex:file\\/test-v\\d*": "file/test-v2"）。
  • 别名也可以映射到正则表达式值（必须以 regex: 为前缀），并尝试与任何可用整合包匹配。此操作只能在 config.meta.json 文件中完成。
  • 别名不会自动清除，即使它指向的整合包已不存在也一样。只能通过游戏内界面或配置文件手动移除。
  • 通常不建议在数据包上使用，因为这可能会损坏世界。请充分测试。

Java API 是一项可选依赖，允许模组扩展功能或为 Packed Packs 添加兼容性。它支持订阅各类事件，以及注册自定义偏好设置，以便在屏幕的指定位置添加可配置的小组件。

你可以在 testmod 中，以及 **主要** 源代码集的 compat 包中查看示例实现。

你也可以从源代码中查看 Java 文档。

访问 Wiki 页面了解更多详情。

已显式添加兼容支持：

• Resourcify
• Respackopts
• VTDownloader
• Entity Texture Features
• Polytone

如果上述模组变得不兼容，请提交问题。请务必确认使用了与目标 Minecraft 版本相匹配的正确模组版本，并确认该问题仅在安装了 Packed Packs 时才会出现。

注意：上述模组的兼容性是在 Java API 推出之前添加的。其他模组最好改用 Java API，以获得更好的长期兼容性。如果上述模组做出足够多的破坏性变更，可能不得不放弃对它们的支持。