Repolode
PaperMC

PaperMC/Paper

A high-performance Minecraft server software, forked from Spigot, that fixes gameplay inconsistencies and provides a plugin API.

Stars
12,794
Forks
3,560
Open issues
668
Last commit
yesterday

What is it?

Paper is a Minecraft server implementation designed to run faster than the vanilla server while fixing gameplay and mechanics inconsistencies. It runs as a single jar file (Paperclip) that server administrators download and launch like any other Java application.

For plugin developers, the project provides the paper-api library, which is published to a Maven repository and can be added to Gradle or Maven builds. Javadocs are hosted on the project site, and the API is extended over time with new features tracked on the project's GitHub boards.

The repository also includes the build instructions for compiling the server from source. This requires JDK 25 and uses Gradle tasks to apply patches and produce the Paperclip jar. Versions 1.21.3 and earlier are kept in a separate archive repository.

Key features

  • 01Runs as a single downloadable jar file (Paperclip) for easy server setup.
  • 02Provides the paper-api library for Java plugin development, available via Maven and Gradle.
  • 03Aims to fix gameplay and mechanics inconsistencies relative to vanilla Minecraft.
  • 04Can be built from source with Gradle tasks on JDK 25.

Use cases

  • Hosting a Minecraft multiplayer server that needs better performance than the vanilla server.
  • Writing Bukkit-style plugins against the Paper API.
  • Building a custom Paper server jar from source for modified deployments.

Quick start

  1. 1

    Download Paper from the downloads page

  2. 2

    Run the Paperclip jar directly from your server

Things to know

  • The metadata lists no clear license (NOASSERTION), so check the repository's license terms before use.
  • Building from source requires JDK 25.

Topics

#minecraft#minecraft-server#java#game-server#plugin-api#gradle#bukkit#minecraft-api#minecraft-performance#paper

FAQ

What is Paper?
A high-performance Minecraft server software, forked from Spigot, that fixes gameplay inconsistencies and provides a plugin API. Paper is a Minecraft server implementation designed to run faster than the vanilla server while fixing gameplay and mechanics inconsistencies. It runs as a single jar file (Paperclip) that server administrators download and launch like any other Java application.
Is Paper free to use? What license does it have?
Paper is open source under the Other license. Check the license terms before using it in commercial products.
Is Paper still maintained?
Actively maintained. The last commit to Paper was on Nov 6, 2026.
What can I use Paper for?
Hosting a Minecraft multiplayer server that needs better performance than the vanilla server. Writing Bukkit-style plugins against the Paper API. Building a custom Paper server jar from source for modified deployments.
How do I install Paper?
Download Paper from the downloads page Run the Paperclip jar directly from your server
Where can I get Paper?
The source code and installation instructions are on GitHub: https://github.com/PaperMC/Paper

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects