World Repair

As a consequence of the way world creation and chunk generation work, BiomeRemap cannot remap biomes in the chunks that are initially generated on world creation. The newly-created chunks are generated before BiomeRemap can remap them. If you want them to be included in the biome remapping, they must be reset manually (and since these chunks are most likely in and around the world spawn area, you probably do want them remapped).

Similarly, existing chunks in imported worlds will not be automatically remapped by BiomeRemap. They must be reset manually.

Finally, it should go without saying, but we will anyway: Changes of this magnitude should always be performed first on a test server, in order to verify that the results meet expectations. We strongly recommend saving a server backup before installing and using any new plugin.

Initial steps, before making world repairs

• Make a backup of the server data.
• Configure BiomeRemap to remap the target world. See Configuration.
• Start the server. The logs will display the following warning, which may be safely ignored:

  [Server thread/WARN]: [BiomeRemap] World with name 'name_of_target_world' was not found

• Create the target world. For Multiverse-Core, the command is:

  mv create name_of_target_world normal -s seed

• Adjust the world settings as desired. In changes are made, remember to reload the settings. For Multiverse-Core, the command is:

  mv reload

• Stop the server.
• Save a backup of the server data.

World Repair Option 1: BiomeRemap commands

After the target world has been generated, identify the initially-created regions. These may be found in the region subdirectory of the world directory. They will be of the form world/region/r.x.z.mca.

For each region, execute

biomeremap region world x z

The commands may be executed in-game or at the console. Progress will be reported. The remapping process is CPU-intensive, and will likely result in server response lag. Ideally, it should be performed with player offline.

World Repair Option 2: Region deletion

After the target world has been generated, the initial chunks may be removed and regenerated.

This procedure must be executed while the server is stopped.

• Verify that the server is stopped, and that a backup of the server data has been saved.
• Remove all MC regions of the target world. For Linux, the command is:

  rm name_of_target_world/entities/* rm name_of_target_world/poi/* rm name_of_target_world/region/*

• Start the server. The initial chunks will be regenerated, under the influence of BiomeRemap.

❗ Caveats and warnings

The most important caveats:

• Biome remapping cannot be reversed. Always backup the server before using this plugin, and test the functionality before you use it on a production server.
• Region remapping is a cpu-intensive activity. During region remapping, TPS will drop well below levels that support interactive play. It should be performed only on a quiescent server, with no players on-line. For the best player experience, worlds should be pre-generated using tools such as Chunky or WorldBorder.