Skip to content
ver/1.17.1
Switch branches/tags
Code

Latest commit

Upstream has released updates that appear to apply and compile correctly

Paper Changes:
PaperMC/Paper@f75636b [ci skip] Update my name in author field (#6625)
PaperMC/Paper@d2c2b7a Implement Translatable on villager Profession (#6542)
PaperMC/Paper@9087993 Mark fish and axolotls from buckets as persistent (#6392)
PaperMC/Paper@aad7d37 Fix axolotl/fish persistence
PaperMC/Paper@6084ac3 Fix upstream nullability on entity equipment getters (#6519)
PaperMC/Paper@655cd8f Fix upstreams fix for composters and variable hoppers (#6563)
PaperMC/Paper@7ac51f9 Include slot when constructing the bukkit Attribute Modifiers (#6537)
PaperMC/Paper@caa4780 Add more component name methods (#6578)
PaperMC/Paper@9460497 Apply furnace cook speed multiplier through event (#6378)
PaperMC/Paper@f4f5a76 Fix anvil inventory events (#6157)
PaperMC/Paper@1707c10 fixes cancelling PlayerTradeEvent (#5612)
acb8a26

Git stats

Files

Permalink
Failed to load latest commit information.
Purpur

Purpur

MIT License Download from Jenkins CI CodeFactor Join us on Discord

Purpur's Stargazers BillyGalbreath's Followers Purpur Forks Purpur Watchers

Purpur is a drop-in replacement for Paper servers designed for configurability, new fun and exciting gameplay features, and performance built on top of Airplane.

Contact

Join us on Discord

Join us on Discord

Downloads

Download from Jenkins CI

Downloads can be obtained from the downloads page, the downloads API, or alternatively from Pl3x's Jenkins CI Server.

Latest build shortcut links:

Downloads API endpoints:

  • List versions of Minecraft with builds available: https://api.pl3x.net/v2/purpur
  • List builds for a version of Minecraft: https://api.pl3x.net/v2/purpur/<version>
  • Download a specific build of a specific version: https://api.pl3x.net/v2/purpur/<version>/<build>/download
  • Download the latest build for a version of Minecraft: https://api.pl3x.net/v2/purpur/<version>/latest/download

License

MIT License

All patches are licensed under the MIT license, unless otherwise noted in the patch headers.

See PaperMC/Paper, TECHNOVE/Airplane, and PaperMC/Paperweight for the license of material used by this project.

bStats

bStats Graph Data

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-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 allowing us to use their software so we can make Purpur the best it can be.

About

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 Airplane.

Topics

Resources

License