Player Commands
Ranked Battles
| Command | Description | Permission |
|---|
/ranked | Open ranked battle GUI | cobbleranked.player.use |
All stats, leaderboard, and queue functions are accessible through the /ranked GUI.
Casual Battles
| Command | Description | Permission |
|---|
/casual | Open casual battle GUI | cobbleranked.player.casual.use |
/casual missions | View daily/weekly missions | cobbleranked.player.casual.use |
Battle Camera
| Command | Description | Permission |
|---|
/battlecamera toggle | Enable/disable battle camera | cobbleranked.player.use |
/battlecamera status | Show camera status | cobbleranked.player.use |
Admin Commands
All admin commands require OP level 4 or cobbleranked.admin permission.
Configuration
| Command | Description |
|---|
/rankedadmin reload | Reload configuration files |
Season Management
| Command | Description |
|---|
/rankedadmin season info | Show current season info |
/rankedadmin season rotate | Check and apply season rotation |
Arena Management
| Command | Description |
|---|
/rankedadmin setArena <name> <pos1|pos2|exit|spectator> | Set arena position |
/rankedadmin setexit | Set global exit position |
/rankedadmin teleportArena <name> | Teleport to an arena |
/rankedadmin arena status | Show all arena statuses |
/rankedadmin arena enable <name> | Enable an arena |
/rankedadmin arena disable <name> | Disable an arena |
/rankedadmin setArena <name> setcenter [radius] | Set field effect center |
/rankedadmin arena reset | Reset all arena states |
Player Management
| Command | Description |
|---|
/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 |
Queue Management
| Command | Description |
|---|
/rankedadmin queue clear | Clear all queues |
Usage Stats
| Command | Description |
|---|
/rankedadmin usage info | Show usage stats info |
/rankedadmin usage export [seasonName] | Export usage stats |
/rankedadmin usage clear <seasonName> | Clear usage stats for season |
Leaderboard Export
| Command | Description |
|---|
/rankedadmin leaderboard export [seasonName] [limit] | Export leaderboard data |
Placeholders
| Command | Description |
|---|
/rankedadmin placeholder list | List all available placeholders |
/rankedadmin placeholder clear | Clear placeholder cache |
Data Migration (v1 to v2)
Upgrade your CobbleRanked v1 data to v2. All player ELO, wins, losses, and stats are preserved.
| Command | Description |
|---|
/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
- Stop the server - Never migrate while the server is running
- Backup your data - Copy both v1 and v2 database files
- Note your v1 database location - Usually
config/cobbleranked/cobbleranked.db for SQLite
What Gets Migrated
| Data | Description |
|---|
| Player Stats | Total matches, wins, last played time |
| Format Stats | ELO, wins, losses, streaks for each format |
| Seasons | Existing 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"
| Parameter | Description |
|---|
host | MySQL server address |
db | v1 database name |
user | MySQL username |
pass | MySQL password |
season | Target 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
- Run
/rankedadmin reload to apply changes
- Check
/ranked GUI to verify player stats
- Check leaderboard to confirm rankings
Permission Nodes
Player Permissions
| Permission | Description | Default |
|---|
cobbleranked.player.use | Use /ranked and /battlecamera commands | true |
cobbleranked.player.casual.use | Use /casual command | true |
cobbleranked.player.queue.join | Join ranked queue | true |
cobbleranked.player.queue.leave | Leave ranked queue | true |
cobbleranked.player.stats.view | View own stats | true |
cobbleranked.player.leaderboard.view | View leaderboard | true |
| Permission | Description | Default |
|---|
cobbleranked.player.format.singles | Queue for Singles format | true |
cobbleranked.player.format.doubles | Queue for Doubles format | true |
cobbleranked.player.format.triples | Queue for Triples format | true |
Admin Permissions
| Permission | Description | Default |
|---|
cobbleranked.admin.* | All admin commands | op |
cobbleranked.admin.arena.* | Arena management | op |
cobbleranked.admin.config.reload | Reload configuration | op |
cobbleranked.admin.player.setelo | Set player ELO | op |
cobbleranked.admin.queue.clear | Clear queues | op |
cobbleranked.admin.season.* | Season management | op |
Bypass Permissions
| Permission | Description | Default |
|---|
cobbleranked.player.bypass.cooldown | Bypass queue cooldown | false |
cobbleranked.player.bypass.queuelimit | Bypass queue player limit | false |
Examples
/ranked
Access stats, leaderboard, and queue from the GUI.
Toggle Battle Camera
/battlecamera toggle
Admin: Set player ELO
/rankedadmin setelo Steve SINGLES 1800
Admin: View season info
/rankedadmin season info
Admin: Set up arena
/rankedadmin setArena arena1 pos1
/rankedadmin setArena arena1 pos2
See Also
