FreeRank

A Free Minecraft plugin to give the users a Free Rank for a limit amount of time based on a end date, You can configure everything in the Files or with commands in the game and you can manage if a player has claimed the reward or not and you can resset the reward to a player with Commands or in the Files

Features ↴

• One-time free rank claim per player.
• Compatibility with LuckPerms and optional hook with AquaCore.
• Confirmation GUI for claims (/freerank).
• Language system (messages/messages_en.yml and messages/messages_es.yml).
• Configurable anti-abuse (account age, time played, IP limit).
• Storage in SQLite or MySQL using storage.yml.
• Event history (claim/reset) and history query.
• Discord webhook for complaints and admin resets.
• Admin commands to refresh, view information, and reset claims.

Commands ↴

• /freerank - Open the claim GUI.
• /freerank help - Help Command Custom
• /freerank reload - Reload settings.
• /freerank reset <player|uuid> - Restart a player's claim.
• /freerank info <player|uuid> - Displays claim status information.
• /freerank history <player|uuid> [limit] - Display event history

Permission ↴

• freerank.use - Allows the use of /freerank.
• freerank.admin.reload - Allow /freerank reload.
• freerank.admin.reset - Allow /freerank reset <player|uuid>.
• freerank.admin.info - Allow /freerank info <player|uuid>.
• freerank.admin.history - Allow /freerank history <player|uuid> [limit].
• freerank.bypass.antifraud - Skip anti-abuse validations.

config-version: 1

language: "en" # en, es

claim-window:
  enabled: false
  start: "20/03/2026"
  end: "27/03/2026"
  timezone: "Europe/Jersey"

free-rank-group: leviatan
HOOK: "LuckPerms" # LUCKPERMS, AQUACORE

hooks:
  luckperms:
    use-uuid: false
    duration: "30d"
    server: "global" # global or server specified
    reason: "FreeRank"
    commands:
      - "lp user {user} parent addtemp {rank} {time}"
  aquacore:
    duration: "30d"
    server: "global" # global or server specified
    reason: "FreeRank"
    commands:
      - "setrank {player} {rank} {duration} {server} {reason}"

anti-abuse:
  enabled: true
  minimum-account-age-hours: 24
  minimum-playtime-minutes: 60
  block-same-ip: true
  max-claims-per-ip: 1
  exempt-permission: "freerank.bypass.antifraud"

gui:
  enabled: true
  size: 27
  confirm-slot: 11
  info-slot: 13
  close-slot: 15

webhook:
  enabled: false
  url: ""
  username: "FreeRank"
  avatar-url: ""
  send-on-claim: true
  send-on-admin-reset: true

Documents ↴

Coming soon for working

Support ↴

In case you have any problems you can communicate through discord. Discord`