home products documents terms contact shop (coming soon!)

GUI Customization

Customize menu appearance, borders, and button layouts.

Make your ranked menus look unique. Customize borders, materials, and layouts.

GUI Files

Edit files in config/cobbleranked/gui/:

FilePurpose
ranked_gui.json5Ranked battle menu
casual_gui.json5Casual battle menu
leaderboard_gui.json5Top players display
blacklist_gui.json5Banned content viewer
reward_gui.json5Season and milestone rewards
missions_gui.json5Daily/weekly missions display
ready_gui.json5Match ready confirmation

Border & Fill

Customize the glass panels that fill empty slots:

{
  "border": {
    "enabled": true,
    "material": "GRAY_STAINED_GLASS_PANE",
    "displayname": " "
  },
  "fill": {
    "enabled": false,
    "material": "BLACK_STAINED_GLASS_PANE",
    "displayname": " "
  }
}
PropertyDescription
enabledShow/hide the border or fill
materialItem ID (Minecraft or Cobblemon)
displaynameItem name (use " " for blank)
custom_model_dataCustom model ID for resource pack

Custom Model Data

Apply custom resource pack models to any GUI element:

{
  "buttons": {
    "leaderboard": {
      "slot": 41,
      "material": "cobblemon:kings_rock",
      "displayname": "ranked_gui_leaderboard_button",
      "custom_model_data": 1001
    }
  }
}
Creating a resource pack with custom models

See Minecraft Wiki: Custom Model Data for creating resource packs.

Available Materials

Glass panes (most common):

  • WHITE_STAINED_GLASS_PANE, ORANGE_STAINED_GLASS_PANE, MAGENTA_STAINED_GLASS_PANE
  • LIGHT_BLUE_STAINED_GLASS_PANE, YELLOW_STAINED_GLASS_PENE, LIME_STAINED_GLASS_PANE
  • PINK_STAINED_GLASS_PANE, GRAY_STAINED_GLASS_PANE, LIGHT_GRAY_STAINED_GLASS_PANE
  • CYAN_STAINED_GLASS_PANE, PURPLE_STAINED_GLASS_PANE, BLUE_STAINED_GLASS_PANE
  • BROWN_STAINED_GLASS_PANE, GREEN_STAINED_GLASS_PANE, RED_STAINED_GLASS_PANE
  • BLACK_STAINED_GLASS_PANE

Other decorative items:

  • BARRIER, AIR, STONE, DIRT

Use any Minecraft or Cobblemon item ID.

Ranked GUI

Format buttons and navigation:

{
  "title": "ranked_gui_title",
  "rows": 6,
  "player_info_slot": 5,

  "format_slots": [21, 23, 25],

  "format_buttons": {
    "singles": {
      "slot": 21,
      "material": "minecraft:iron_sword",
      "displayname": "ranked_gui_format_title",
      "custom_model_data": 0
    },
    "doubles": {
      "slot": 23,
      "material": "minecraft:diamond_sword",
      "displayname": "ranked_gui_format_title",
      "custom_model_data": 0
    },
    "triples": {
      "slot": 25,
      "material": "minecraft:netherite_sword",
      "displayname": "ranked_gui_format_title",
      "custom_model_data": 0
    }
  },

  "buttons": {
    "blacklist": { "slot": 38, "material": "BARRIER" },
    "leaderboard": { "slot": 41, "material": "cobblemon:kings_rock" },
    "rewards": { "slot": 44, "material": "CHEST" }
  }
}
PropertyDescription
player_info_slotSlot showing player’s ELO and stats
format_slotsSlots for format selection buttons
format_buttonsPer-format button configuration
buttonsNavigation and action buttons

Leaderboard GUI

Pyramid layout for top 16 players:

{
  "pyramid_slots": {
    "rank_1": [14],
    "rank_2_4": [22, 23, 24],
    "rank_5_9": [30, 31, 32, 33, 34],
    "rank_10_16": [38, 39, 40, 41, 42, 43, 44]
  },

  "buttons": {
    "player_rank": {
      "slot": 47,
      "material": "PLAYER_HEAD",
      "displayname": "leaderboard_your_rank"
    }
  }
}

Blacklist GUI

Browse banned Pokemon, moves, items, abilities:

{
  "content_slots": [
    11, 12, 13, 14, 15, 16, 17,
    20, 21, 22, 23, 24, 25, 26,
    29, 30, 31, 32, 33, 34, 35,
    38, 39, 40, 41, 42, 43, 44
  ],

  "buttons": {
    "category_selector": { "slot": 48 },
    "prev_page": { "slot": 49 },
    "format_toggle": { "slot": 50 },
    "next_page": { "slot": 51 },
    "sort": { "slot": 52 }
  }
}

Slot Reference

6-row GUI (54 slots):

RowSlots
11-9
210-18
319-27
428-36
537-45
646-54

Hot Reload

Apply changes without restart:

/rankedadmin reload

See Also: Language Configuration - Customize text and colors