325d6c39a4
Upstream has released updates that appear to apply and compile correctly Paper Changes: 871f30038 fixed kick event leave message (#4766) 0aa0a1d97 Updated Upstream (CraftBukkit) d770f71f4 Add PlayerArmSwingEvent (#5353) 23d887b2a Swapped out Vec3#distanceTo call with a Vec3#distanceToSqr call to remove calls to Math.sqrt 5ff90b938 Fix collisions during world generation (#6129) 20ff0b058 [ci skip] Add a test plugin (#6133) 416ec9898 [ci skip] Remove extra newlines at EOF (#6127) 79d7dfbbe Ensure shulker bounding box is updated (#6010) d8ad276b7 [ci skip] More badges and things to README.md (#5338) bb44da842 Fix cancelling EntityPickupItemEvent for villagers (#6091) 351a2c38b Drop no longer needed patch (#6115) 648f6078d Route sign run_command click events through normal chat logic (#6109) dafc06460 Fix MobEffectArgument#getEffect reobf 4aef0354d [ci skip] Use Java toolchain for run tasks (#6108) 144e5f7ac Add option for logging named entity deaths (#6107) b5be382d0 Add methods to `ProtoWorld` for working with `BlockState`s (#5929)
Purpur
Purpur is a drop-in replacement for Paper servers designed for configurability, new fun and exciting gameplay features, and high performance built on top of Tuinity.
Contact
Join us on Discord
Downloads
Downloads can be obtained from the downloads page, the downloads API, or alternatively, from Pl3x's Jenkins CI Server.
Latest build shortcut links:
- 1.17.1 builds 1256+
- 1.17 builds 1172-1255
- 1.16.5 builds 957-1171
- 1.16.4 builds 809-956
- 1.16.3 builds 751-808
- 1.16.2 builds 711-750
- 1.16.1 builds 608-710
- 1.15.2 builds 398-606
- 1.15.1 builds 348-397
- 1.15 builds 339-346
- 1.14.x builds 337 and below
Downloads API endpoints:
- List versions of Minecraft with builds available:
https://purpur.pl3x.net/api/v1/purpur - List builds for a version of Minecraft:
https://purpur.pl3x.net/api/v1/purpur/<version> - Download a specific build of a specific version:
https://purpur.pl3x.net/api/v1/purpur/<version>/<build>/download - Download the latest build for a version of Minecraft:
https://purpur.pl3x.net/api/v1/purpur/<version>/latest/download
License
All patches are licensed under the MIT license, unless otherwise noted in the patch headers.
See PaperMC/Paper, Tuinity/Tuinity, and jpenilla/Toothpick for the license of material used by this project.
bStats
API
Javadoc
Dependency Information
Maven
<repository>
<id>purpur</id>
<url>https://repo.pl3x.net/</url>
</repository>
<dependency>
<groupId>net.pl3x.purpur</groupId>
<artifactId>purpur-api</artifactId>
<version>1.17.1-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
Gradle
repositories {
maven("https://repo.pl3x.net/")
}
dependencies {
compileOnly("net.pl3x.purpur", "purpur-api", "1.17.1-R0.1-SNAPSHOT")
}
Yes, this also includes all API provided by Paper, Spigot, and Bukkit.
Building and setting up
Initial setup
Run the following commands in the root directory:
./gradlew applyPatches
Creating a patch
Patches are effectively just commits in either Purpur-API or Purpur-Server.
To create one, just add a commit to either repo and run ./gradlew rebuildPatches, and a
patch will be placed in the patches folder. Modifying commits will also modify its
corresponding patch file.
See CONTRIBUTING.md for more detailed information.
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.
To get a purpurclip jar, run ./gradlew paperclip.
To install the purpur-api and purpur dependencies to your local maven repo, run ./gradlew publishToMavenLocal
Special Thanks To:
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 allowing us to use their software so we can make Purpur the best it can be.