Paper ![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/PaperMC/Paper/Build%20Paper/master) =========== High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies. **Support and Project Discussion:** - [IRC](https://webchat.esper.net/?channels=paper) or [Discord](https://discord.gg/papermc) How To (Server Admins) ------ Paperclip is a jar file that you can download and run just like a normal jar file. Download Paper from our [downloads page](https://papermc.io/downloads). Run the Paperclip jar directly from your server. Just like old times * Documentation on using Paper: [paper.readthedocs.io](https://paper.readthedocs.io/) * For a sneak peak on upcoming features, [see here](https://github.com/PaperMC/Paper/projects) How To (Plugin Developers) ------ * See our API patches [here](Spigot-API-Patches) * See upcoming, pending, and recently added API [here](https://github.com/PaperMC/Paper/projects/6) * Paper API javadocs here: [papermc.io/javadocs](https://papermc.io/javadocs/) * Maven Repo (for paper-api): ```xml papermc https://papermc.io/repo/repository/maven-public/ ``` * Artifact Information: ```xml io.papermc.paper paper-api 1.17-R0.1-SNAPSHOT provided ``` **Or alternatively, with Gradle:** * Repository: ```groovy repositories { maven { url 'https://papermc.io/repo/repository/maven-public/' } } ``` * Artifact: ```groovy dependencies { compileOnly 'io.papermc.paper:paper-api:1.17-R0.1-SNAPSHOT' } ``` How To (Compiling Jar From Source) ------ To compile Paper, you need JDK 16 and an internet connection. Clone this repo, run `./gradlew applyPatches`, then `./gradlew reobfJar` from your terminal. You can find the compiled jar in the `Paper-Server/build/libs` directory. To get a full list of tasks, run `./gradlew tasks`. How To (Pull Request) ------ See [Contributing](CONTRIBUTING.md) Special Thanks To: ------------- [![YourKit-Logo](https://www.yourkit.com/images/yklogo.png)](https://www.yourkit.com/) [YourKit](https://www.yourkit.com/), makers of the outstanding java profiler, support open source projects of all kinds with their full featured [Java](https://www.yourkit.com/java/profiler) and [.NET](https://www.yourkit.com/.net/profiler) application profilers. We thank them for granting Paper an OSS license so that we can make our software the best it can be. [](https://www.jetbrains.com) [JetBrains](https://www.jetbrains.com/), creators of the IntelliJ IDEA, supports Paper with one of their [Open Source Licenses](https://www.jetbrains.com/opensource/). IntelliJ IDEA is the recommended IDE for working with Paper, and most of the Paper team uses it.