Command Reference
All Frontier commands live under /ranked. Two permission nodes control access: frontier.user for player commands and frontier.admin for administration.
Player Commands
Section titled “Player Commands”These all require the frontier.user permission, which is granted to every player by default.
| Command | Description | Permission |
|---|---|---|
/ranked | Open the Frontier hub GUI. | frontier.user |
/ranked queue <ladder> | Join the matchmaking queue for a ladder. | frontier.user |
/ranked queue leave | Leave the current queue. | frontier.user |
/ranked queue | Show your current queue status. | frontier.user |
/ranked queue info | Show queue sizes for all ladders. | frontier.user |
/ranked queue info <ladder> | Show queue size for a specific ladder. | frontier.user |
/ranked stats | View your stats on the default ladder. | frontier.user |
/ranked stats <player> | View another player’s stats. | frontier.user |
/ranked stats <player> <ladder> | View stats for a specific ladder. | frontier.user |
/ranked history | View your match history. | frontier.user |
/ranked history <player> | View another player’s match history. | frontier.user |
/ranked history <player> <ladder> | View match history for a specific ladder. | frontier.user |
/ranked leaderboard | Open the leaderboard GUI. | frontier.user |
/ranked leaderboard <ladder> | Open leaderboard for a specific ladder. | frontier.user |
/ranked challenge <player> <ladder> | Challenge a player to a ranked match. | frontier.user |
/ranked accept | Accept a pending challenge. | frontier.user |
/ranked deny | Decline a pending challenge. | frontier.user |
/ranked togglechallenges | Toggle whether you can receive challenges. | frontier.user |
/ranked spectate <player> | Spectate a player’s ongoing match. | frontier.user |
/ranked spectate | Stop spectating. | frontier.user |
/ranked surrender | Forfeit the current match (displays Cobblemon’s /forfeit). | frontier.user |
/ranked queue singlesJoins the matchmaking queue for the specified ladder. Your team is validated against the ladder’s format clauses before you enter the queue — if validation fails, you can’t join.
/ranked queue leaveLeaves whatever queue you’re currently in. No cooldown.
Stats & History
Section titled “Stats & History”/ranked stats/ranked stats BriarMC singlesView your own stats or another player’s. Without arguments, shows your default-ladder stats. Add a player name and/or ladder to drill down.
/ranked history/ranked history BriarMCOpens a GUI with recent match results, including opponent, outcome, and rating change.
Challenges
Section titled “Challenges”/ranked challenge Steve singles/ranked accept/ranked deny/ranked togglechallengesDirect challenges bypass the queue but still enforce format validation and use the arena system. See Challenges for the full flow.
Spectating
Section titled “Spectating”/ranked spectate SteveWatch someone’s live match. Run /ranked spectate with no arguments to stop spectating.
Admin Commands
Section titled “Admin Commands”All admin commands require frontier.admin (default: op level 2).
| Command | Description | Permission |
|---|---|---|
/ranked reload | Hot-reload all config files from disk. | frontier.admin |
/ranked admin setrating <player> <ladder> <amount> | Set a player’s rating to a specific value. | frontier.admin |
/ranked admin resetrating <player> <ladder> | Reset a player’s rating to ladder defaults. | frontier.admin |
/ranked admin forceend <player> | Force-end a match involving a player. | frontier.admin |
/ranked admin ban <player> <duration_minutes> [reason] | Ban a player from ranked. Use 0 for permanent. | frontier.admin |
/ranked admin unban <player> | Remove a ranked ban (player must be online). | frontier.admin |
/ranked admin arena create <id> | Start the arena builder wizard. | frontier.admin |
/ranked admin arena setpos1 | Set player 1 spawn to your current position. | frontier.admin |
/ranked admin arena setpos2 | Set player 2 spawn to your current position. | frontier.admin |
/ranked admin arena setspectator | Set spectator position to your current position. | frontier.admin |
/ranked admin arena done | Save the arena being built. | frontier.admin |
/ranked admin arena cancel | Cancel the current arena builder session. | frontier.admin |
/ranked admin arena delete <id> | Delete an arena. | frontier.admin |
/ranked admin arena list | List all arenas with status and allowed ladders. | frontier.admin |
Rating Management
Section titled “Rating Management”/ranked admin setrating Steve singles 1800/ranked admin resetrating Steve singlesSet a player’s rating to an exact value, or reset it back to the ladder’s startRating default. Useful for correcting mistakes or handling disputes.
Match Management
Section titled “Match Management”/ranked admin forceend SteveImmediately ends a match involving the specified player. The match is recorded as a force-end — no rating change is applied.
Ban Management
Section titled “Ban Management”/ranked admin ban Steve 60 "Intentional disconnects"/ranked admin ban Steve 0Ban a player from all ranked queues and challenges. Duration is in minutes; 0 means permanent. The optional reason is stored and shown to the player.
/ranked admin unban SteveLifts the ban. The player must be online for this to take effect.
Arena Builder Wizard
Section titled “Arena Builder Wizard”Creating an arena is a multi-step process:
- Run
/ranked admin arena create <id>to start the wizard. - Stand at the first player’s spawn and run
/ranked admin arena setpos1. - Stand at the second player’s spawn and run
/ranked admin arena setpos2. - Stand at the spectator vantage point and run
/ranked admin arena setspectator. - Run
/ranked admin arena doneto save.
See Arenas for the full configuration reference.