Purpur

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.

Join us on Discord:

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

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.

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.2.build,)</version>
    <scope>provided</scope>
</dependency>

Gradle

repositories {
    maven("https://repo.purpurmc.org/snapshots")
}

dependencies {
    compileOnly("org.purpurmc.purpur:purpur-api:26.2.build.+")
}

Yes, this also includes all API provided by Paper, Spigot, and Bukkit.

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.

See CONTRIBUTING.md.

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

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.