Using the Minecraft Region Fixer

Feb 26, 2017
Using the Minecraft Region Fixer
  • Using the Minecraft Region Fixer

    Fixing chunks, entities and miscillanious issues with your worlds

    At times Minecraft servers can have issues saving chunks causing corruption or have users that overload chunks with too many entities. Fenixin's Minecraft Region Fixer is the go-to tool to help you with these issues and more.

    Getting the Tool
    Using git you can clone Fenixin's repository on GitHub using either of these commands
    Or if you don't have or want to use git, you can download an archive at this link.

    If you are not going to use python, you can skip this step and grab the executable below.

    Running the Tool
    There are two ways of running the tool, the preferred way being the included raw python script but there is also the option of an executable windows file.

    Using python (Python 2.7.x, 3.x isn't currently supported), all you need to do is go to your cloned or extracted location of the tool and run commands along the line of
    • python <your args (see below)>
    However if you are on windows and don't want to setup python, you can use an executable provided be Fenixin (his adfly link is here) and then use
    • region-fixer.exe <your args (see below)>

    Using the Tool

    As a preface, you can get the tool to scan either a specified world (user data, chunks, etc) or just a specified region file, for example
    • python /route/to/minecraft/world
    • python /route/to/minecraft/world/region/r.0.0.mca
    Using the tool without arguments (other than the location) will just let it scan and let you know if there are any issues with your world. How ever, there are several handy flags you can use with the tool.
    • --dc ( --delete-corrupted ): This will automatically delete any corrupted chunk regions it finds
    • --backups /route/to/a/backup/world -- replace-corrupted /route/to/corrupted/world: These must be used together and can prevent chunk loss by replacing chunks with a backup you specify
    • --delete-entities (preface with --entity-limit <int> to change default of 300): This will clear out all entities in a chunk if it has more than the specified limit
    • --interactive: This allows you to choose what to do without using other flags, using a command line interface
    • --verbose ( -v ): This will show you more information relating to the problems within specific regions
    Examples of commands you can use are
    • python -v --dc /my/minecraft/world
    • python --backups /my/minecraft/backup/world --replace-corrupted /my/real/minecraft/world
    • python --entity-limit 50 --delete-entities /my/minecraft/world
    • python --interactive /my/minecraft/world

    Setting up the region fixer for Multicraft
    If you have access to the /home/minecraft/multicraft/jar directory of your Multicraft installation, you may want to set up the region fixer to fire when using the control panels built in Chunkster button.
    Following the steps provided below will achieve that goal.
    • Download the latest archived version of region-fixed from the link provided above.
    • Upload the Minecraft-Region-Fixer-master folder in the .zip to your multicraft/jar directory.
    • Rename Minecraft-Region-Fixer-master to region-fixer
    • Find the chunkster.jar.conf file in the /jar directory, open it and replace the contents with the following
    • Make any changes you want to the flags, by default this will detect and remove corrupted chunks.
    • Save the file and now the Chunkster button should run the region fixer for main world of that Multicraft server.
    With this setup, you will be able to see the progress int he console, however large worlds can take quite some time and the progress status may seem frozen for this time.
    For any reason you need the default Chunkster config, it can be found here.
  • Loading...
  • Loading...