Getting started

Paper provides runnable server JARs directly from our website’s downloads page.

Click on the build number to download a file.

To run the server you will need to either create a startup script or run a command in your terminal.

You can generate a startup script using our Startup Script Generator. You can also obtain the optimized terminal command to run the server there.

If you’re just looking for a short command:

java -Xms4G -Xmx4G -jar paper.jar --nogui

Ensure you navigated your terminal to the directory of your server and that you have replaced paper.jar with the name of the JAR you have downloaded.

The amount of RAM can be set by changing the numbers in the Xmx and Xms arguments. --nogui disables Vanilla’s GUI, so you don’t get double interfaces when using the command line.

To configure your server, see the Global Configuration and Per World Configuration pages.

Updating Paper is simple! See our Update Tutorial for more information.

Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper (and CraftBukkit and Spigot) separate out each dimension of a world (nether, the end, etc.) into separate world folders.

Paper will handle this conversion for you automatically. No additional consideration is required.

Paper is a drop in replacement for both CraftBukkit and Spigot, you don’t need to make any changes.

Take a look at our Next Steps guide to get your server up and running with the best performance and features.