救场Minecraft存档：Minecraft Region Fixer免费修复损坏区块的完整指南

救场Minecraft存档：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

凌晨一点重启服务器，打开主世界一看——半张地图像被橡皮擦啃掉了一角，整片地形消失，半截房子悬在半空，后台日志刷满Error parsing chunk data。两年的心血，差点就这么没了。免费开源的 Minecraft-Region-Fixer 就是干 Minecraft 存档修复的：它只动坏掉的区域文件（.mca）里的区块，其他数据一概不碰。

先搞清楚它是干嘛的

Minecraft Region Fixer 是一个专门用来扫描并修复 Minecraft 存档区域文件（.mca）的开源工具。

• 扫描全部 .mca 区域文件和 level.dat，把损坏、错乱、过载的区块列成清单
• 用旧备份里的完好区块替换当前存档中损坏的区块
• 删除或抢救问题区块，或按阈值清理实体过载的区块

丑话说在前头：玩家 .dat 文件和 level.dat 损坏，它只能报警告，修不了。

什么情况该请它 / 什么情况别指望

✅ 找它就对了

• 只有某片区域地形消失、区块加载失败，其余地方正常
• 服务器日志反复出现chunk、region、Error parsing之类的报错
• 某区块实体数量爆炸，整个世界掉帧卡顿

❌ 别浪费时间

• 整个存档目录不见了（先去找你的备份）
• 玩家 .dat 或 level.dat 文件损坏（只能从备份恢复）
• 存档目录完整但游戏根本打不开（查游戏安装和 Java 版本）

30 秒看懂它怎么工作

把你的存档想象成一套连载多年的漫画：每本 .mca 区域文件是一册漫画，覆盖 512×512 格；每一页是一个 16×16 格的区块；页面上的油墨是 NBT 数据。漫画放久了会页码印错、被墨水糊住、两页粘在一起。Minecraft Region Fixer 的角色就是图书修复师：先把整套书逐页翻一遍，标出所有坏页，再按你的指示替换、撕掉或抢救。这套"逐页翻查"的核心逻辑写在regionfixer_core/scan.py里。

照着做：从拿到手到问题解决

第 1 步：克隆项目，确认 Python 版本

只认 Python 3，版本太老会直接拒绝运行。

git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer python3 --version

人话版：前两行把工具拿到本地，nbt、progressbar 这些依赖都打包在仓库里，不用额外安装。第三行确认你的 Python 是 3.x，存档修复工具只在这个版本上工作。

第 2 步：先体检——只读扫描，不改任何数据

纯只读扫描，第一次用必须先跑这一步。

python3 regionfixer.py /你的存档路径

人话版：把存档下所有 .mca 文件和 level.dat 逐个翻一遍，把损坏、错乱、实体过载的区块列成清单，不碰任何数据。看不懂输出就加--help看全部参数。

第 3 步：对号入座，选一条修复路线

有备份走 A，没备份走 B，实体过载走 C，轻度损坏走 D。

路线 A：有备份——用完好区块替换

python3 regionfixer.py --backups /备份目录 --replace-corrupted /你的存档路径

人话版：从备份目录里找出同位置的完好区块，只替换当前存档里坏掉的那几页。备份多个目录用逗号分隔，中间千万别加空格，且一次只能处理一个世界。

路线 B：没备份——删掉坏块让游戏重建

python3 regionfixer.py --delete-corrupted /你的存档路径

人话版：把损坏区块删掉并标记为待生成，下次进游戏 Minecraft 会自动重建。这片区域会重新长出来，你在上面盖的建筑没了，但世界至少能打开。

路线 C：实体过载——按阈值清理

python3 regionfixer.py --delete-entities --entity-limit 300 /你的存档路径

人话版：清掉实体数量超阈值的区块里的所有实体（默认阈值 300），只动地面上的怪物和掉落物，箱子里的物品一根手指不碰。

路线 D：轻度损坏——能抢救就抢救

python3 regionfixer.py --fix-corrupted --fix-wrong-located --fix-missing-tag /你的存档路径

人话版：三个选项分别对应"从损坏数据里榨取可用信息""把位置错乱的区块挪回数据记录的坐标""给缺实体标签的区块补上标签"，比直接删温和，适合数据还没坏透的情况。

第 4 步：复扫确认修好了

修完再体检一遍，确认坏页归零。

python3 regionfixer.py /你的存档路径

人话版：同一套扫描命令再跑一次，报告里问题数量应该清零或明显下降。还有残留就回到第 3 步换路线再处理。

翻车现场实录（附解法）

• 你大概率会：备份目录路径写错，以为修好了。→ 工具照常扫描，但输出里有 "No valid backup directories" 的 WARNING，一个区块都没换。别只盯"扫描完成"，警告才是重点。
• 你大概率会：--replace-corrupted 忘了带 --backups。→ 没有备份目录替换根本不会生效，工具会直接报错拦住你——这是保护机制，不是 bug。
• 你大概率会：用 Python 2 运行。→ 会提示只支持 python 3.x，把命令里的 python 换成 python3 即可。
• 你大概率会：操作前没备份就开删。→ --delete-* 是真的会删数据，任何修复之前先把整个存档文件夹复制一份，哪怕复制到桌面。
• 你大概率会：实体阈值一刀切。→ 清理按数量阈值执行，大型农场服建议把 --entity-limit 调到 500 再观察，避免误伤正常刷怪塔。

血泪总结：任何改动数据的操作之前，先备份、再动手，永远不要跳过。

让工具跑得更快更稳

技巧 1：一次体检多个世界。把每个存档路径写进 txt 文件（每行一个，# 开头是注释），一条命令全扫：

python3 regionfixer.py --text-file-input worlds.txt --replace-corrupted --backups /备份目录

技巧 2：留一份体检报告。加-l 报告.log，扫描结束后所有问题（哪个区域文件、哪个区块坐标、什么毛病）都写进日志，方便对比修复前后；日志名写成-则直接打在屏幕末尾。

技巧 3：多进程加速。大存档动辄几万个区块，加-p 4用 4 个进程并行扫描，肉眼可见地变快。

技巧 4：不想敲命令就用图形界面。项目自带 wxPython 图形界面（需先安装 wxPython）：

python3 regionfixer_gui.py

它管不了什么

• level.dat 损坏、玩家 .dat 文件损坏：只能报警告，修不了，得自己从备份恢复。
• 不碰 .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