Command Reference

Frontier registers two top-level command trees: /ranked for ladder play and /tournament for tournament play. Two permission nodes control access: frontier.user for player commands and frontier.admin for administration.

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> <format|ladder>	Challenge a player to a match using a format or ladder.	frontier.user
/ranked announcements	Toggle receiving queue-join broadcasts from other players.	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

Queue

/ranked queue singles

Joins 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 leave

Leaves whatever queue you’re currently in. No cooldown.

Stats & History

/ranked stats
/ranked stats BriarMC singles

View 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 BriarMC

Opens a GUI with recent match results, including opponent, outcome, and rating change.

Challenges

/ranked challenge Steve singles
/ranked challenge Steve standard
/ranked announcements
/ranked accept
/ranked deny
/ranked togglechallenges

The second argument accepts either a ladder ID (resolves the ladder’s format and battle type) or a format ID from formats.conf (creates an unranked challenge using that format directly). Tab-completion suggests both format and ladder IDs.

Direct challenges bypass the queue but still enforce format validation and use the arena system. See Challenges for the full flow.

/ranked announcements toggles whether you receive the optional queue-join broadcasts emitted when queue.announcePlayerJoin = true.

Spectating

/ranked spectate Steve

Watch someone’s live match. Run /ranked spectate with no arguments to stop spectating.

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
/ranked admin import joagar [ratingScale] [importHistory]	Import data from JoagarRankedBattles SQLite database. ratingScale multiplier (default 1.0), importHistory boolean (default true).	frontier.admin

Rating Management

/ranked admin setrating Steve singles 1800
/ranked admin resetrating Steve singles

Set 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

/ranked admin forceend Steve

Immediately ends a match involving the specified player. The match is recorded as a force-end — no rating change is applied.

Ban Management

/ranked admin ban Steve 60 "Intentional disconnects"
/ranked admin ban Steve 0

Ban 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 Steve

Lifts the ban. The player must be online for this to take effect.

Arena Builder Wizard

Creating an arena is a multi-step process:

1. Run /ranked admin arena create <id> to start the wizard.
2. Stand at the first player’s spawn and run /ranked admin arena setpos1.
3. Stand at the second player’s spawn and run /ranked admin arena setpos2.
4. Stand at the spectator vantage point and run /ranked admin arena setspectator.
5. Run /ranked admin arena done to save.

Tip

If you mess up, /ranked admin arena cancel aborts the wizard without saving anything.

See Arenas for the full configuration reference.

Data Import

/ranked admin import joagar
/ranked admin import joagar 1.0 true

Import data from a JoagarRankedBattles SQLite database. The ratingScale parameter (default 1.0) multiplies imported ratings, and importHistory (default true) controls whether match history is imported alongside ratings. The base rating is auto-detected from the first configured ladder’s startRating.

Tournament Player Commands

Frontier includes a full tournament command tree under /tournament. These require the frontier.tournament permission, granted to all players by default.

Command	Description
/tournament menu	Open the tournament hub GUI
/tournament join <id>	Register for a tournament
/tournament leave <id>	Unregister from a tournament
/tournament bracket <id>	View the tournament bracket
/tournament spectate <id>	Spectate an ongoing tournament match
/tournament spectate stop	Stop spectating
/tournament camera toggle	Toggle the ML-powered cinematic camera on or off
/tournament camera rate <1-5>	Rate the current camera behavior (ML feedback)
/tournament optout <id>	Opt out of automatic spectating during finals

Tournament Admin Commands

All tournament admin commands require frontier.tournament.admin (default: op level 2).

Command	Description	Permission
/tournament admin forcestart <id>	Force-start a tournament (skip waiting for full bracket)	frontier.tournament.admin
/tournament admin pause <id>	Pause a running tournament	frontier.tournament.admin
/tournament admin unpause <id>	Resume a paused tournament	frontier.tournament.admin
/tournament admin openregistration <id>	Open registration for a tournament	frontier.tournament.admin
/tournament admin restart <id> [round]	Restart a tournament from a specific round	frontier.tournament.admin
/tournament admin resetstate <id>	Reset tournament state	frontier.tournament.admin
/tournament admin disqualify <player> <id>	Disqualify a player from a tournament	frontier.tournament.admin
/tournament admin addnpc <id> <preset_or_class> [name] [skin]	Add an NPC participant to a tournament	frontier.tournament.admin
/tournament admin autofill <id> [count]	Autofill empty slots with NPCs	frontier.tournament.admin
/tournament admin fakeregister <id> <count>	Add fake players for testing	frontier.tournament.admin
/tournament admin fakeclear <id>	Remove fake players	frontier.tournament.admin