It's simple to migrate your server to or from Paper. The steps below will help you get started.
Before you begin, please ensure you have a full backup of your server.
Migrating to Paper
From CraftBukkit or Spigot
It's easy to migrate from CraftBukkit or Spigot to Paper. Follow the steps below.
- Stop your server if it is running, and create a full backup.
- Download Paper from our downloads page.
- Replace your existing server jar with your freshly downloaded Paper jar.
- Start your new server.
Paper retains full compatibility with all Spigot plugins, allowing a seamless transition.
Your new Paper server will still use
spigot.yml, only adding new configuration
If you have any issues migrating from CraftBukkit or Spigot, do not hesitate to reach out for
support on our Discord server (
When migrating to Paper 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.
- Stop your Vanilla server if it is running, and create a full backup.
- Downloads Paper from our downloads page and replace your Vanilla server jar with your freshly downloaded Paper jar.
- Start your new Paper server.
You have now successfully migrated to Paper. If you encounter any issues, do not hesitate to reach
out for support on our Discord server (
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, Paper will be unable to load these features.
Additionally, note that Paper 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 Paper
Because Paper 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 Paper store worlds.
Follow these steps to migrate from Paper to Vanilla:
These steps assume a
level-name (as set in
world. If this is not the
case for you, replace
world with your
level-name for all steps below.
- Stop your Paper server, if it is running.
- If you have already started your server with Vanilla, enter the
worldfolder and delete both the
DIM1folders. This step is only necessary should you have started your server with Vanilla.
- Copy the
/world_nether/DIM-1folder into the
- Copy the
/world_the_end/DIM1folder into the
- Delete both the
- Replace your Paper jar with a Vanilla server jar.
- Start your Vanilla server.
To CraftBukkit or Spigot
Paper does not support migration to either CraftBukkit or Spigot! While you may find success (both CraftBukkit and Spigot use the same directory structure as Paper), do not reach out for support with issues you encounter and note that data loss is possible.
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 Paper plugins! You will be required to find replacement mods.