PurpurMC / 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.

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>1.19.2-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Gradle

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

dependencies {
    compileOnly("org.purpurmc.purpur:purpur-api:1.19.2-R0.1-SNAPSHOT")
}

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

Building and setting up

Initial setup

Run the following command 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 createReobfPaperclipJar. To install the purpur-api and purpur dependencies to your local Maven repo, run ./gradlew publishToMavenLocal

Special Thanks To:

Our Contributors

Our Sponsors

Our Backers