Products Docs Help Store Discord

Commands

Complete list of CobbleRanked commands.

Player Commands

Ranked Battles

CommandDescriptionPermission
/rankedOpen ranked battle GUIcobbleranked.player.use
/ranked historyView your recent match historycobbleranked.player.history.view
/ranked history <player>View another player’s match historycobbleranked.player.history.viewothers

All stats, leaderboard, and queue functions are accessible through the /ranked GUI.

Casual Battles

CommandDescriptionPermission
/casualOpen casual battle GUIcobbleranked.player.casual.use
/casual missionsView daily/weekly missionscobbleranked.player.casual.use

Admin Commands

All admin commands require OP level 4 or cobbleranked.admin permission.

Configuration

CommandDescription
/rankedadmin reloadReload configuration files (language, presets, GUI, season/reward/mission/elo/battle YAML, and randbats data — picks up a new setsFile or local custom set file without a restart)

Season Management

CommandDescription
/rankedadmin season infoShow current season info
/rankedadmin season rotateCheck and apply season rotation
/rankedadmin season pausePause the current season (stops queue)
/rankedadmin season resumeResume a paused season

Arena Management

CommandDescription
/rankedadmin arena create <name> <pos1|pos2|exit|spectator>Set arena position
/rankedadmin arena setexit <name>Set exit position for an arena
/rankedadmin arena teleport <name>Teleport to an arena
/rankedadmin arena statusShow all arena statuses
/rankedadmin arena enable <name>Enable an arena
/rankedadmin arena disable <name>Disable an arena
/rankedadmin arena setcenter <name> [radius]Set field effect center
/rankedadmin arena resetReset all arena states

Player Management

CommandDescription
/rankedadmin setelo <player> <format> <elo>Set player’s ELO
/rankedadmin addelo <amount> <player> <format>Add ELO to player
/rankedadmin removeelo <amount> <player> <format>Remove ELO from player
/rankedadmin setflee <player> <amount>Set player’s flee count
/rankedadmin clearpenalty <player>Clear a player’s active flee/disconnect penalty (queue ban)
/rankedadmin banranked <player>Ban a player from ranked (Casual still allowed). Requires LuckPerms.
/rankedadmin unbanranked <player>Lift a ranked ban. Requires LuckPerms.

The banranked / unbanranked commands work through LuckPerms by denying the cobbleranked.player.use permission. They only sync across servers if LuckPerms uses shared storage (e.g. MySQL). See LuckPerms Integration.

Queue Management

CommandDescription
/rankedadmin queue clearClear all queues
/rankedadmin forceend [match_id]Force-end a stuck or ongoing ranked match

Placeholders

CommandDescription
/rankedadmin placeholder test <placeholder>Test a placeholder with player data
/rankedadmin placeholder listList all available placeholders
/rankedadmin placeholder clearClear placeholder cache
/rankedadmin placeholder statusShow placeholder API status

Data Management

CommandDescription
/rankedadmin usage export [seasonName]Export usage statistics for season
/rankedadmin usage clear <seasonName>Clear usage statistics for season
/rankedadmin usage infoShow usage statistics summary
/rankedadmin leaderboard export [seasonName] [limit]Export leaderboard data (default: 100 entries)
/rankedadmin api syncManually trigger API data sync
/rankedadmin api statusShow API sync status and statistics
/rankedadmin api testTest API connectivity

Data Migration (v1 to v2)

Upgrade your CobbleRanked v1 data to v2. All player ELO, wins, losses, and stats are preserved.

CommandDescription
/rankedadmin migrate sqlite <v1_db_path> <season_name>Migrate from v1 SQLite
/rankedadmin migrate mysql <host> <db> <user> <pass> <season>Migrate from v1 MySQL
/rankedadmin migrate mongodb <uri> <db> <season_name>Migrate from v1 MongoDB
/rankedadmin migrate season <v1_config_path>Migrate v1 season config
Migration Guide

Before You Start

  1. Stop the server - Never migrate while the server is running
  2. Backup your data - Copy both v1 and v2 database files
  3. Note your v1 database location - Usually config/cobbleranked/cobbleranked.db for SQLite

What Gets Migrated

DataDescription
Player StatsTotal matches, wins, last played time
Format StatsELO, wins, losses, streaks for each format
SeasonsExisting season records (if any)

📝 The <season_name> parameter assigns all migrated data to a specific season. Choose a meaningful name like "Season 1" or "Legacy".

SQLite Migration

Most common scenario - migrating from v1 SQLite to v2 SQLite:

/rankedadmin migrate sqlite "config/cobbleranked/cobbleranked.db" "Season 1"

MySQL Migration

For cross-server setups using MySQL:

/rankedadmin migrate mysql localhost cobbleranked_v1 root password "Season 1"
ParameterDescription
hostMySQL server address
dbv1 database name
userMySQL username
passMySQL password
seasonTarget season name

⚠️ Uses the same MySQL credentials for both v1 and v2. Ensure v2 database already exists.

MongoDB Migration

For MongoDB deployments:

/rankedadmin migrate mongodb "mongodb://localhost:27017" cobbleranked_v1 "Season 1"

Season Config Migration

Migrate your v1 seasons.json5 to v2 season.yaml format:

/rankedadmin migrate season "config/cobbleranked/seasons.json5"

After Migration

  1. Run /rankedadmin reload to apply changes
  2. Check /ranked GUI to verify player stats
  3. Check leaderboard to confirm rankings

Permission Nodes

Player Permissions

PermissionDescriptionDefault
cobbleranked.player.useUse /ranked commandtrue
cobbleranked.player.casual.useUse /casual commandtrue
cobbleranked.player.queue.joinJoin ranked queuetrue
cobbleranked.player.queue.leaveLeave ranked queuetrue
cobbleranked.player.stats.viewView own statstrue
cobbleranked.player.leaderboard.viewView leaderboardtrue
cobbleranked.player.history.viewView own match historytrue
cobbleranked.player.history.viewothersView others’ match historyop

Format Permissions

PermissionDescriptionDefault
cobbleranked.player.format.singlesQueue for Singles formattrue
cobbleranked.player.format.doublesQueue for Doubles formattrue
cobbleranked.player.format.triplesQueue for Triples formattrue

Admin Permissions

PermissionDescriptionDefault
cobbleranked.admin.*All admin commandsop
cobbleranked.admin.arena.*Arena managementop
cobbleranked.admin.config.reloadReload configurationop
cobbleranked.admin.player.seteloSet player ELOop
cobbleranked.admin.queue.clearClear queuesop
cobbleranked.admin.season.*Season managementop

Bypass Permissions

PermissionDescriptionDefault
cobbleranked.player.bypass.cooldownBypass queue cooldownfalse
cobbleranked.player.bypass.queuelimitBypass queue player limitfalse

Examples

Open Ranked Menu

/ranked

Access stats, leaderboard, and queue from the GUI.

Admin: Set player ELO

/rankedadmin setelo Steve SINGLES 1800

Admin: View season info

/rankedadmin season info

Admin: Set up arena

/rankedadmin arena create arena1 pos1
/rankedadmin arena create arena1 pos2

See Also