Upstream has released updates that appear to apply and compile correctly Paper Changes: PaperMC/Paper@e2c7e5cf Limit projectiles size PaperMC/Paper@ca5e948a Fix override of new item for Firework entity (#13891) PaperMC/Paper@20938c72 Set Obsolete the use of PotionMeta in Potion entities (#13892) PaperMC/Paper@76d2ac75 [ci/skip] Fix AreaEffectCloud doc comments (#13926) PaperMC/Paper@f414ba89 run generator PaperMC/Paper@9194ea20 fix duplicate goal name for cube mobs PaperMC/Paper@b0c2992a Fix "-1 releases behind" being logged for early snapshots PaperMC/Paper@46a24d6a Merge remote-tracking branch 'origin/main' into dev/26.2 PaperMC/Paper@2c0dfb53 Fix emptying sulfur cube bucket doesn't work PaperMC/Paper@b1b09191 update todo PaperMC/Paper@f23495f0 Commodore rewriting for breaking slime API change PaperMC/Paper@9a1623b3 fix tests PaperMC/Paper@611a0ab5 Update to 26.2-pre-4 PaperMC/Paper@87cc35db delegate more stuff to CraftItemStack PaperMC/Paper@8ea9659a bump built-in pack and regenerate tags PaperMC/Paper@46cc8588 fix dispense events a bit PaperMC/Paper@5c5ff5c8 remove redundant bed updates PaperMC/Paper@1b087229 Unapply hopper patch PaperMC/Paper@c600b162 skip POI cleanup when place event is cancelled for now
Purpur
Purpur is a drop-in replacement for Paper servers designed for configurability, new fun and exciting gameplay features, and performance built on top of Paper.
Contact
Join us on Discord:
Downloads
Downloads can be obtained from the downloads page or the downloads API.
Downloads API endpoints:
- List versions of Minecraft with builds available:
https://api.purpurmc.org/v2/purpur - List builds for a version of Minecraft:
https://api.purpurmc.org/v2/purpur/<version> - Download a specific build of a specific version:
https://api.purpurmc.org/v2/purpur/<version>/<build>/download - Download the latest build for a version of Minecraft:
https://api.purpurmc.org/v2/purpur/<version>/latest/download
License
All patches are licensed under the MIT license, unless otherwise noted in the patch headers.
See PaperMC/Paper, and PaperMC/Paperweight for the license of material used by this project.
bStats
API
Javadoc
Dependency Information
Maven
<repository>
<id>purpur</id>
<url>https://repo.purpurmc.org/snapshots</url>
</repository>
<dependency>
<groupId>org.purpurmc.purpur</groupId>
<artifactId>purpur-api</artifactId>
<version>[26.1.2.build,)</version>
<scope>provided</scope>
</dependency>
Gradle
repositories {
maven("https://repo.purpurmc.org/snapshots")
}
dependencies {
compileOnly("org.purpurmc.purpur:purpur-api:26.1.2.build.+")
}
Yes, this also includes all API provided by Paper, Spigot, and Bukkit.
Building and setting up
Initial setup
First, clone this repository. Do not download it.
Then run the following command in the root directory:
./gradlew applyAllPatches
The project is now ready for use in your IDE.
Creating a patch
See CONTRIBUTING.md.
Compiling
Use the command ./gradlew build to build the API and server. Compiled JARs
will be placed under purpur-api/build/libs and purpur-server/build/libs.
These JARs are not used to start a server.
To compile a server-ready purpurclip jar, run ./gradlew createMojmapBundlerJar.
To install the purpur-api and purpur dependencies to your local Maven repo, run ./gradlew publishToMavenLocal. The compiled purpurclip jar will be in purpur-server/build/libs.
Special Thanks To:
YourKitYourKit, 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 allowing us to use their software so we can make Purpur the best it can be. |
JetBrainsJetBrains, creators of the IntelliJ IDEA, supports Purpur with one of their Open Source Licenses. IntelliJ IDEA is the recommended IDE for working with Purpur, and most of the Purpur team uses it. |



