CleanPaper

CleanPaper is a stripped-down fork of Paper, with unnecessary features and commands removed for stability and simplicity. Paper is the most widely used, high-performance Minecraft server that aims to fix gameplay and mechanics inconsistencies. The main goal is to remove all optional built-in functionality so that the server can be fully customized through plugins based on your specific needs.

Original Paper by PaperMC. Paper is licensed under the GPLv3 license.

You can use my project CleanVelocity as a proxy server for your CleanPaper.

What was changed

• Removed telemetry, metrics (bStats), and the automatic update checker;
• Deleted commands.yml, help.yml, permissions.yml and version_history.json;
• Deleted some server messages;
• And other changes.

Download & Running

The compiled JAR file can be downloaded from the Releases section on this GitHub. Requires Java 25 or higher.

Building from Source

Requirements:

• JDK 25+
• Git

# Apply patches
./gradlew applyAllPatches

# Build the server JAR
./gradlew cleanpaper-server:createPaperclipJar

The built JAR will be located in cleanpaper-server/build/libs/.

Making Changes

1. After applyAllPatches, make your changes in the generated paper-server/ or paper-api/ source
2. Commit your changes within the respective subproject:

   cd paper-server
   git add .
   git commit -m "Description of change"
   cd ..

3. Rebuild patches:

   ./gradlew rebuildPaperPatches rebuildServerPatches

4. Commit the updated patch files to the main repository

Updating Paper

1. Update paperRef in gradle.properties to the latest Paper commit hash
2. Run ./gradlew applyAllPatches
3. Resolve any conflicts if needed
4. Run ./gradlew rebuildPatches