[1.16+]基岩版模组管家 —— 修复模组结构、收纳模组、制作整合包、迁移备份
声明：本工具及本帖文案由 AI AGENT 自动生成发布，经原作者 @缔造者 审核。工具功能、代码逻辑与使用说明均以实际发布版本为准，AI 生成内容仅供排版与描述参考。
目录
- 前言
- 工具预览
- 功能特性
- 使用说明
- 常见问题 FAQ
- 关于修复后仍然无法导入
- 隐私与安全说明
- 下载
- 查毒报告
- 反馈模板
- 更新日志
- 致谢与声明
前言
很多人在使用基岩版资源包、行为包、地图或整合包时，会遇到导入失败的问题。原因多半不是包本身坏了，而是压缩包内部多套了一层文件夹——manifest.json（地图则是 levelname.txt）没有直接出现在压缩包第一层，导致 Minecraft 无法正确识别。
除此之外，卸载 Minecraft、更新/降级版本时，最让人头疼的就是模组丢失——辛苦收集的资源包、行为包、整合包，一旦卸载游戏或切换版本就可能全部消失。
基岩版模组管家正是为此而生：它既能修复模组结构（解决嵌套文件夹导致的导入失败），也能帮你收纳模组、制作整合包、迁移备份，一个本地工具全部搞定。工具完全在浏览器本地处理，不上传任何文件、不联网、不需要安装任何环境。
⚠️ 操作前请务必先备份原文件。 本工具不会修改原文件，但备份是良好习惯。
工具预览
功能特性
模组收纳与迁移备份（重点）
- 卸载/更新/降级/共存版前，担心模组丢失？本工具可将已有模组保存并打包为整合包，支持安全转移和直接导入，方便在基岩版中继续使用。
- 使用方法：将
resource_packs 或 behavior_packs 目录中的文件自行打包为压缩包（zip），上传至本工具，即可制作成整合包。
- 支持将多个资源包/行为包分别修复后合并为一个
.mcaddon，导入后游戏内一次性恢复全部模组。
- 适合场景：换手机、重装系统、卸载重装游戏、切换正式版/测试版/共存版、降级回旧版本等。
读取游戏内模组（功能说明与平台限制）
工具设计上支持识别游戏内已安装的模组，方便一键收纳与备份。但受平台限制，无法在所有环境下直接自动读取游戏目录：
- Android 11+ 限制：系统分区存储（Scoped Storage）与
Android/data 目录访问限制，普通应用无法直接读取 Android/data/com.mojang.minecraftpe/ 下的模组目录，因此自动读取功能在安卓高版本上不可用。
- HTML 版限制：浏览器沙盒无法访问本地文件系统目录，只能通过用户主动选择文件/文件夹（
webkitdirectory）或拖拽上传。
- 替代方案：使用系统文件管理器或第三方文件管理器（MT管理器、FV文件管理器、ZArchiver 等）进入游戏目录，将
resource_packs / behavior_packs 手动打包为 zip 后上传至本工具处理。详见下方「手动导出游戏内模组」说明。
简单说：自动读目录做不到，手动打包上传完全够用。 工具会把上传上来的包修复好、整理好、打包好，剩下的只是「把文件从游戏目录里拿出来」这一步。
一键修复嵌套文件夹
- 自动扫描
manifest.json（地图为 levelname.txt）实际所在的层级，把它的父文件夹剥掉，让它直接出现在压缩包第一层。
- 修复过程只改结构、不改内容，manifest 内容、二进制资源、贴图、模型均原样保留。
自动识别包类型
| 类型 |
建议后缀 |
| 资源包 / 行为包 / 皮肤包 / 脚本包 |
.mcpack |
| 附加包 / 整合包 |
.mcaddon |
| 普通地图存档 |
.mcworld |
| 世界模板 |
.mctemplate |
| 仅修复结构 |
.zip |
- 当 manifest 类型和特征文件不一致时会给出冲突提示，方便你判断是 manifest 填错还是包本身混装。
整合包制作 / 导入
- 制作整合包：勾选「整合包模式」，选中多个包，工具会分别修复后放入 .mcaddon 内的独立文件夹，各自第一层都保留自己的
manifest.json，不会互相覆盖。
- 导入整合包：直接把
.mcaddon 拖进来即可。工具支持多层嵌套压缩包扫描，能识别整合包里嵌套的 .mcpack、.zip 等，并列出里面每个包让你单独处理或整体修复。
地图类型智能判断
- 检测到
levelname.txt 时进入地图分支：
- 没有
manifest.json → 判为普通地图，推荐输出 .mcworld；
- 有
manifest.json 且 type 为 world_template → 判为世界模板，推荐输出 .mctemplate；
- manifest 类型异常或解析失败 → 不强行判定，默认输出
.zip，由你手动选择。
其他细节
- 自动剔除
__MACOSX/、.DS_Store、Thumbs.db、desktop.ini 等垃圾文件。
- 输出文件名统一规范化，不会产生
.mcworld.mcworld 这种重复后缀。
- 下载历史记录保存在本机浏览器（IndexedDB），可随时重新下载。
- 可选音效，可一键关闭。
使用说明
HTML 版
- 下载
.html 文件，保存到电脑或手机任意目录。
- 用浏览器打开（手机端推荐 Chrome / Edge / 夸克 等较新内核；部分老旧国产浏览器内核过旧可能无法运行）。
- 点击「选择文件」或把文件拖进页面。
- 确认扫描结果与输出后缀，点击「开始修复」。
- 修复完成后点击「下载文件」，文件会保存到系统的下载目录。
Android APK 版
- 下载 APK 并安装（首次需在系统设置中允许「安装未知来源应用」）。
- 打开 App，界面与 HTML 版完全一致。
- 首次使用时系统可能请求存储权限，仅用于把修复后的文件保存到你指定的目录，不会读取其他数据。
- 后续步骤与 HTML 版相同。
手动导出游戏内模组（用于备份/迁移）
受 Android 11+ 的 Android/data 目录访问限制与 HTML 版浏览器沙盒限制，工具无法自动读取游戏目录，请按以下步骤手动导出：
- 使用文件管理器进入游戏目录：
- 路径通常为
- Android/data/com.mojang.minecraftpe/
- 部分设备/版本路径可能略有不同，以实际为准
- 进入
resource_packs 或 behavior_packs 目录。
- 长按选中需要备份的模组文件夹，选择「压缩」为 zip（也可整个目录打包）。
- 将压缩包上传至本工具，选择「整合包模式」或直接修复后下载。
- 卸载/更新/降级/切换共存版后，将导出的
.mcaddon / .mcpack 重新导入即可恢复模组。
安卓端导入 Minecraft
- 打开手机自带的「文件管理」，进入
Download 目录（完整路径通常是 /storage/emulated/0/Download）。
- 找到修复后的文件，点击文件，选择「用 Minecraft 打开」；也可以长按文件，选择「分享 → Minecraft」。
- 看到 Minecraft 的「导入成功」提示后，进入游戏对应列表即可使用。
若浏览器自动给文件追加了多余的 .zip 后缀，请先在文件管理器中把文件改回工具显示的文件名。
常见问题 FAQ
Q1：修复后文件名变成了 xxx.mcworld.zip 怎么办？
A：这是浏览器出于安全策略自动追加的后缀。请在文件管理器中把文件重命名，删掉末尾多余的 .zip 即可。本工具本身已对输出文件名做了规范化，不会主动产生重复后缀。
Q2：地图修复后游戏里看不到存档？
A：先确认输出的是 .mcworld（普通地图）还是 .mctemplate（世界模板），两者在游戏内的入口不同。普通地图在「单人游戏 → 导入」，世界模板在「新建世界 → 模板」中查找。
Q3：整合包装进去只有一部分生效？
A：整合包内的多个包需要游戏版本都兼容，且互相依赖完整。如果某个包 manifest 报错或版本不匹配，可能导致整包只加载部分内容。可把 .mcaddon 拖回工具里，逐个检查每个子包的识别结果。
Q4：为什么提示「类型冲突」？
A：说明 manifest 里声明的 type 和包内实际文件特征不一致。常见原因是开发者把资源包误填成行为包（或反之）。工具会按 manifest 的建议给出后缀，但建议你手动核对 manifest 内容；若确认填错，需先修正 manifest 的 type 再导入。
Q5：大文件（比如 >200MB）处理失败？
A：手机浏览器内存有限，文件过大时可能触发 OOM。建议改用电脑端 HTML 版处理，或关闭其他标签页后重试。
Q6：能不能直接读取游戏里的模组，一键备份？
A：设计上支持，但受平台限制：Android 11+ 无法直接访问 Android/data 目录，HTML 版浏览器沙盒也无法访问本地目录。因此目前需要你手动把 resource_packs / behavior_packs 打包成 zip 后上传，工具负责后续的修复、整理与整合包制作。详见「手动导出游戏内模组」。
Q7：修复后仍然无法导入？
A：见下方「关于修复后仍然无法导入」一节。
关于修复后仍然无法导入
本工具解决的是压缩包结构层的问题，即「manifest.json 不在第一层」这一类情况。但结构正确不等于包一定能导入。如果你的包在修复结构后依然无法被 Minecraft 识别，通常属于以下情况，不是本工具能处理的范畴：
- 包本身损坏：压缩包 CRC 校验失败、文件头损坏、资源不完整；
- manifest 内容错误：
format_version 与游戏版本不兼容、UUID 重复或缺失、type 填写不合法；
- 依赖缺失：行为包依赖某个资源包或脚本引擎，但整合包里没有一并带上；
- 游戏版本不匹配：包要求的最低引擎版本高于你当前的游戏版本；
- 加密或签名问题：部分第三方打包工具会加壳/加密，导致原文件本身不可解析；
- 文件类型不符：把 Java 版资源包、模组误当成基岩版包使用。
遇到以上情况，建议先用压缩软件把包解开，检查根目录是否有 manifest.json、manifest.json 是否能正常打开、format_version 是否与游戏版本匹配。确认无误后再重新打包。
简而言之：工具能修的是「结构」，修不了「内容」与「兼容性」。如果修复后仍然无法导入，请优先排查包本身的问题，而不是反复用本工具重试。
隐私与安全说明
- 工具不发起任何网络请求，不含统计埋点，不上传任何文件或文件名。
- 所有解压、修复、压缩均在浏览器 / WebView 本地内存中完成。
- 下载历史仅保存在本机浏览器 IndexedDB，可随时在页面内清空，不会上传到服务器。
- APK 版权限清单：
下载
- HTML 版（理论上支持所有设备，浏览器打开即用）：
基岩版模组管家.txt
(173.37 KB, 下载次数: 5)
- Android APK 版（WebView 离线壳，免浏览器打开）：
基岩版模组管家.apk
(9.12 MB, 下载次数: 11)
查毒报告
HTML 版为纯静态页面，内含 JSZip（MIT 协议），无外部请求；APK 版为 WebView 封装，权限仅限存储访问，不会上传任何数据。如有疑虑，可自行拆包审计或仅使用 HTML 版。
反馈模板
遇到问题时，请按以下格式在楼下反馈，方便我快速定位：
游戏版本：
文件类型（mcpack / mcaddon / mcworld / mctemplate）：
文件来源（自己制作 / 论坛下载 / 其他）：
修复后是否仍无法导入：
压缩包第一层目录截图：
处理日志中的报错信息（如有）：
更新日志
- v4.6：工具更名为「基岩版模组管家」；整合包模式支持多包分别修复；地图类型判定细化（普通地图 / 世界模板 / 冲突）；文件名规范化，避免重复后缀；新增模组收纳与迁移备份场景说明。
- v4.5：新增 manifest 解析失败时的文本兜底识别（兼容 CRLF / BOM 异常）。
- v4.4：加入下载历史记录、音效开关、嵌套压缩包扫描。
- v4.3：新增特征文件识别，修正资源包/行为包误判问题。
- 更早版本略。
致谢与声明
- 本工具为 AI 生成的原创作品，作者：苦力怕论坛 @缔造者。
- 内置解压组件 JSZip 3.10.1，遵循 MIT 协议，版权归原作者所有。
- 工具完全本地运行，不收集、不上传任何用户文件与使用数据。
- 欢迎转载，请注明作者与原帖链接；二次修改请同样保留原作者信息。
- 使用本工具造成的任何数据问题，作者不承担责任，请务必保留原始文件备份。
- 本帖文案由 AI 辅助生成，经作者审核发布。
- 在编写本工具时，大量参考了以下帖子的相关知识；该帖子为本工具的编写提供了重要参考，感谢原作者的整理与分享：
悬赏问答常见问题教程
YesN***
铁粒 +100
很给力!
提升卡
观察者
