Migrating to or from Leaves

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

DANGER

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

Migrating to Leaves

From CraftBukkit, Spigot or Paper

It's easy to migrate from CraftBukkit, Spigot or Paper to Leaves. Follow the steps below.

1. Stop your server if it is running, and create a full backup.
2. Download Leaves from our downloads page.
3. Replace your existing server jar with your freshly downloaded Leaves jar.
4. Start your new server.

Leaves retains full compatibility with all Paper plugins, allowing a seamless transition.

TIP

Your new Leaves server will still use bukkit.yml, spigot.yml, paper-global.yml and paper-world-defaults.yml.
New configuration options can be found in leaves.yml.

If you have any issues migrating from CraftBukkit, Spigot or Paper, do not hesitate to reach out for support on our Discord server (#support channel).

From Vanilla

When migrating to Leaves 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 Leaves from our downloads page and replace your Vanilla server jar with your freshly downloaded Leaves jar.
3. Start your new Leaves server.

You have now successfully migrated to Leaves. If you encounter any issues, do not hesitate to reach out for support on our Discord server (#support channel).

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, Leaves will be unable to load these features.

Additionally, note that Leaves 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.

Migrating From Leaves

To Vanilla

Because Leaves stores worlds slightly differently than Vanilla, manual work is required to migrate. If these steps are not taken, your nether and end will look like they have been reset. Don't worry! Even if this has happened, you haven't lost any data. The Vanilla server just doesn't know where to find it.

Here is a chart to show the difference between how Vanilla and Leaves store worlds.

Server Software	Overworld	Nether	End
Vanilla	/world	/world/DIM-1	/world/DIM1
Leaves	/world	/world_nether/DIM-1	/world_the_end/DIM1

Follow these steps to migrate from Leaves to Vanilla:

WARNING

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.

1. Stop your Leaves server, if it is running.
2. If you have already started your server with Vanilla, enter the world folder and delete both the DIM-1 and DIM1 folders. This step is only necessary should you have started your server with Vanilla.
3. Copy the /world_nether/DIM-1 folder into the /world folder.
4. Copy the /world_the_end/DIM1 folder into the /world folder.
5. Delete both the /world_nether and /world_the_end folders.
6. Replace your Leaves jar with a Vanilla server jar.
7. Start your Vanilla server.

To CraftBukkit, Spigot or Paper

Leaves does not support migration to each CraftBukkit, Spigot or Paper! While you may find success (all CraftBukkit, Spigot and Paper use the same directory structure as Leaves), do not reach out for support with issues you encounter and note that data loss is possible.

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 Leaves plugins! You will be required to find replacement mods.