Migrating to or from FeatherMC

It’s simple to migrate your server to or from FeatherMC. The steps below will help you get started.

Backup your data before you start!

Before you begin, please ensure you have a full backup of your server.

See our Backup Guide for more information.

Migrating to FeatherMC

From Vanilla

When migrating to FeatherMC from Vanilla, the way worlds are stored will automatically be changed. Should you ever want to go back to Vanilla, follow the Vanilla Migration Guide closely, as manual changes will be required.

1. Stop your Vanilla server if it is running, and create a full backup.
2. Download FeatherMC from the downloads page and replace your Vanilla server JAR with your freshly downloaded FeatherMC JAR.
3. Rename the downloaded file to match the name specified in the start command.
4. Start your new FeatherMC server.

You have now successfully migrated to FeatherMC.

From Fabric/Forge

Because both Fabric and Forge use the Vanilla world directory structure, the same steps as the Vanilla Migration Guide may be used, with one caveat. If your Fabric or Forge server used mods that added new blocks, items, or other data to the game, FeatherMC will be unable to load these features.

Additionally, note that FeatherMC does not support Fabric or Forge mods. You will need to find plugin replacements. Any hybrids that attempt to support both mods and plugins are fundamentally flawed and not recommended for use.

From Spigot/CraftBukkit

Spigot and CraftBukkit modify the Vanilla world directory structure, making a direct migration as of 26.1 fundamentally impossible. If you wish to migrate from Spigot/CraftBukkit anyway, you will first need to migrate from Spigot/CraftBukkit to Vanilla, after which you can safely follow the Vanilla Migration Guide. For instructions on how to do this, please refer to the Spigot documentation.

Migrating from FeatherMC

To Vanilla

Because FeatherMC shares a similar world structure to Vanilla, all you need to do is move around some files. The following list shows which files you will need to move where. Before you move around any files, make sure your server is fully stopped.

Note

These steps assume a level-name (as set in server.properties) of world. If this is not the case for you, replace world with your level-name for all steps below.

The following files will need to be moved from world/dimensions/minecraft/overworld/data/minecraft/ into world/data/minecraft/:

• game_rules.dat
• scheduled_events.dat
• wandering_trader.dat
• weather.dat
• world_gen_settings.dat

After you have moved these files, you can now replace the FeatherMC server JAR with a Vanilla server JAR and start your Vanilla server!

To Fabric/Forge

Because both Fabric and Forge use the same directory structure for world storage as Vanilla, follow the Vanilla Migration Guide for this process. Note that neither Fabric nor Forge will support FeatherMC plugins! You will be required to find replacement mods.

To CraftBukkit or Spigot

FeatherMC does not support migration to either CraftBukkit or Spigot! While you may find success, do not reach out for support with issues you encounter and note that data loss is possible.