High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Josh Roy 18fabc08d5
Remove CraftItemStack#setAmount null assignment (#8807)
3 days ago
.github [ci skip] Automatically close PRs from master branches on opening (#8779) 3 weeks ago
Paper-MojangAPI Improve MojangAPI docs and replace @Deprecated with @ApiStatus.Experimental on draft APIs (#8261) 6 months ago
build-data update reobf-mappings-patch.tiny 2 months ago
gradle/wrapper [ci skip] Thank you gradle, very cool 2 months ago
licenses [ci skip] add missing final newline (#8659) 2 months ago
patches Remove CraftItemStack#setAmount null assignment (#8807) 3 days ago
scripts Updated Upstream (Bukkit/CraftBukkit) (#8172) 6 months ago
test-plugin Don't send itemmeta for books with the hide option enabled (#7734) 9 months ago
work Updated Upstream (Bukkit/CraftBukkit) 3 weeks ago
.editorconfig Move to configurate for paper.yml (#7609) 8 months ago
.gitattributes Fix patch, fix .gitattributes file name 2 years ago
.gitignore [ci skip] Add .fleet/ folder to .gitignore (#8574) 2 months ago
.gitmodules Remove Paperclip submodule 2 years ago
CONTRIBUTING.md Moving ATs from the at file to individual patches (#8573) 2 months ago
LICENSE.md Fix preemptive connection dropping during shutdown process (#8546) 2 months ago
README.md [ci skip] Fix readme badge (#8693) 1 month ago
build.gradle.kts [ci skip] Update paperweight to 1.4.1 3 weeks ago
gradle.properties API patches 2 months ago
gradlew [ci skip] Thank you gradle, very cool 2 months ago
gradlew.bat [ci skip] Thank you gradle, very cool 2 months ago
settings.gradle.kts [ci skip] Allow .git to be a regular file (#8631) 2 months ago

README.md

Paper Paper Build Status Discord GitHub Sponsors Open Collective

High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies.

Support and Project Discussion:

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.

Run the Paperclip jar directly from your server. Just like old times

How To (Plugin Developers)

  • See our API patches here
  • See upcoming, pending, and recently added API here
  • Paper API javadocs here: papermc.io/javadocs
  • Maven Repo (for paper-api):
<repository>
    <id>papermc</id>
    <url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
  • Artifact Information:
<dependency>
    <groupId>io.papermc.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.19.3-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Or alternatively, with Gradle:

  • Repository:
repositories {
    maven {
        url = uri("https://repo.papermc.io/repository/maven-public/")
    }
}

dependencies {
    compileOnly("io.papermc.paper:paper-api:1.19.3-R0.1-SNAPSHOT")
}

java {
    toolchain.languageVersion.set(JavaLanguageVersion.of(17))
}

How To (Compiling Jar From Source)

To compile Paper, you need JDK 17 and an internet connection.

Clone this repo, run ./gradlew applyPatches, then ./gradlew createReobfBundlerJar from your terminal. You can find the compiled jar in the project root's build/libs directory.

To get a full list of tasks, run ./gradlew tasks.

How To (Pull Request)

See Contributing

Support Us

First of all, thank you for considering helping out, we really appreciate that!

PaperMC has various recurring expenses, mostly related to infrastructure. Paper uses Open Collective via the Open Source Collective fiscal host to manage expenses. Open Collective allows us to be extremely transparent, so you can always see how your donations are used. You can read more about financially supporting PaperMC on our website.

You can find our collective here, or you can donate via GitHub Sponsors here, which will also go towards the collective.

Special Thanks To:

YourKit-Logo

YourKit, makers of the outstanding java profiler, support open source projects of all kinds with their full featured Java and .NET application profilers. We thank them for granting Paper an OSS license so that we can make our software the best it can be.

JetBrains, creators of the IntelliJ IDEA, supports Paper with one of their Open Source Licenses. IntelliJ IDEA is the recommended IDE for working with Paper, and most of the Paper team uses it.

All our sponsors!
Sponsor Image