存档坏了先别删档!Minecraft存档修复工具 Region-Fixer,从体检到修复一次讲清【免费下载链接】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你按下传送键,准备向朋友炫耀刚完工的地下基地,结果落地的一瞬间整个人都麻了:脚下是老版本才有的旧地形,几米外是你新建的基地外墙,两者像两片拼错的地图硬生生挤在一起,精心铺好的铁路被拦腰截断。服务器没崩、存档没丢,但世界坏了。先按住删档的手。这种局面,大多数情况不用回档、更不用重开——一个免费开源的 Minecraft存档修复工具 Minecraft-Region-Fixer,能帮你在不碰其他数据的前提下,把坏掉的那几块单独挑出来处理。动手之前,先对照症状看看你的存档属于哪种坏不同毛病用药完全不同,先给自己做个简单诊断:进游戏报错、区块加载失败:日志里全是Error parsing chunk data之类的话——多半是区块数据损坏;地形新旧错乱、房子悬空:区块位置信息错位,数据其实还在,只是贴错了标签;服务器越来越卡、刷怪塔怪物爆满:单个区块里实体数量爆炸,快把区块挤爆了;区域文件小得离谱:整个 .mca 文件只有几 KB,像被掏空了似的。看到这些术语别慌,下面用一个大白话的比喻讲清楚。一张图看懂存档为什么坏:你的世界是一套图书馆合订本Minecraft 的世界不是一整块硬盘,而是拆成很多个 .mca 区域文件——把它们想象成图书馆里的一本本合订本,每本大概覆盖 512×512 格的范围。每一页就是一个区块(Chunk),页面里记录着地形、方块、箱子里的东西、游荡的怪物;页面上的排版内容就是 NBT 数据,相当于游戏读取世界的说明书;合订本出问题的花样不少:有的页被撕烂(区块损坏,数据读不出来),有的页装订时页码贴错(区块位置错位,内容还在但放错了地方),有的页内容多到快撑破书脊(实体过多),还有的整本书只剩个空壳(区域文件过小)。Region-Fixer 干的事,就是一本一本翻你的合订本,把烂页、错页、爆页、空壳全部标注出来,再按你的指令处理。它的扫描核心逻辑都在项目的 regionfixer_core/scan.py 里,你不用看懂代码,只要知道它能把这些病逐项报出来就够了。四步实操:拿工具、做体检、看报告、对症下药第 1 步:把工具请回家git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer python3 --version白话解释:第一行把工具源码下载到本地文件夹,第二行进入这个文件夹,第三行确认 Python 版本。这个工具只认 Python 3,版本太老会直接拒绝工作。第 2 步:先体检,只读不改python3 regionfixer.py /你的存档路径白话解释:这一条是纯体检——它会把所有 .mca 文件和 level.dat 挨个扫一遍,把问题清单列在屏幕上,全程只读,一个字节都不改。第一次使用,无论如何先跑这条,搞清楚世界到底病在哪。第 3 步:看懂报告,再选方案扫描结束后,屏幕会列出每个区域文件、每个区块的状态:Corrupted(损坏)、Wrong located(位置错位)、Too many entities(实体过多)、Sharing offset(共享偏移)、Missing Entities tag(缺实体标签)……对照下面的方案选药。第 4 步:三种常见对症方案方案 A:你有旧备份(最稳妥,相当于微创手术)python3 regionfixer.py --backups /备份路径 --replace-corrupted /你的存档路径白话解释:让工具去备份里找对应的那一页,把存档中损坏的页替换掉,其余部分原封不动。注意替换必须配合备份目录,否则工具会直接报错提醒你。方案 B:没有备份(删掉坏页,让游戏重新生成)python3 regionfixer.py --delete-corrupted /你的存档路径白话解释:把坏区块标记成待重建,下次进游戏 Minecraft 会自动把这片区域重新生成。地上的建筑没了,但世界至少还能继续玩。危险操作预警:--delete-*系列是货真价实的删除,不是闹着玩。执行前务必把整个存档文件夹完整复制一份(复制到桌面都行),再开始动手。项目 README 里把警告写得又大又粗,这真不是吓唬你。方案 C:服务器卡顿、怪物多到溢出python3 regionfixer.py --delete-entities --entity-limit 500 /你的存档路径白话解释:只清理单个区块里实体数量超过 500 个的区块中的怪物和掉落物,箱子里的物品、身上的装备一概不碰。实体数量上限默认是 300,大型农场服建议先调高再观察。新手最容易踩的五个坑不备份就开删。删完坏区块,回头发现连备份都没有,只能眼睁睁看着 Minecraft 重建你的家。正确做法:任何删除、替换操作前,先完整复制存档。用 Python 2 运行。工具会直接提示只支持 Python 3.x。正确做法:老老实实用python3命令。--replace-*忘了配--backups。没有备份目录,替换根本不会执行,工具会报错提示你——这不是 bug,是保护机制。删完实体发现刷怪塔空了。实体清理按数量一刀切,不分敌我。正确做法:大农场服先把--entity-limit调到 500 甚至更高,观察一阵再决定要不要收紧。备份路径填错,却以为自己修好了。扫描照常跑完,但输出里会出现 WARNING 提示没找到有效备份、一个区块都没换。别只盯着扫描完成几个字,要留意警告信息。老手都在用的四个进阶玩法玩法一:批量体检多个世界。把每个存档路径写进一个 txt 文件(每行一个,#开头的是注释),一条命令全扫:python3 regionfixer.py --text-file-input worlds.txt -l 体检报告.log玩法二:留一份体检报告。加-l 报告.log,扫描结束后所有问题(哪个区域文件、哪个区块、什么毛病)都会写进日志,方便对比修复前后的差异。注意替换操作只支持单世界,批量文件更适合做只读体检。玩法三:多进程加速。大存档动辄几万个区块,单线程扫到天荒地老,加-p 4就能用 4 个进程并行扫描,肉眼可见地变快。玩法四:不想碰命令行?有图形界面。项目自带 GUI 入口regionfixer_gui.py,开个窗口点点点也能完成扫描和修复。隐藏彩蛋:就地修复,不需要备份。如果你的问题只是缺了 Entities 标签或区块位置错位,可以用--fix-missing-tag、--fix-wrong-located这类修复选项就地修补,连备份都不用找,风险比删除低得多。写在最后Region-Fixer 不是万能的:玩家存档(.dat)这类文件损坏,它目前只能报警告、不能修;它救的也是还能读出来的问题。但作为日常体检和应急救场工具,它足够称职——先体检、再备份、最后对症下药,这套流程能救回大多数看着没救的存档。最后送你一句老玩家都懂的真理:任何修复工具都比不上一个及时的备份,定期扫描加多重备份,你的世界才能一直活下去。【免费下载链接】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），仅供参考 存档坏了先别删档!Minecraft存档修复工具 Region-Fixer,从体检到修复一次讲清
存档坏了先别删档!Minecraft存档修复工具 Region-Fixer,从体检到修复一次讲清【免费下载链接】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你按下传送键,准备向朋友炫耀刚完工的地下基地,结果落地的一瞬间整个人都麻了:脚下是老版本才有的旧地形,几米外是你新建的基地外墙,两者像两片拼错的地图硬生生挤在一起,精心铺好的铁路被拦腰截断。服务器没崩、存档没丢,但世界坏了。先按住删档的手。这种局面,大多数情况不用回档、更不用重开——一个免费开源的 Minecraft存档修复工具 Minecraft-Region-Fixer,能帮你在不碰其他数据的前提下,把坏掉的那几块单独挑出来处理。动手之前,先对照症状看看你的存档属于哪种坏不同毛病用药完全不同,先给自己做个简单诊断:进游戏报错、区块加载失败:日志里全是Error parsing chunk data之类的话——多半是区块数据损坏;地形新旧错乱、房子悬空:区块位置信息错位,数据其实还在,只是贴错了标签;服务器越来越卡、刷怪塔怪物爆满:单个区块里实体数量爆炸,快把区块挤爆了;区域文件小得离谱:整个 .mca 文件只有几 KB,像被掏空了似的。看到这些术语别慌,下面用一个大白话的比喻讲清楚。一张图看懂存档为什么坏:你的世界是一套图书馆合订本Minecraft 的世界不是一整块硬盘,而是拆成很多个 .mca 区域文件——把它们想象成图书馆里的一本本合订本,每本大概覆盖 512×512 格的范围。每一页就是一个区块(Chunk),页面里记录着地形、方块、箱子里的东西、游荡的怪物;页面上的排版内容就是 NBT 数据,相当于游戏读取世界的说明书;合订本出问题的花样不少:有的页被撕烂(区块损坏,数据读不出来),有的页装订时页码贴错(区块位置错位,内容还在但放错了地方),有的页内容多到快撑破书脊(实体过多),还有的整本书只剩个空壳(区域文件过小)。Region-Fixer 干的事,就是一本一本翻你的合订本,把烂页、错页、爆页、空壳全部标注出来,再按你的指令处理。它的扫描核心逻辑都在项目的 regionfixer_core/scan.py 里,你不用看懂代码,只要知道它能把这些病逐项报出来就够了。四步实操:拿工具、做体检、看报告、对症下药第 1 步:把工具请回家git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer python3 --version白话解释:第一行把工具源码下载到本地文件夹,第二行进入这个文件夹,第三行确认 Python 版本。这个工具只认 Python 3,版本太老会直接拒绝工作。第 2 步:先体检,只读不改python3 regionfixer.py /你的存档路径白话解释:这一条是纯体检——它会把所有 .mca 文件和 level.dat 挨个扫一遍,把问题清单列在屏幕上,全程只读,一个字节都不改。第一次使用,无论如何先跑这条,搞清楚世界到底病在哪。第 3 步:看懂报告,再选方案扫描结束后,屏幕会列出每个区域文件、每个区块的状态:Corrupted(损坏)、Wrong located(位置错位)、Too many entities(实体过多)、Sharing offset(共享偏移)、Missing Entities tag(缺实体标签)……对照下面的方案选药。第 4 步:三种常见对症方案方案 A:你有旧备份(最稳妥,相当于微创手术)python3 regionfixer.py --backups /备份路径 --replace-corrupted /你的存档路径白话解释:让工具去备份里找对应的那一页,把存档中损坏的页替换掉,其余部分原封不动。注意替换必须配合备份目录,否则工具会直接报错提醒你。方案 B:没有备份(删掉坏页,让游戏重新生成)python3 regionfixer.py --delete-corrupted /你的存档路径白话解释:把坏区块标记成待重建,下次进游戏 Minecraft 会自动把这片区域重新生成。地上的建筑没了,但世界至少还能继续玩。危险操作预警:--delete-*系列是货真价实的删除,不是闹着玩。执行前务必把整个存档文件夹完整复制一份(复制到桌面都行),再开始动手。项目 README 里把警告写得又大又粗,这真不是吓唬你。方案 C:服务器卡顿、怪物多到溢出python3 regionfixer.py --delete-entities --entity-limit 500 /你的存档路径白话解释:只清理单个区块里实体数量超过 500 个的区块中的怪物和掉落物,箱子里的物品、身上的装备一概不碰。实体数量上限默认是 300,大型农场服建议先调高再观察。新手最容易踩的五个坑不备份就开删。删完坏区块,回头发现连备份都没有,只能眼睁睁看着 Minecraft 重建你的家。正确做法:任何删除、替换操作前,先完整复制存档。用 Python 2 运行。工具会直接提示只支持 Python 3.x。正确做法:老老实实用python3命令。--replace-*忘了配--backups。没有备份目录,替换根本不会执行,工具会报错提示你——这不是 bug,是保护机制。删完实体发现刷怪塔空了。实体清理按数量一刀切,不分敌我。正确做法:大农场服先把--entity-limit调到 500 甚至更高,观察一阵再决定要不要收紧。备份路径填错,却以为自己修好了。扫描照常跑完,但输出里会出现 WARNING 提示没找到有效备份、一个区块都没换。别只盯着扫描完成几个字,要留意警告信息。老手都在用的四个进阶玩法玩法一:批量体检多个世界。把每个存档路径写进一个 txt 文件(每行一个,#开头的是注释),一条命令全扫:python3 regionfixer.py --text-file-input worlds.txt -l 体检报告.log玩法二:留一份体检报告。加-l 报告.log,扫描结束后所有问题(哪个区域文件、哪个区块、什么毛病)都会写进日志,方便对比修复前后的差异。注意替换操作只支持单世界,批量文件更适合做只读体检。玩法三:多进程加速。大存档动辄几万个区块,单线程扫到天荒地老,加-p 4就能用 4 个进程并行扫描,肉眼可见地变快。玩法四:不想碰命令行?有图形界面。项目自带 GUI 入口regionfixer_gui.py,开个窗口点点点也能完成扫描和修复。隐藏彩蛋:就地修复,不需要备份。如果你的问题只是缺了 Entities 标签或区块位置错位,可以用--fix-missing-tag、--fix-wrong-located这类修复选项就地修补,连备份都不用找,风险比删除低得多。写在最后Region-Fixer 不是万能的:玩家存档(.dat)这类文件损坏,它目前只能报警告、不能修;它救的也是还能读出来的问题。但作为日常体检和应急救场工具,它足够称职——先体检、再备份、最后对症下药,这套流程能救回大多数看着没救的存档。最后送你一句老玩家都懂的真理:任何修复工具都比不上一个及时的备份,定期扫描加多重备份,你的世界才能一直活下去。【免费下载链接】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），仅供参考