免费修复 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-FixerMinecraft-Region-Fixer 是一款免费的 Minecraft 存档修复命令行工具。它先只读扫描找出坏掉的区块再根据你的情况用旧备份替换损坏区块或删掉区块让游戏重新生成。适合游戏日志里出现 chunk、region 报错又不想删档重开的玩家和服主。它是做什么的 / 谁需要它Minecraft-Region-Fixer 能识别 5 种区块问题和 3 种区域文件问题核心能力如下只读扫描体检扫描存档下所有.mca文件包括下界DIM-1和末地DIM1外加level.dat和玩家的*.dat把问题列成清单不动任何数据。用备份替换--replace-*从备份目录取出同位置的完好区块替换掉当前损坏的区块。删除坏块让游戏重建--delete-*把坏区块清空下次进游戏时 Minecraft 会自动重新生成那块地形。实体超限清理--delete-entities清空实体数量超过--entity-limit默认 300的区块里的全部实体箱子里的物品不碰。轻度抢救--fix-corrupted、--fix-wrong-located、--fix-missing-tag分别对应从损坏数据里提取可用信息把放错位置的区块挪回数据记录的坐标补上缺失的 Entities 标签。它自带一个基于 wxPython 的图形界面不想碰命令行也可以用。适合不适合日志里出现Error parsing chunk data之类报错或某片地形缺失、区块加载失败整个存档文件夹丢失或游戏本身打不开手头有旧备份只想替换损坏的几块区块其余数据原样保留需要修复level.dat或玩家.dat——它只报读不了的警告不会修服务器因某区块生物、地上物品太多而卡顿需要找回被删除区块里的建筑、箱子或物品不确定存档病在哪想做一次只读体检文件缺失、磁盘损坏这类文件系统层面的问题原理一句话讲清把一个.mca区域文件想成一栋公寓的目录台账文件开头的表格里给 1024 户住户区块各记了一个房间起始位置游戏照着台账开门取数。所谓损坏多半就是台账和实际对不上——户号指向了错房间Wrong located、两户共享同一个门Sharing offset、或者房间里的东西已经糊成一团读不出来Corrupted。这个工具相当于一个巡检管家先顺着台账把整栋楼查一遍、标出每一处对不上的地方然后听你的——要么翻出你保留的旧台账备份把正确信息抄回来要么把问题住户的档案注销交给物业游戏重新装修。核心检查逻辑写在 regionfixer_core/scan.py区域文件的解析规则在 nbt/region.py。从零上手第一步克隆项目并确认 Python 版本git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer python3 --version第一行把项目下到本地第二行进入目录第三行确认你的 Python 是 3.x。程序里写死了版本检查如果你用 Python 2 运行它会直接提示only works with python 3.x并退出。依赖的 nbt、progressbar 等库都随仓库打包好了克隆完就能跑不用单独安装。第二步跑第一条命令只做体检python3 regionfixer.py /你的存档路径这条命令只读不写。/你的存档路径是包含level.dat的世界文件夹也可以直接给一个或多个.mca文件。扫描结束后它会打印每个世界里各类问题的区块数一个问题都没有就说明存档是干净的。想看全部参数随时运行python3 regionfixer.py --help。按你的情况选命令动手前先记住一条README 的警告是用大写写的——运行任何会改数据的命令之前先把整个存档文件夹复制一份。你遇到的情况命令代价 / 影响日志报区块损坏且你有旧备份python3 regionfixer.py --backups /备份目录 --replace-corrupted /存档路径只替换损坏区块其余数据不动工具不核对备份是否同一个世界指错了备份就会照换不误日志报区块损坏没有备份python3 regionfixer.py --delete-corrupted /存档路径坏区块被删除下次进游戏该区域重新生成里面的建筑和物品会丢某区块生物、地上物品太多导致卡顿python3 regionfixer.py --delete-entities --entity-limit 300 /存档路径超过阈值的区块清空全部实体主要是生物和地上物品箱子里的东西和结构不受影响扫描结果里出现 Wrong locatedpython3 regionfixer.py --fix-wrong-located /存档路径把区块挪回它自己数据里记录的坐标一般不丢数据数据损坏但不想删先抢救python3 regionfixer.py --fix-corrupted /存档路径从损坏数据里尽量提取可用信息抢救出来的内容可能不完整定期给多个存档做体检python3 regionfixer.py --text-file-input worlds.txt -l report.log只读所有问题区域文件、区块坐标、毛病写进report.log两点约束--replace-*必须搭配--backups且一次只能处理一个世界--backups指向多个备份时用逗号分隔逗号后面不要加空格。每一类问题都有对应的--delete-*/--replace-*变体比如--replace-wrong-located完整列表以--help为准。常见问题与避坑Q运行它会不会动我的存档裸命令只给路径是纯只读只扫描和报告。只有带--delete-*、--replace-*、--fix-*参数的命令会改文件。改文件之前先备份。Q提示 Minecraft Region Fixer only works with python 3.x你用了 Python 2 运行。源码会先检查版本并拒绝执行把命令里的python换成python3再跑一次即可。Q输出里有 [WARNING] No valid backup directories found, wont fix any chunk.说明--backups给的路径不对或那个目录不是有效世界。此时工具会照常完成扫描但一个区块都不会替换。别只盯扫描完成警告行才是重点。Q加了--replace-corrupted却直接报 Error 不执行两种常见原因一是用了--replace-*却没带--backups保护机制直接报错二是--log和--replace-*、--delete-*互斥不能同时用。Q怎么把体检结果留档或接入自动化加-l report.log会把每个问题区域文件、区块坐标、毛病类型写进日志文件写成-l -则在扫描结束后直接打印在屏幕末尾。另外退出码有含义0 无问题、3 发现问题、1 崩溃、20 没有可扫描内容脚本里可以直接判断。Q--delete-entities删的是哪些东西删的是地面上超阈值的实体主要是生物和掉落的物品箱子里的物品、建筑结构一概不碰。而且它是在扫描过程中边扫边删中途停掉可以再跑不会把没扫到的区块也清了。进阶玩法并行扫描提速大存档加-p 4用 4 个进程并行扫默认是单进程。逐行输出看问题分布-v关掉进度条每个文件打印一行用字母标状态c 损坏、w 位置错、tme 实体过多、so 共享偏移、mt 缺标签。批量体检把存档路径写进一个 txt每行一个#开头算注释支持通配符再用--text-file-input传入。图形界面先装 wxPython再运行python3 regionfixer_gui.py开窗点点点也能完成扫描、查看和修复。边界与建议它做不到的事说在前面level.dat和玩家.dat读不了时只报警告不能修复README 里写明它不会检查备份是不是同一个世界指错备份照样替换区块被删除后里面的建筑、箱子、物品它找不回来只能靠你自己的备份整个存档丢失、游戏打不开这类问题不在它的射程内新版 Minecraft 对文件损坏的容忍度在提高这个工具现在最大的价值是备份替换、实体清理、以及帮你把问题找出来。一句话收尾体检只给路径动刀先备份参数按需加。【免费下载链接】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），仅供参考