Introduction. Do you have a corrupted Minecraft world that is worth it for you? This tool is a python script that tries to fix problems in region files. It can find some typical errors (corrupted chunks, wrong located chunks, too many entities problems), and can fix these errors in various ways (deleting the chunks, replacing them with a backup copy, or relocating the chunk).
This is a command line application. You have to use it in a terminal in GNU/Linux or a command line (typical MS-DOS view) in Windows. To open the command line in windows run the plication "cmd". You can find usage examples in the readme.
What does this tool do? You can read about what this tool do in the FAQ wiki page at GitHub.
What does it mean that a chunk is corrupted/is wrong-located/has entities problem? And what about a too-small region file? Please see the chunks a region problems github page.
Take some time to write a positive feedback or donate if you feel like so.
Questions, feature requests, problems, suggestions... If you have problems using region-fixer and want some help, please give some information in your post, for example:
- Operative system
- Python version (regionfixer only works on python3)
- Full command used to run it.
- Full error, everything, if possible, all the text visible until the next prompt. That means that you have to show even what you have written in the command line. Please conceal any sensitive information.
- Just in case you've got an old version, Region-Fixer version, use --version to see it
Suggestions and bugs should go to the github page:
Warning! This tool works, and has been tested with a lot of worlds, but bugs can be anywhere, so please, use it with care and make a backup of your world before using it! And use it at your own risk!
How do I execute this tool?
i have only strange *.py files... oO
Please write a more detailed usage-instruction - thnak you!
The program is a python script, the *.py files are the source code of the program, and in order to run it you need to install the python interpreter. If you are using GNU/Linux it should work out of the box. In windows you can download the interpreter at http://www.python.org/ ("Python 2.7.1 Windows Installer" in downloads). You need to run it in a terminal or a command line (see the readme for the options and usage).
I'll do a .exe for windows users in the next days (maybe this weekend?), so you can wait for the .exe if you prefer.
I would really appreciate that -> would make me able to use mods without worrying about the world beeing useless after an update :wink.gif:
Thanks in advance!
Sorry, didn't have the time for that!
Be careful! This tool fixes corrupted maps, i.e., maps that can't be read (usually because of bad headers in region file or chunks corrupted in compression). This tool won't fix a map that can be read but it has strange things inside (like mobs that minecraft don't recognize, or blocks that doesn't exist for the original minecraft).
As I understand your post you are talking about working maps but with blocks/entities/whatever that doesn't exist for the original minecraft. So I have to warn you, because these maps are not corrupted, they have inside things that minecraft doesn't know what to do with them, but they can be read without problems.
I have the python application but it's not working when doing it the way you said.
Please, tell me how are you running it. If the application print any errors paste them here.
Also, Region-Fixer doesn't work with Python version 3.x. If you are using this version try reinstalling (removing and installing) Python version 2.7.x.
Quote from elias79 »
HOW DO I RUN IT ?
Please, read the README, there are some examples on it. You need to use this in the command line.
No, this script fixes problems in the region files ( *.mcr files), at the moment it doesn't check the player saves.
Quote from borgil »
Is it possible to run it on working server (with save-off)?
I think the scanning process should be harmless (but I never tried! If you try, please, share the results)
About fixing chunks with the server running (with save-off)... I don't encourage you to try this. Though, theoretically, it should work (I think). But don't try if you don't have a backup copy of your world :tongue.gif: ... but if you try, please, share the results. Also, if the chunk is loaded in memory, and you fix it in hard drive, the hard drive copy will be replaced by the memory copy... so is going to be useless for chunks that are "near" to a player.
I've just answered you about the blank screen problem in the thread: viewtopic.php?f=17&t=299340 (sorry, I saw it a bit late)
I would really appreciate that -> would make me able to use mods without worrying about the world beeing useless after an update :biggrin.gif:
Thanks in advance!
Just added a windows executable! It's in the downloads section of GitHub. I'm not a windows user, but I tested in a old Windows XP 32 bits and works as expected.
Hi,
I have tried this several times now, but I keep getting the same error.
I use Ubuntu 11.04 and have python 2.7 set as default. Evertime I try it it gives me this error:
VirtualBox:~/Downloads/region-fixer$ python region-fixer.py /home/jari/Downloads/world/
Traceback (most recent call last):
File "region-fixer.py", line 26, in <module>
import nbt.region as region
File "/home/jari/Downloads/region-fixer/nbt/__init__.py", line 1, in <module>
from nbt import *
File "/home/jari/Downloads/region-fixer/nbt/nbt.py", line 2, in <module>
from gzip import GzipFile
File "/usr/local/lib/python2.7/gzip.py", line 9, in <module>
import zlib
ImportError: No module named zlib
BTW I am using virtual box, I don't know if this makes a difference, but i higly doubt that.
Looks like you haven't installed the zlib module. Try to install these 2 packages: zlib1g, zlib1g-dev (using sudo apt-get install zliblg zliblg-dev)
It won't even open up for me on win7 32bit. I downloaded python 2.7.1, installed it, and when I open up region fixer, a command prompt looking window opens for about a half a second saying "No world path specified" What to do?
It won't even open up for me on win7 32bit. I downloaded python 2.7.1, installed it, and when I open up region fixer, a command prompt looking window opens for about a half a second saying "No world path specified" What to do?
I've just updated the post with some more information for windows. This application is a prompt application, you need to run it in a prompt window (or command line or terminal or MS-DOS window or whatever you call it). In windows you can use one by running the application "cmd". Once there, go where the region-fixer is downloaded and if you have downloaded the source code and python write "region-fixer.py --help" to see the help, or "region-fixer.exe --help" if you have downloaded the exe version.
Hope this helps! :smile.gif:
I'm not a windows user, sorry if I don't explain myself properly.
Ok, the main problem is that most people who are trying to use this program, don't know how to run the python command promp. I myself don't know how, I have been trying to understand what all the characters mean.
It looks like you're trying to say to type in...
<location of region fixer program> <space> <python> <space> <location of world>
it also looks like there are a few shortcuts placed, such as the ~ and $ symbols. what are they here for?
But there are still some things I don't understand. How far back do I need to tell the prompt to search?
Ex
Do I need to tell it to go from computer/ Local Disk (D:) / Users / Username / desktop / randomfolder / region-fixer folder name / region-fixer.py (as the program name to be ran)
I downloaded both the python version and the windows executable, but the executable just appears and disappears quickly, there aren't really any instructions on what to do for this =/ I don't know if I need the world file to be in a specific place to get the program to even allow me to ask it anything. :sad.gif:
You can read the program help running: “python region-fixer.py --help”
So I tried to do it, but this is what I get.
Python 2.7.1 (r271:86832, Nov 27 2010, 18:3046) [MSC v.150 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information
>>> python region-fixer.py --help
File "<stdin>", line1
python region-fixer.py --help
^
SyntaxError: invalid Syntax
>>>
Ok, the main problem is that most people who are trying to use this program, don't know how to run the python command promp. I myself don't know how, I have been trying to understand what all the characters mean.
It looks like you're trying to say to type in...
<location of region fixer program> <space> <python> <space> <location of world>
it also looks like there are a few shortcuts placed, such as the ~ and $ symbols. what are they here for?
But there are still some things I don't understand. How far back do I need to tell the prompt to search?
Ex
Do I need to tell it to go from computer/ Local Disk (D:) / Users / Username / desktop / randomfolder / region-fixer folder name / region-fixer.py (as the program name to be ran)
Or can I skip all the way down to desktop?
Oh... I haven't explained myself. Region Fixer doesn't run in a python prompt, it does run in a command prompt. For windows a command prompt is the window you get when you run using the start menu Accesiories/Command Prompt. You have to install python if you want run it from the source code (i.e. you have the *.py files), if you want to use the .exe, you don't need to install python. But in both cases you don't need to run a python prompt
Hum... I guess that some usage examples for windows users would be great... The Disputed Jeans text is from a GNU/Linux command prompt, so don't get confused (I'm guessing you are a windows user).
About the how far do you need to tell the command prompt to search... it depends of where you are, which directory you are, if you write the full directory it will work. (remember you can use TAB to auto-complete in windows and GNU/Linux)
Are you double-clicking the executable? As I said before region fixer is a command prompt program, what flashes is a command prompt window with the region-fixer asking for some parameters. Please, if you are a windows user, just go your start menu then Accessories and then Command prompt. Then change the directory to the region-fixer directory, and then run the line "region-fixer.exe --help", that will print the help.
Don't hesitate to ask! And please, tell if you make it work.
Oh... I haven't explained myself. Region Fixer doesn't run in a python prompt, it does run in a command prompt. For windows a command prompt is the window you get when you run using the start menu Accesiories/Command Prompt. You have to install python if you want run it from the source code (i.e. you have the *.py files), if you want to use the .exe, you don't need to install python. But in both cases you don't need to run a python prompt
Hum... I guess that some usage examples for windows users would be great... The Disputed Jeans text is from a GNU/Linux command prompt, so don't get confused (I'm guessing you are a windows user).
About the how far do you need to tell the command prompt to search... it depends of where you are, which directory you are, if you write the full directory it will work. (remember you can use TAB to auto-complete in windows and GNU/Linux)
Are you double-clicking the executable? As I said before region fixer is a command prompt program, what flashes is a command prompt window with the region-fixer asking for some parameters. Please, if you are a windows user, just go your start menu then Accessories and then Command prompt. Then change the directory to the region-fixer directory, and then run the line "region-fixer.exe --help", that will print the help.
Don't hesitate to ask! And please, tell if you make it work.
I have now tried to install those two zlib files, but
they were already up to date. So I stoped trying to do
it in my virtual box and just used the windows version
and it worked great:) Thanks alot.
I'm glad it worked!
And thanks a lot for the windows examples! Much better in this way: from a windows user to windows users.
And thanks a lot for the windows examples! Much better in this way: from a windows user to windows users.
Ya, disputed's explanation really helped, i didn't know what i was doing wrong, you might want to update the readme and just put that in under windows users or something
actaully now i have a problem, a scanned as disputed told me how, and it says one chunk is 'wrong located'. What do i type to fix it?
Please, use the help, just write "region-fixer.exe --help".
The options to fix wrong located chunks are
"--delete-wrong-located" or "--dc" -> This will delete all the chunks that are wrong located. Yeah, it DELETES, if the chunk is not used by players (it hasn't any buildings or whatever) you will no notice anything, because Minecraft will regenerate it.
"--fix-wrong-located" or "--fw" -> Thiw will replace the wrong located chunk using one in a backup of your world. The backups are introduced by the option "--backups" or "--b"
You can use more than one backup directories simultaneously, if the first has the same chunk wrong, it will search in the next backup. To use this write the backups like this:
Introduction. Do you have a corrupted Minecraft world that is worth it for you? This tool is a python script that tries to fix problems in region files. It can find some typical errors (corrupted chunks, wrong located chunks, too many entities problems), and can fix these errors in various ways (deleting the chunks, replacing them with a backup copy, or relocating the chunk).
This is a command line application. You have to use it in a terminal in GNU/Linux or a command line (typical MS-DOS view) in Windows. To open the command line in windows run the plication "cmd". You can find usage examples in the readme.
What does this tool do? You can read about what this tool do in the FAQ wiki page at GitHub.
News
See the wiki in github.
How-to download and install region-fixer
Please refer to the github install page
Usage
Please refer to the github usage page.
What does it mean that a chunk is corrupted/is wrong-located/has entities problem? And what about a too-small region file? Please see the chunks a region problems github page.
Download
You can download the source code from github:
https://github.com/F...ft-Region-Fixer or http://adf.ly/HW8ex (link with adds, use it if you want to contribute a little)
Was Region-Fixer useful for you?
Take some time to write a positive feedback or donate if you feel like so.
Questions, feature requests, problems, suggestions... If you have problems using region-fixer and want some help, please give some information in your post, for example:
- Operative system
- Python version (regionfixer only works on python3)
- Full command used to run it.
- Full error, everything, if possible, all the text visible until the next prompt. That means that you have to show even what you have written in the command line. Please conceal any sensitive information.
- Just in case you've got an old version, Region-Fixer version, use --version to see it
Suggestions and bugs should go to the github page:
https://github.com/F...ft-Region-Fixer or http://adf.ly/HW8ex (link with adds, if you want to contribute a little)
Feedback and questions should go here.
Other things Coding is one of my hobbys but I also play the guitar in an internet band. Do you like alternative music? Give us a go!
http://wearethemoonwalkers.com/
I've also made a game with some friends & family. If you like old style arcade videogames, give it a go!
http://winglesslittlepeople.itch.io/you-only-get-one-match
Warning! This tool works, and has been tested with a lot of worlds, but bugs can be anywhere, so please, use it with care and make a backup of your world before using it! And use it at your own risk!
The program is a python script, the *.py files are the source code of the program, and in order to run it you need to install the python interpreter. If you are using GNU/Linux it should work out of the box. In windows you can download the interpreter at http://www.python.org/ ("Python 2.7.1 Windows Installer" in downloads). You need to run it in a terminal or a command line (see the readme for the options and usage).
I'll do a .exe for windows users in the next days (maybe this weekend?), so you can wait for the .exe if you prefer.
Hope this helps!
Sorry, didn't have the time for that!
Be careful! This tool fixes corrupted maps, i.e., maps that can't be read (usually because of bad headers in region file or chunks corrupted in compression). This tool won't fix a map that can be read but it has strange things inside (like mobs that minecraft don't recognize, or blocks that doesn't exist for the original minecraft).
As I understand your post you are talking about working maps but with blocks/entities/whatever that doesn't exist for the original minecraft. So I have to warn you, because these maps are not corrupted, they have inside things that minecraft doesn't know what to do with them, but they can be read without problems.
Don't hesitate to ask.
Please, tell me how are you running it. If the application print any errors paste them here.
Also, Region-Fixer doesn't work with Python version 3.x. If you are using this version try reinstalling (removing and installing) Python version 2.7.x.
Please, read the README, there are some examples on it. You need to use this in the command line.
No, this script fixes problems in the region files ( *.mcr files), at the moment it doesn't check the player saves.
I think the scanning process should be harmless (but I never tried! If you try, please, share the results)
About fixing chunks with the server running (with save-off)... I don't encourage you to try this. Though, theoretically, it should work (I think). But don't try if you don't have a backup copy of your world :tongue.gif: ... but if you try, please, share the results. Also, if the chunk is loaded in memory, and you fix it in hard drive, the hard drive copy will be replaced by the memory copy... so is going to be useless for chunks that are "near" to a player.
I've just answered you about the blank screen problem in the thread: viewtopic.php?f=17&t=299340 (sorry, I saw it a bit late)
Just added a windows executable! It's in the downloads section of GitHub. I'm not a windows user, but I tested in a old Windows XP 32 bits and works as expected.
Good luck!
Looks like you haven't installed the zlib module. Try to install these 2 packages: zlib1g, zlib1g-dev (using sudo apt-get install zliblg zliblg-dev)
Please, tell me if it works.
I've just updated the post with some more information for windows. This application is a prompt application, you need to run it in a prompt window (or command line or terminal or MS-DOS window or whatever you call it). In windows you can use one by running the application "cmd". Once there, go where the region-fixer is downloaded and if you have downloaded the source code and python write "region-fixer.py --help" to see the help, or "region-fixer.exe --help" if you have downloaded the exe version.
Hope this helps! :smile.gif:
I'm not a windows user, sorry if I don't explain myself properly.
Don't hesitate to ask!
From what Disputed Jeans stated --->
VirtualBox:~/Downloads/region-fixer$ python region-fixer.py /home/jari/Downloads/world/
It looks like you're trying to say to type in...
<location of region fixer program> <space> <python> <space> <location of world>
it also looks like there are a few shortcuts placed, such as the ~ and $ symbols. what are they here for?
But there are still some things I don't understand. How far back do I need to tell the prompt to search?
Ex
Do I need to tell it to go from computer/ Local Disk (D:) / Users / Username / desktop / randomfolder / region-fixer folder name / region-fixer.py (as the program name to be ran)
Or can I skip all the way down to desktop?
Readme says
So I tried to do it, but this is what I get.
anything I type in causes it to say
File "<stdin>", line1
What I said
SyntaxError: invalid syntax
Oh... I haven't explained myself. Region Fixer doesn't run in a python prompt, it does run in a command prompt. For windows a command prompt is the window you get when you run using the start menu Accesiories/Command Prompt. You have to install python if you want run it from the source code (i.e. you have the *.py files), if you want to use the .exe, you don't need to install python. But in both cases you don't need to run a python prompt
Hum... I guess that some usage examples for windows users would be great... The Disputed Jeans text is from a GNU/Linux command prompt, so don't get confused (I'm guessing you are a windows user).
About the how far do you need to tell the command prompt to search... it depends of where you are, which directory you are, if you write the full directory it will work. (remember you can use TAB to auto-complete in windows and GNU/Linux)
Are you double-clicking the executable? As I said before region fixer is a command prompt program, what flashes is a command prompt window with the region-fixer asking for some parameters. Please, if you are a windows user, just go your start menu then Accessories and then Command prompt. Then change the directory to the region-fixer directory, and then run the line "region-fixer.exe --help", that will print the help.
Don't hesitate to ask! And please, tell if you make it work.
How do I change the directory?
I'm glad it worked!
And thanks a lot for the windows examples! Much better in this way: from a windows user to windows users.
Ya, disputed's explanation really helped, i didn't know what i was doing wrong, you might want to update the readme and just put that in under windows users or something
Please, use the help, just write "region-fixer.exe --help".
The options to fix wrong located chunks are
"--delete-wrong-located" or "--dc" -> This will delete all the chunks that are wrong located. Yeah, it DELETES, if the chunk is not used by players (it hasn't any buildings or whatever) you will no notice anything, because Minecraft will regenerate it.
"--fix-wrong-located" or "--fw" -> Thiw will replace the wrong located chunk using one in a backup of your world. The backups are introduced by the option "--backups" or "--b"
Examples:
This will delete the wrong located chunks:
C:\Users\Jari\Downloads\Region-Fixer-v0.0.3 (Windows x86)\Region-Fixer-v0.0.3>re
gion-fixer.exe --delete-worng-located C:\Users\Jari\Downloads\world\world
This will replace the chunk using the backup dir C:\Users\Jari\Backups\2011.10.01-World:
C:\Users\Jari\Downloads\Region-Fixer-v0.0.3 (Windows x86)\Region-Fixer-v0.0.3>re
gion-fixer.exe --fix-worng-located --backups=C:\Users\Jari\Backups\2011.10.01-World C:\Users\Jari\Downloads\world\world
You can use more than one backup directories simultaneously, if the first has the same chunk wrong, it will search in the next backup. To use this write the backups like this:
"--backups=C:\Users\Jari\Backups\2011.10.01-World,C:\Users\Jari\Backups\2011.10.05-World,C:\Users\Jari\Backups\2011.10.10-World"
Hope this helps!
Yes, the program works in this way at the moment. (maybe I should call the option "--replace-wrong-located")
Actually wrong located chunks can be fixed much more elegantly, but is not implemented yet.