Bungee Status

Networks running BungeeCord or Velocity expose per-server online counts via plugin messages. AbstractMenus surfaces them as %bungee_<server>% placeholders. This menu uses them to build a “server picker” with live counts and click-to-connect tiles.

What it teaches

• The bungeeConnect action for inter-server transfer
• The %bungee_<server>% placeholder for live online counts
• Using glow: true to make a featured tile stand out (lobby in this case)
• Pairing updateInterval with bungee placeholders to keep counts fresh

intermediate

Features: bungeeConnectbungee-placeholdersupdateIntervalglow

Requires: BungeeCord

Open: /ame_servers Copy

menu.conf

# Bungee Status - server picker showing online counts via BungeeCord
# Docs: https://abstractmenus.github.io/docs/en/examples/state-and-vars/bungee-status
# Open: /ame_servers
# Requires: BungeeCord proxy (or Velocity) with named backends

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Server Selector"
size: 3
updateInterval: 40

activators {
  command: "ame_servers"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  # Lobby
  {
    slot: 10
    material: BOOKSHELF
    name: "&e&lLobby"
    lore: [
      "&7Main hub for picking modes."
      ""
      "&7Online: &e%bungee_lobby%"
      ""
      "&a> Click to connect"
    ]
    glow: true
    click {
      bungeeConnect: "lobby"
    }
  }

  # Survival
  {
    slot: 12
    material: GRASS_BLOCK
    name: "&e&lSurvival"
    lore: [
      "&7Vanilla-style survival world."
      ""
      "&7Online: &e%bungee_survival%"
      ""
      "&a> Click to connect"
    ]
    click {
      bungeeConnect: "survival"
    }
  }

  # SkyWars
  {
    slot: 14
    material: ENDER_EYE
    name: "&e&lSky Wars"
    lore: [
      "&7PvP minigame on islands."
      ""
      "&7Online: &e%bungee_sw%"
      ""
      "&a> Click to connect"
    ]
    click {
      bungeeConnect: "sw"
    }
  }

  # Build Battle
  {
    slot: 16
    material: BRICKS
    name: "&e&lBuild Battle"
    lore: [
      "&7Themed build competitions."
      ""
      "&7Online: &e%bungee_bb%"
      ""
      "&a> Click to connect"
    ]
    click {
      bungeeConnect: "bb"
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

How it works

Each tile is a regular item with one custom action: click { bungeeConnect: "lobby" }. When clicked, the plugin sends a BungeeCord transfer plugin message and the proxy sends the player to the named backend server.

The %bungee_lobby% placeholder asks the BungeeCord listener “how many players are on the lobby backend right now?” and renders the count. With updateInterval: 40 (2 seconds), the count refreshes while the menu is open.

For the count to work:

1. The server running AbstractMenus needs bungeeCord: true in plugins/AbstractMenus/config.conf.
2. The proxy needs the same server name in its config (the lobby in bungeeConnect: "lobby" must match the proxy’s registered name).
3. BungeeCord plugin messaging must be enabled on both ends.

Adding more servers

Each tile is independent. Copy any block, change the slot, name, lore, and the two server name references (bungeeConnect + the placeholder). Real backend names go in instead of lobby / survival etc.

For visual variety, swap material: per game mode (TNT for “TNT Games”, IRON_SWORD for “Battle Royale”, etc).

Showing online/offline status

To gate a tile by whether the server is reachable, use the bungeeIsOnline rule:

{
  slot: 10
  ...
  rules {
    bungeeIsOnline: "lobby"
  }
}

If lobby is offline, the item won’t render. Add a fallback “offline” item at the same slot with no rules and a different look (gray dye, “Server is offline” text) to use the dual-item pattern from Counter & Toggle.

Try it

After installing the example pack:

1. Run a BungeeCord/Velocity proxy with backends named lobby, survival, sw, bb.
2. Set bungeeCord: true in plugins/AbstractMenus/config.conf.
3. Drop the bundle into plugins/AbstractMenus/menus/example/.
4. /am reload.
5. Type /ame_servers in-game.