Commands & permissions

⌨️ Commands

All commands use the /rank base (aliased as /ranks).

Player Commands

Admin Commands

Command Examples

# Player ranks up
/rank up

# Admin views Steve's rank info
/rank debug     # (run as Steve, or use /rank set to inspect)

# Admin sets Steve's rank
/rank set Steve Veteran

# Admin force-sets rank without checking requirements
/rank force Steve Elite

# Admin waives a single requirement for Steve (e.g. he's grinding playtime elsewhere)
/rank bypassreq Steve playtime

# Admin resets Steve to the default rank
/rank reset Steve

# Admin gives Steve 500 tracked XP
/rank xp add Steve 500

# Admin creates a new rank
/rank create
/rank create Builder

# Admin deletes a rank
/rank delete Builder

# Reload config and ranks after editing files
/rank reload

🔑 Permissions

Player Permissions

Administrator Permissions

Wildcard Permissions

Quest Integration Permission

Quest requirements are gated behind a special permission pattern:

rankforge.quest.completed.<questId>

When a player completes a quest, your quest plugin should grant this permission. RankForge checks it automatically when evaluating the required-quests field.

# Grant a completed quest via LuckPerms
/lp user Steve permission set rankforge.quest.completed.first_quest true

🏅 Managing Ranks

Creating a Rank

Method 1 — In-game editor (recommended):

/rank create

RankForge will prompt you via chat to type the rank ID. You can also provide the ID directly:

/rank create Builder

The new rank is opened immediately in the RankDetailEditorGUI for further configuration.

Method 2 — Edit ranks.yml directly:

Add a new entry to ranks.yml, then run /rank reload.

Editing a Rank

Open the admin GUI:

/rank editor
/rank editor Veteran    ← edit a specific rank directly

Or edit ranks.yml and run /rank reload.

Deleting a Rank

/rank delete Veteran

RankForge will ask you to confirm by typing yes. This action is irreversible — players whose current rank is deleted will be automatically repaired to the default rank on their next join.

Waiving a Single Requirement

Sometimes a player has earned a requirement through means RankForge can't see directly — a giveaway, a support ticket, or a manual balance adjustment on another system. Rather than force-setting their whole rank, use:

/rank bypassreq Steve money

This marks just the money requirement as satisfied for Steve on his current rank; every other requirement is still checked normally. The bypass is saved to Steve's player data record, so it persists across reloads and reconnects, and is automatically cleared the moment he actually ranks up (or if his data is reset from the Player Data Editor GUI).

Reordering Ranks in the GUI

/rank editor drag

Opens the drag-and-drop slot editor. Click and drag rank icons to change their GUI slot positions. Changes are saved automatically with a debounced write (no save spam).