Minecraft 存档挖不出家？用 Minecraft-Region-Fixer 修复损坏区块的 5 步完整指南

Minecraft 存档挖不出家用 Minecraft-Region-Fixer 修复损坏区块的 5 步完整指南【免费下载链接】Minecraft-Region-FixerPython script to fix some of the problems of the Minecraft save files (region files, *.mca).项目地址: https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer凌晨的服务器电源突然跳闸重启后玩家进存档原本铺满红石路的中空大厅变成了一大块望不见底的黑洞传送指令一执行就直接摔进虚空level.dat还偶尔读不出来。别急这多半是存档目录里的 region 文件.mca写坏了不是世界没救。Minecraft-Region-Fixer是一个纯 Python 的命令行工具入口为regionfixer.py专门扫描.mcaregion 文件、逐区块诊断问题并帮你用旧备份把坏区块换回去或删掉坏区块让游戏重新生成。动手之前记住一条铁律先把整个世界目录完整复制一份再跑任何修复命令。所有处置都是不可逆的程序作者也在 README.rst 的 Warning 一节里反复强调备份、备份、还是备份。Minecraft-Region-Fixer 安装与首次运行它只支持 Python 3.x不兼容 Python 2.x也不需要 pip 安装任何依赖把代码拉到本地就能跑git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer python3 regionfixer.py --help预期结果终端打出一整段帮助信息包含region_fixer [options] world-path other-world-path ... region-files ...的用法说明和全部参数列表。命令行的基本形态是一次传入一个或多个世界文件夹也可以只丢几个单独的.mca文件进去。如果报Minecraft Region Fixer only works with python 3.x说明你的默认python还是 2.x换python3执行即可如果是双击regionfixer.py弹出的窗口程序会直接提示「请用命令提示符运行」——它是个纯粹的命令行应用。第一次扫描读懂损坏区块检测报告扫描本身只读不写放心跑。先对myworld做一次带详细输出的体检python3 regionfixer.py --verbose myworld--verbose或-v会关掉进度条改为每个被扫描的文件输出一行结果行尾的字母就是问题类型缩写。对照 regionfixer_core/constants.py 里的状态表含义如下缩写状态通俗解释cCorrupted 损坏区块数据读不出来最典型的黑洞元凶wWrong located 位置错乱区块被写到了错误的坐标槽位tmeToo many entities 实体过多区块里塞了太多实体常见于卡顿刷怪塔soSharing offset 共用偏移多个区块指向了同一块数据区mtMissing Entities tag 缺实体标签缺少Entities标签加载时容易出幺蛾子region 文件层面还有tsToo small文件太小多半是被截断写坏、ur读取时 IOError、pe权限错误level.dat和玩家*.dat文件如果读不出来报告里只会给警告——程序会检查它们但目前不修这类文件坏了只能靠备份救。扫描结束会打印一份汇总报告。加--log 文件名可以把每个问题region 文件、区块坐标、问题类型落成日志留档填-则直接在扫描结束时把日志打印到终端。预期结果报告里Corrupted与Wrong located的计数大于 0就说明黑洞确实来自 region 文件接下来按下面的顺序选手段。三档处置备份替换、原地抢救、删除重生 按你的家底选路径有旧备份走第一档想抢救数据走第二档什么都没有才动第三档。第一档用备份替换坏区块服务器平时有定时备份的话这是唯一不损失任何东西的方案。python3 regionfixer.py --backups /path/to/backup --replace-corrupted --replace-wrong-located myworld程序会从备份里按坐标取出对应区块覆盖掉当前世界里的坏块并在结束时打印N replaced of a total of M chunks。几个硬限制必须知道--backups必须至少搭配一个--replace-*选项否则直接报The option --backups needs at least one of the --replace-* options一次只能扫一个世界同时传多个世界或单独的 region 文件会被拒绝Cant use the replace options while scanning multiple worlds...路径要指向包含region/子目录的世界根目录不是region文件夹本身备份支持逗号分隔写多个目录但元素之间不能带空格程序不会校验备份和当前世界是否同源填错路径它也照单全收建议备份目录与世界目录保持同构。第二档没有备份原地抢救--fix-*系列是无损抢救--delete-*系列才会真的删数据动手前先想清楚用哪一类。python3 regionfixer.py --fix-corrupted --fix-wrong-located --fix-missing-tag myworld--fix-corrupted从损坏区块里尽可能多地把还能读出来的数据抠出来原地修复--fix-wrong-located按区块数据里记录的真实坐标把放错位置的区块搬回正确槽位--fix-missing-tag给缺Entities标签的区块补上标签。成功时对应类别会打印Repaired N chunks with status: ...没有可修的问题则打印No chunks to fix with status: ...。第三档删除后让游戏重生成抢救失败、也不值得纠结了就删掉坏区块Minecraft 下次加载时会按世界种子重新生成这片地形python3 regionfixer.py --delete-corrupted --delete-wrong-located myworld注意--delete-entities是另一种「删」——它不删区块只清掉实体数超过上限的区块里的全部实体怪物和掉落地面的物品箱子等容器内容不受影响默认上限 300可用--entity-limit调整。它是扫描过程中边扫边删的中途卡住可以停掉再续跑。 几个常用参数的速查表参数别名作用--replace-corrupted/--replace-wrong-located--rc/--rw用备份区块替换坏块必须搭配--backups--fix-corrupted--fc损坏区块原地抢救--fix-wrong-located--fw位置错乱的区块按数据坐标搬回原位--fix-missing-tag--fm补上缺失的Entities标签--delete-corrupted/--delete-wrong-located--dc/--dw删除坏区块交给游戏重生成--delete-entities--de清掉超限区块里的全部实体--entity-limit--el配合--de设实体上限默认 300--relocate-wrong-located--rl依据区块内数据重定位错乱区块同样限单世界--processes-p多进程扫描大世界可设 4 提速默认 1--verbose-v逐文件输出带问题字母的结果行--log-l问题清单写入日志文件不能与--replace-*、--delete-*同用--text-file-input--tf从文本文件批量读取路径每行一个支持通配符和#注释 顺手一提批量巡检服务器上的多个世界时把路径写进一个 txt再配合--text-file-input一次性扫完单独怀疑某个.mca时也可以直接把文件路径丢给命令行。底层解析.mca的逻辑在 nbt/region.py想深挖细节可以翻这里。预期结果处置完成后原样再跑一遍python3 regionfixer.py myworld报告里各类问题计数全部归零进程返回码为 0发现过问题时返回 3方便脚本判断。进游戏原来黑洞的坐标应该重新长出了地面。常见报错与翻车现场排查清单「Only works with python 3.x」默认python是 2.x改用python3执行。替换参数报 Error 却什么都没发生八成是--backups和--replace-*没配对——要么没写备份目录要么一次塞进了多个世界/多个 region 文件按报错文字调整参数即可。No valid backup directories found, wont fix any chunk备份路径指向错了确认它是有region/子目录的世界根目录而不是region文件夹本身。实体删得太狠--de删的是区块内所有实体怪物掉落物阈值设太低会连农场里的鸡一起清掉。先用默认 300 观察再用--entity-limit微调。修完问题依旧反复修复无效时要考虑磁盘坏道这类硬件层面的损坏——优先换盘、重新校验备份而不是把工具当复读机。复盘把流程固化下来回到开头那个场景电源跳闸后的黑洞最后靠一份旧备份的区块替换 一次--fix-wrong-located抢救就补了回来玩家回家发现大厅完好只有几片边缘长成了新地形。新版 Minecraft 对损坏的容错确实越来越强但「用备份替换区块、清理实体、看清世界到底坏在哪」这三件事Minecraft-Region-Fixer 至今仍是顺手得多的选择。把「先备份、再扫描、后处置」当成固定动作绝大多数坏掉的.mca都还能救回那个完整的世界。【免费下载链接】Minecraft-Region-FixerPython script to fix some of the problems of the Minecraft save files (region files, *.mca).项目地址: https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考