FairPerks

FairPerks helps make EssentialsX perks like god and fly suitable as donor perks by enforcing fair, EULA-friendly combat and interaction limits on Paper servers.

Instead of removing those perks entirely, FairPerks adds guardrails so they cannot be abused for PvE or PvP advantage.

Quick Start

1. Place FairPerks.jar in your server plugins/ directory.
2. Install dependency: EssentialsX.
3. Optional: install CombatLogX to enable in-combat blocking for god macro.
4. Start the server once to generate config.yml.
5. Set language in config.yml (default, NL, or your own messages_<LANG>.yml).
6. Enable only the features you want under enabled.
7. Restart and validate behavior in-game.

Requirements

• Java 21
• Paper 1.21.x
• EssentialsX (required)
• CombatLogX (optional, enables combat-aware god macro checks)

Build From Source

mvn -B package

Output jar: target/FairPerks.jar

Version Bump Workflow

Use the helper script to bump semver, commit, and tag:

scripts/bump-version.sh patch
scripts/bump-version.sh minor --push

Options:

• major|minor|patch: required bump type
• --push: push branch + tag after creating them
• --remote <name>: push/check against a remote (default: origin)

Learn More

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

Community

• Support
• Security Policy
• Code of Conduct