此转换器能做什么和不能做什么
Minecraft Java 和 Bedrock 资源包使用不同的元数据和纹理路径。此工具处理有用的基础转换：资源包元数据、资源包图标和常见纹理文件夹。它并不声称能完美转换 OptiFine CIT、CEM 模型、光影、Java 物品模型、Bedrock 渲染控制器或行为包逻辑。
当资源包主要由标准方块和物品纹理组成，或者您想要一个干净的手动移植起点时，请使用此转换器。Java Edition 和 Bedrock Edition 是独立的引擎，具有不同的文件名、模型系统、材质规则和元数据。因此，转换后的压缩包应视为仍需在游戏内测试的工作草稿，而不是所有功能都兼容的证明。
Java → Bedrock
创建 manifest.json，生成 UUID，将 assets/minecraft/textures/block 和 item 映射到 Bedrock 纹理文件夹，并导出 .mcpack。
Bedrock → Java
创建 pack.mcmeta，将 textures/blocks 和 textures/items 映射到 Java 纹理文件夹，并导出 Java 版 .zip。
Java 更新
复制 Java 资源包，并使用您选择的 pack_format 为较新的 Minecraft 版本重写 pack.mcmeta。
1. 保留原始压缩包
开始前请备份。转换器会创建新的下载，不会覆盖源文件，但原始资源包是您需要恢复模型、纹理或元数据条目时最安全的参考。
2. 选择正确的转换方向
Java 转 Bedrock 用于包含 pack.mcmeta 的 Java .zip。Bedrock 转 Java 用于包含 manifest.json 的 .mcpack 或 .zip。Java 版本更新仅重写已有 Java 资源包中的 pack.mcmeta。
3. 检查检测到的资源包详情
转换前请检查资源包名称、描述和 Java pack_format。pack_format 值仅告知 Java 目标资源包格式，不会自动重写模型或其他版本特定文件。
4. 下载并在新世界中测试
安装转换后的压缩包，单独启用它，并检查多个方块和物品。在没有其他资源包的情况下测试，更容易发现缺失纹理、错误路径和加载顺序冲突。
转换过程中会发生什么变化
下表将自动完成的工作与您应自行检查的部分分开。这样更容易在处理大型压缩包之前判断转换器是否适合您的资源包。
| 转换 | 自动处理 | 下载后需检查 |
|---|---|---|
| Java 转 Bedrock | 创建 manifest.json 和 UUID，复制包图标，并重新映射常见的方块和物品纹理路径。 | Java 模型、OptiFine 功能、光影、字体、声音、动画以及 Bedrock 材质或渲染控制器要求。 |
| Bedrock 转 Java | 创建 pack.mcmeta，复制资源包图标，并将常见的方块和物品重新映射到 Java 纹理树中。 | 仅限 Bedrock 的 UI、实体定义、附着物、渲染控制器、材质以及任何行为包内容。 |
| Java 版本更新 | 复制压缩包，并用选定的 pack_format 和描述替换 pack.mcmeta。 | 重命名的纹理路径、更改的模型架构、移除的游戏资源以及 Minecraft 版本之间的其他更改。 |
测试清单
- 确认 Minecraft 能识别压缩包并显示预期的资源包名称和图标。
- 检查多种材质家族的方块和物品，而不是只测试一种纹理。
- 查找紫色和黑色缺失纹理图案，并阅读游戏日志以查找无效路径。
- 分别测试动画纹理、透明像素、自定义声音、字体、模型和用户界面。
- 打开下载中的 CONVERSION_NOTES.txt。它列出了转换器因需要手动处理而跳过的文件。
常见转换问题
Minecraft 无法识别资源包： 打开存档，确保 pack.mcmeta 或 manifest.json 位于存档根目录，而不是在额外的嵌套文件夹中。
某些纹理缺失： 将缺失的资源与原始资源包进行比较，并检查其特定版本的路径。复杂模型可能引用了不属于基本文件夹映射的其他纹理。
资源包加载了但外观错误： 禁用其他资源包，验证目标 Minecraft 版本，并检查透明或动画纹理。不同版本可能对 UV 布局和渲染规则的解释不同。
隐私与大型资源包
选定的压缩包保留在您的浏览器中。JSZip 在本地读取并重建它，因此该工具不会将您的纹理上传到 MC Toolbox。非常大的资源包仍可能占用大量内存，因为浏览器必须同时保存源压缩包和生成的压缩包。如果大型转换失败，请关闭未使用的标签页，并在桌面浏览器上尝试。
资源包转换器常见问题
它能完美转换所有资源包吗？
不能。它处理常见的纹理和元数据转换。OptiFine CIT、CEM 模型、光影、自定义 Java 模型、Bedrock 渲染控制器和行为逻辑通常需要手动编辑。
我的文件会被上传吗？
不会。转换器使用 JSZip 在您的浏览器中本地运行。它读取您的压缩包，构建新压缩包并下载，不会将资源包发送到服务器。
我应该上传哪些格式？
Java 资源包使用 .zip，Bedrock 资源包使用 .mcpack 或 .zip。输出为 Bedrock 的 .mcpack 或 Java 的 .zip。
更改 pack_format 会更新旧纹理和模型吗？
不会。Java 版本更新仅更改 pack.mcmeta。Minecraft 在多个版本中重命名了文件并更改了模型格式，因此旧资源包可能仍需要手动迁移。
我可以将 Bedrock 行为包转换为 Java 数据包吗？
不能。此转换器用于常见的资源包元数据和纹理。Bedrock 行为包和 Java 数据包使用不同的系统，需要专门的转换或手动重建。
为什么转换后的资源包文件更少？
特定版本和不支持的路径会被有意排除在生成的压缩包之外。阅读 CONVERSION_NOTES.txt 以查看跳过了哪些文件，然后手动移植您仍然需要的功能。