LBmenu | LeaderboardMenus

LBMenu — Leaderboards, Reimagined

Transform your ajLeaderboard / Topper data into a sleek, fully interactive in-game menu.
No more boring text lists — give your players a modern, fast, and visually appealing leaderboard experience.

---

✨ Features

• Live Leaderboard Data
  Display real-time stats directly from ajLeaderboards / Topper

• Beautiful GUI Menus
  Clean, customizable menus that players actually enjoy using

• High Performance
  Smart caching system to reduce lag and improve responsiveness

• Fully Configurable
  Customize titles, layouts, items, lore, and more via simple config

• Seamless Integration
  Works perfectly with:

  • ajLeaderboards
  • Topper
  • PlaceholderAPI

• Player-Friendly UX
  Smooth navigation and instant loading menus

---

🚀 Why LBMenu?

Most leaderboard plugins show data in plain chat or holograms.
LBMenu takes it further by turning that data into a premium GUI system:

Better visibility
Better interaction
Better player engagement

---

Custom Button Actions

Buttons can execute one or more actions when clicked. Add an actions section to any supported button configuration.

Player Command

Executes a command as the player who clicked the button.

actions:
  - "[playercommand] leaderboards"

Example

back:
  material: RED_STAINED_GLASS_PANE
  name: "&#FF1919Back"
  lore:
    - "&fClick to return"
  slots: 45
  actions:
    - "[playercommand] leaderboards"

Console Command

Executes a command from the server console.

actions:
  - "[consolecommand] give %player% diamond 1"

Example

reward:
  material: DIAMOND
  name: "&#55FFFFClaim Reward"
  lore:
    - "&fClick to claim your reward"
  slots: 22
  actions:
    - "[consolecommand] give %player% diamond 1"

Message

Sends a message to the player.

actions:
  - "[message] &aYou clicked the button!"

Example

info:
  material: BOOK
  name: "&#FFD700Information"
  lore:
    - "&fClick to view information"
  slots: 20
  actions:
    - "[message] &aWelcome to the server!"

Close Menu

Closes the player's currently open inventory.

actions:
  - "[close]"

Example

close:
  material: BARRIER
  name: "&#FF1919Close"
  lore:
    - "&fClick to close this menu"
  slots: 49
  actions:
    - "[close]"

Play Sound

Plays a sound to the player.

actions:
  - "[sound] UI_BUTTON_CLICK"

Example

sound-test:
  material: NOTE_BLOCK
  name: "&#55FF55Play Sound"
  lore:
    - "&fClick to play a sound"
  slots: 24
  actions:
    - "[sound] UI_BUTTON_CLICK"

Multiple Actions

A button can execute multiple actions. Actions are executed in the same order they are defined.

reward:
  material: CHEST
  name: "&#FFD700Claim Reward"
  lore:
    - "&fClick to claim your reward"
  slots: 22
  actions:
    - "[message] &aYou claimed your reward!"
    - "[consolecommand] give %player% diamond 1"
    - "[sound] ENTITY_PLAYER_LEVELUP"
    - "[close]"

When the player clicks this button, it will:

1. Send a message to the player.
2. Give the player a diamond using a console command.
3. Play a level-up sound.
4. Close the menu.

Available Actions

Notes

• Do not include / before commands.
• Multiple actions are executed in configuration order.
• Invalid or unknown action types are ignored safely.
• Use valid Bukkit/Paper sound names with the [sound] action.
• %player% can be used where player-name placeholders are supported.

🛠️ Commands

/lbmenu        - Open the leaderboard menu
/lbmenu reload - Reload configuration

---

🔑 Permissions

lbmenu.open     - اجازه to open the menu
lbmenu.reload   - Reload the plugin

---

⚙️ Configuration Highlights

• Custom menu layouts
• Configurable refresh & cache timings
• Placeholder-based lore & titles
• Support for multiple leaderboard categories

---

📦 Requirements

• Paper / Spigot (1.21+)
• PlaceholderAPI
• ajLeaderboards or Topper

---

💬 Support

Need help or found a bug?
Join our support or open an issue we’re happy to help!