ServerFeatures

One modular feature framework for your Paper server.

Quick Start

1. Place ServerFeatures.jar in your Paper plugins/ directory.
2. Install optional dependencies required by the features you plan to run.
3. Start the server once to generate runtime config files.
4. Enable the features you want in plugins/ServerFeatures/config.yml.
5. Use /serverfeatures list and /serverfeatures info <feature> to verify state.

Requirements

• Java 25
• Paper 26.2.build.65-beta
• Feature-dependent optional plugins:
  • DataRegistry 1.12.0
  • DataProvider 3.1.0
  • packetevents
  • PlaceholderAPI
  • other integrations (for example Vault, LuckPerms, WorldGuard) only when using related features

Build From Source

Add GitHub Packages credentials for Maven server id github in ~/.m2/settings.xml:

<settings>
  <servers>
    <server>
      <id>github</id>
      <username>YOUR_GITHUB_USERNAME</username>
      <password>YOUR_TOKEN</password>
    </server>
  </servers>
</settings>

Use a token with read:packages (and repo if package source repositories are private), then run:

./mvnw -B -ntp verify

Output jar: target/ServerFeatures.jar

Run the real Paper acceptance gate (Docker required) with:

./mvnw -B -ntp -Pplatform-acceptance verify

It boots the packaged ServerFeatures jar with DataProvider and DataRegistry, verifies their public runtime integration, and requires a clean shutdown. Set PLATFORM_ACCEPTANCE_KEEP_WORK_DIRECTORY=true to retain logs.

Learn More

• Configuration Guide
• Documentation Index
• Architecture
• Development Notes
• Testing and Quality
• Contributing

Community

• Support
• Security Policy
• Code of Conduct