Paper requires Java 8 or newer to run. It should run fine on newer versions as well, such as Java 11, but certain plugins may have issues. Generally, LTS versions of Java are best supported, though you may have luck on newer versions.
Java 11 will be required for future releases starting with Minecraft 1.17. If you are deploying a new server, consider starting with Java 11. More information about this transition is available here.
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.
Paper is a drop in replacement for both CraftBukkit and Spigot, you don’t need to make any changes.
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, 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
--noguidisables 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.
To update the server, first stop it safely by executing the
and then replace the old paperclip jar with a new one. That’s it.