In this guide, we will show you how to migrate from 1.17.x Vanilla to 1.17.x Paper! We are going to be using a 1.17.1 vanilla server and migrate it to 1.17.1 Paper.

First Step: Stop your server and create a backup via the panel. This ensures that you have a copy of all your data.

Second Step: You will need to rearrange where your world files are located to move your server from vanilla to Paper. This will require creating two new folders named world_nether and world_the_end in the root of your server (where the world folder is located), and then moving the DIM-1 and DIM1 folders from your world folder to the folders you created.

To move the folders, the easiest method is to navigate to the world folder, first select DIM-1

Image #1

Then select the move option and put ../world_nether/DIM-1 as the destination and click move.

Image #2

This will move the nether world data to the world_nether folder.
Repeat these steps for DIM1 in the main world folder and use the move option with ../world_the_end/DIM1

Image #3
Image #4

Your file structure is now all ready for a Paper server.

Third Step: Delete the existing server.jar file on your server.

Fourth Step: You will need to download the Paper server jar for Minecraft 1.17.x from the PaperMC website. (This is the link to the download page for the server file for Paper 1.17.x The fastest way of doing this is by using our Download from URL button.

Navigate to the downloads page and under the Build column, click the top option and a jar file will start downloading (The top option is the most recent version. Paper pushes new updates almost every day, so make sure you keep your server up-to-date).

Image #5

Fifth Step: Rename the paper-1.17.x-xxx.jar to server.jar and upload it to your server. (Using SFTP is recommended, but you can also drag and drop the file on to the panel)

Image #6


Go back to the panel and click the Download from URL button and paste the link you got in.

Image #6

Click download and when it finishes you should have a new paper-117.x-xxx.jar file on your server!

Fifth step: Rename the paper-1.17.x-xxx.jar to server.jar.

Image #7

After you are done doing all of those steps, you can start your server, and you will be now on Paper 1.17.x!