High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies
Go to file
Jake Potrebic 773dd72446
Updated Upstream (Bukkit/CraftBukkit) (#9739)
Upstream has released updates that appear to apply and compile correctly.
This update has not been tested by PaperMC and as with ANY update, please do your own testing

Bukkit Changes:
69c7ce23 PR-990: Use Mockito instead of InvocationHandler for test mocking
997de31d PR-893: Add a stream method to Registry to make it easier to use and to avoid unnecessary wrapping
6a8ce581 Fix malformed javadoc in previous commit
26c74f6d PR-890: Add more Sculk API (bloom, shriek, bloom event)
aa067abf PR-895: Load GameEvent and MusicInstrument from registry

CraftBukkit Changes:
78796c9de Add support for Java 21
ddc9a2dad SPIGOT-7475: Don't fire SculkBloomEvent during world generation
caee2311a PR-1245: Add a stream method to Registry to make it easier to use and to avoid unnecessary wrapping
de421cf56 PR-1242: Add more Sculk API (bloom, shriek, bloom event)
00f5a80fb PR-1252: Fix error when generating a tree in water
10219df3a PR-1248: Load GameEvent and MusicInstrument from registry
2023-09-21 18:48:55 +02:00
.github [ci skip] Add gradle wrapper validation action 2023-07-11 23:25:02 +02:00
Paper-MojangAPI Improve MojangAPI docs and replace @Deprecated with @ApiStatus.Experimental on draft APIs (#8261) 2022-08-07 13:47:43 -07:00
build-data Create raw chat type as resource file instead of in source (#9226) 2023-09-15 11:03:42 -07:00
gradle/wrapper [ci skip] Update Gradle wrapper 2023-08-21 19:16:46 +10:00
licenses [ci skip] add missing final newline (#8659) 2022-12-13 14:16:45 +01:00
patches Updated Upstream (Bukkit/CraftBukkit) (#9739) 2023-09-21 18:48:55 +02:00
scripts Updated Upstream (Bukkit/CraftBukkit) (#8172) 2022-07-22 11:18:00 -07:00
test-plugin [ci skip] clear out test plugin 2023-08-23 10:05:08 -07:00
work Updated Upstream (Bukkit/CraftBukkit) (#9739) 2023-09-21 18:48:55 +02:00
.editorconfig [ci skip] update editorconfig and gitattributes (#9608) 2023-08-22 12:16:03 +10:00
.gitattributes [ci skip] update editorconfig and gitattributes (#9608) 2023-08-22 12:16:03 +10:00
.gitignore [ci skip] Add .fleet/ folder to .gitignore (#8574) 2022-11-19 14:33:03 +01:00
.gitmodules Remove Paperclip submodule 2021-06-15 01:44:13 -05:00
CONTRIBUTING.md [ci skip] Update README and CONTRIBUTING (#8917) 2023-02-26 12:37:41 -07:00
LICENSE.md Allow non-op players to execute the click event callback (#9652) 2023-08-28 13:21:13 +02:00
README.md [ci skip] Update README 2023-08-13 10:36:26 +10:00
build.gradle.kts Create raw chat type as resource file instead of in source (#9226) 2023-09-15 11:03:42 -07:00
gradle.properties 1.20.1 (#9333) 2023-06-13 09:10:07 +02:00
gradlew [ci skip] Update Gradle wrapper 2023-08-21 19:16:46 +10:00
gradlew.bat [ci skip] Thank you gradle, very cool 2022-12-09 11:12:15 +01:00
settings.gradle.kts [ci skip] Update Gradle wrapper 2023-08-21 19:16:46 +10:00

README.md

Paper Paper Build Status Discord GitHub Sponsors Open Collective

The most widely used, high-performance Minecraft server 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)

Repository (for paper-api)

Maven
<repository>
    <id>papermc</id>
    <url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
<dependency>
    <groupId>io.papermc.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.20.1-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>
Gradle
repositories {
    maven {
        url = uri("https://repo.papermc.io/repository/maven-public/")
    }
}

dependencies {
    compileOnly("io.papermc.paper:paper-api:1.20.1-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