Getting Started

Requirements

Warning

With the release of Minecraft 1.17, Paper now requires Java 16 to run. If you don’t already have Java 16, it’s easy to download and install.

Paper Release

Recommended Java Version

Paper 1.8 to 1.11

Java 8

Paper 1.12 to 1.16.4

Java 11

Paper 1.16.5 and newer

Java 16

Migrating From Vanilla

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.

Migrating From CraftBukkit/Spigot

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

Getting A Server Jar

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

Click on the build number to download a file.

Running The Server

To run the server, simply start it up like any other Java application.

Open your terminal, navigate to the saved location, and then run java -Xms2G -Xmx2G -jar paper-###.jar --nogui

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

For more advanced Java tuning, see Aikar’s tuning page.

To configure your server, see the Configuration page.

Updating The Server

To update the server, first stop it safely by executing the stop command and then replace the old paperclip jar with a new one. That’s it.