Work in progressPapyrus is under active development — expect breaking changes, incomplete features, and limited production support.
Skip to content

Branding & Compatibility

Papyrus identifies itself as Papyrus by SushiMC at runtime while remaining API-compatible with Paper plugins.

Server brand

PropertyPaperPapyrus
Display namePaperPapyrus
Brand IDpapermc:papersushimc:papyrus
Maven groupio.papermc.paperio.papermc.paper (unchanged)
Gradle modules:paper-api, :paper-serverSame names; dirs are papyrus-*
Release jarpaper-*.jarPapyrus-<mcVersion>.jar
CI / local jarpaperclip-*.jarpapyrus-paperclip-*.jar

Startup message:

text
Loading Papyrus <version> for Minecraft 26.1.2

ServerBuildInfo

Use Paper's ServerBuildInfo API instead of hard-coded brand checks:

java
import io.papermc.paper.ServerBuildInfo;

ServerBuildInfo info = ServerBuildInfo.buildInfo();

if (info.brandId().equals(ServerBuildInfo.BRAND_PAPYRUS_ID)) {
    // Papyrus-specific logic (sushimc:papyrus)
}

// Preferred for Paper-targeted plugins — works on Paper and Papyrus
if (info.isBrandCompatible(ServerBuildInfo.BRAND_PAPER_ID)) {
    // Paper-compatible server
}

Plugins that call isBrandCompatible("papermc:paper") are supported on Papyrus.

Update checker

Papyrus disables the PaperMC update checker by default (update-checker.enabled: false in new configs). Fork builds are distributed via GitHub Releases and CI.

Versioning

SchemeExampleUsed for
Minecraft / API26.1.2Jar filename, api-version in plugins
Release tagv1.0.1GitHub Releases semver
CI build26.1.2.build.<N>-stableInternal build strings

GPL/MIT · Papyrus by SushiMC