Jochem Veerman

Wiki

EliteFreeRanks

EliteFreeRanks is een ranks-plugin waarmee spelers gratis ranks kunnen claimen op basis van permissies, playtime of andere voorwaarden.

v1.0.4 Java 21 Paper/Spigot 1.21+ LuckPerms

Ranks

Automatische of handmatige rank-upgrades op basis van ingestelde voorwaarden.

Config

Rankpaden, limieten en cooldowns volledig instelbaar via config.yml.

Berichten

Alle feedback, foutmeldingen en rank-up berichten zijn aanpasbaar via messages.yml.

Integratie

Werkt samen met LuckPerms en PlaceholderAPI voor serverbrede rankweergave.

Installatie

  1. 1. Plaats de plugin-jar in plugins/.
  2. 2. Zorg dat LuckPerms geinstalleerd is en actief draait.
  3. 3. Start de server eenmalig om config-bestanden te genereren.
  4. 4. Pas plugins/EliteFreeRanks/config.yml en messages.yml aan.
  5. 5. Herstart de server.

Maven build

mvn clean package

Output: target/EliteFreeRanks-1.0.4.jar

Vereisten

  • Java 21
  • Paper/Spigot 1.21+
  • LuckPerms
  • PlaceholderAPI (voor placeholders)

Belangrijke Config Keys

  • rank-paths
  • claim.cooldown-seconds
  • claim.requirements
  • messages-prefix

Commands en permissies

Speler

  • /freerank -> elitefreeranks.command.freerank
  • /freerank claim -> elitefreeranks.command.claim
  • /freerank status -> elitefreeranks.command.status

Admin

  • /freerankadmin reload -> elitefreeranks.command.admin
  • /freerankadmin give <speler> <rank> -> elitefreeranks.command.admin
  • /freerankadmin reset <speler> -> elitefreeranks.command.admin

PlaceholderAPI

  • %elitefreeranks_current_rank%
  • %elitefreeranks_next_rank%
  • %elitefreeranks_claim_available%
  • %elitefreeranks_cooldown_remaining%

Troubleshooting

  • Geen rank bij claim: controleer of de speler permissie heeft en of het rank-pad juist staat.
  • LuckPerms fout: check of LuckPerms geladen is voor EliteFreeRanks tijdens server startup.
  • Lege placeholders: controleer PlaceholderAPI en of de EliteFreeRanks expansion actief is.