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凌晨上线主世界突然多出一个地形大窟窿房子只剩半截服务器日志刷满Error parsing chunk data两年心血悬在一线。Minecraft-Region-Fixer 就是冲着这种情况来的免费开源存档修复工具它整档扫描区域文件把坏掉的区块挑出来只动坏块其余数据一概不碰。 先对号入座这是不是你能处理的毛病损坏症状可能原因本工具能否处理某片地形消失、房子悬空其余区域正常单个.mca区域文件里的区块损坏能替换、删除或抢救日志反复出现Error parsing chunk data区块 NBT 数据读不出来能扫描会定位到具体区块坐标实体标签缺失导致加载失败区块缺Entities标签能直接补上标签服务器周期性卡顿、实体数量爆炸单区块实体超标能按阈值清理实体游戏启动直接崩溃、存档目录整个丢失level.dat或.dat文件损坏、误删帮不上这类只能告警游戏根本打不开、存档目录消失的情况超出本工具的射程本文不展开。 它是怎么看出毛病的把一次修复想象成看牙X 光片本身不替你拔牙它只负责把问题照得一清二楚——是隐裂、错位还是蛀洞片子上一目了然然后再由你决定治疗方案。Minecraft-Region-Fixer 对存档干的就是这件事逐文件逐区块地读把每一处异常照出来。核心扫描逻辑就放在仓库的 regionfixer_core/scan.py 里官方说明见 README.rst。存档里的概念对应到看牙.mca区域文件一颗牙齿约 512×512 格世界区块Chunk一层牙质16×16 格的地形数据NBT 数据神经游戏真正要读的内容损坏区块隐裂照出来了但神经可能已坏透位置错乱 / 共享偏移错颌牙齿长到了不该在的位置实体超标 / 缺实体标签蛀洞 / 漏做的根管记录️ 修复命令怎么选四条路线对号入座先把工具拿回来依赖库仓库里已打包齐全git clone https://gitcode.com/gh_mirrors/mi/Minecraft-Region-Fixer cd Minecraft-Region-Fixer说白了把代码下载到本地并进目录nbt、progressbar 等依赖都已随仓库打包不需要额外安装。无论走哪条路线第一条命令永远相同——只读扫描不改任何数据python3 regionfixer.py /你的存档路径说白了扫描该存档下所有.mca文件和level.dat输出一份坏块清单不写入任何东西首次使用务必先跑这一步想看全部参数就跑python3 regionfixer.py --help。有旧备份替换路线适用场景出事前做过备份的服务器或单人生存档。python3 regionfixer.py --backups /备份目录 --replace-corrupted /你的存档路径说白了--backups指向旧存档备份多个目录用逗号分隔逗号后不要加空格工具从备份中把同一坐标的完好区块拷回来覆盖坏块只写损坏区块其余一个字节都不动。⚠️ 红线替换路线一次只能扫一个世界备份目录必须指向有效的存档文件夹否则一个块都换不成。没备份切除路线适用场景没有任何备份只想让存档重新能开。python3 regionfixer.py --delete-corrupted /你的存档路径说白了清空损坏区块的数据并把位置标为待生成下次进游戏 Minecraft 会重新长出一片新地形只删坏块不碰健康区块。代价这一跑那片区域的建筑就没了。想保住建筑只有替换路线一条路。数据没坏透温和抢救路线适用场景扫描报告里是损坏但能读出部分信息区块存错了位置缺实体标签这三类而不是彻底乱码。python3 regionfixer.py --fix-corrupted --fix-wrong-located --fix-missing-tag /你的存档路径说白了--fix-corrupted尽量从坏数据里榨出可用信息--fix-wrong-located把区块挪回它数据里记录的坐标--fix-missing-tag给缺标签的区块补上Entities标签。红线抢救只能尽力而为坏透的数据救不回来跑之前先确认备份是新的。实体爆满清仓路线适用场景农场服或刷怪塔服单区块实体堆到几百上千服务器开始周期性卡顿。python3 regionfixer.py --delete-entities --entity-limit 500 /你的存档路径说白了清空单区块实体数超过阈值的区块里所有实体默认阈值是 300只删地上的怪和掉落物箱子里的物品一根手指都不碰。代价该区块所有生物和掉落物清零刷怪塔的库存一并消失。 动手前先回答这几个问题什么时候做备份任何带--delete-*或--replace-*的命令跑起来之前把整个存档文件夹原样复制一份哪怕只拷到桌面。README 里这句警告写得很重MAKE A BACKUP OF YOUR WORLD BEFORE RUNNING it。Python 版本有要求吗工具只认 Python 3.x用 Python 2 启动会直接提示 only works with python 3.x 并退出换成python3命令即可。哪些参数必须成对使用--replace-corrupted必须搭配--backups少一个程序会直接报错拒绝执行——这是保护机制不是 bug。反过来--backups单独出现、不带任何--replace-*选项同样会被拦下。备份路径填错了怎么识别扫描会正常跑完但输出里出现[WARNING] No valid backup directories found最终替换数为 0。别只盯扫描完成盯这句警告和替换计数。实体阈值怎么定默认 300--entity-limit。有刷怪塔、大型农场的服先调到 500 跑一遍观察报告再决定别一上来就用默认值清全场。⚡ 再往前一步批量体检多个世界把每个存档路径写进一个 txt每行一个路径#开头是注释支持通配符然后python3 regionfixer.py --text-file-input worlds.txt --replace-corrupted --backups /备份目录说白了一条命令扫完列表里的所有世界并执行替换省去逐个敲路径。留一份可对比的报告加-l 报告.log每个坏块的区域文件名、区块坐标、毛病类型都会落盘名字写-就在屏幕末尾直接打印。注意-l不能和--replace-*、--delete-*同时使用。大存档提速-p 4让 4 个进程并行扫描几万区块的世界肉眼可见地变快默认是 1单进程。不想敲命令跑python3 regionfixer.py之外的图形版python3 regionfixer_gui.py基于 wxPython 的窗口界面能完成同样的扫描与修复操作需要另外安装 wxPython。局限与口诀先把丑话说完Minecraft-Region-Fixer 只修区块和区域文件这一层。level.dat或玩家.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），仅供参考