AvenoxLeaderboard
Minecraft Leaderboard Plugin

Build better
leaderboards.

AvenoxLeaderboard is a clean, configurable leaderboard system for Paper and Folia servers with GUI leaderboards, PlaceholderAPI support, Vault economy support, sorting and persistent storage.

Get Started → View Placeholders
PaperFoliaPlaceholderAPISQLiteMySQL
AvenoxLeaderboard
Leaderboards
💰Money
⚔Kills
☠Deaths
⛏Mined
🧱Placed
◷Playtime
👹Mobs
Information: ▸ Player: SuperPlayer ▸ Balance: 94.1M # Click to View
⚡
Fast updatesCached leaderboard reads
🎨
Fully configurableGUI, messages & storage
🔌
PlaceholderAPIUse rankings anywhere
💾
Persistent dataSQLite or MySQL
7Built-in boards
2Storage options
5Sorting modes
∞Custom boards
01 · Installation

Get AvenoxLeaderboard running

Follow these steps in order. The plugin is designed for modern Paper/Folia servers.

01

Install the plugin

Put AvenoxLeaderboard.jar into your server's plugins/ folder.

02

Install integrations

Install PlaceholderAPI for placeholders. For Money, use Vault with an economy provider.

03

Restart the server

Restart instead of using a plugin reload. AvenoxLeaderboard creates its configuration files automatically.

04

Open the GUI

Use /leaderboard or its aliases /lb and /top.

Recommended setup Paper/Folia + PlaceholderAPI + Vault + your economy plugin. LuckPerms is optional and supported for permission filtering.
02 · Dependencies

What does it need?

Only install what your server features actually use.

▣
SERVER

Paper / Folia

Required server platform. The current build targets the Paper API and declares Folia support.

%
OPTIONAL · RECOMMENDED

PlaceholderAPI

Required for AvenoxLeaderboard's %ulb_... placeholders and custom placeholder-based boards.

$
MONEY

Vault + Economy

The Money board reads an economy provider through Vault when available. PlaceholderAPI's Vault expansion is used as a fallback.

✓
OPTIONAL

LuckPerms

Supported for permission-based filtering and permission integration. It is a soft dependency.

03 · PlaceholderAPI

Every Avenox placeholder

Identifier: ulb. Replace <board> with a board ID and <position> with a rank number.

Example: %ulb_kills_1_name% returns the username in position #1 of the Kills leaderboard.
PlaceholderReturnsExample
%ulb_<board>_<position>_name%Username at a leaderboard position%ulb_kills_1_name%
%ulb_<board>_<position>_value%Formatted value at that position%ulb_money_1_value%
%ulb_<board>_<position>_displayname%Player display name%ulb_kills_1_displayname%
%ulb_<board>_<position>_position%Position number%ulb_kills_1_position%
%ulb_<board>_position%Viewer's current rank%ulb_kills_position%
%ulb_<board>_value%Viewer's current formatted value%ulb_kills_value%
%ulb_<board>_size%Total entries in the cached snapshot%ulb_kills_size%
%ulb_<board>_total%Alias of size%ulb_kills_total%

Built-in board IDs

Top 10 Kills
#1 %ulb_kills_1_name% - %ulb_kills_1_value%
#2 %ulb_kills_2_name% - %ulb_kills_2_value%
#3 %ulb_kills_3_name% - %ulb_kills_3_value%
#4 %ulb_kills_4_name% - %ulb_kills_4_value%
#5 %ulb_kills_5_name% - %ulb_kills_5_value%
03.5 · Usage

Use rankings anywhere

Place leaderboard values in scoreboards, holograms, TAB layouts, chat formats and other PlaceholderAPI-compatible plugins.

01

Pick a board

Use one of the built-in IDs such as kills, money or playtime.

02

Pick a position

Use 1 for first place, 2 for second place, and so on.

03

Choose a value

Use _name, _value, _displayname or _position.

04

Copy & paste

Example:

EXAMPLE

Top 3 Money

Put these placeholders into any plugin that supports PlaceholderAPI.

#1 %ulb_money_1_name% — %ulb_money_1_value%
#2 %ulb_money_2_name% — %ulb_money_2_value%
#3 %ulb_money_3_name% — %ulb_money_3_value%
04 · Commands

Commands & permissions

Use the command list below as a quick server-admin reference.

/leaderboardOpen the leaderboard GUI
/lbAlias
/topAlias
/leaderboard open <id>Open a specific board
/leaderboard listList configured boards
/leaderboard info <id>Show board information
/leaderboard position <id> [player]Show a player's position
/leaderboard search <id> <player>Search leaderboard entries
/statsOpen personal statistics
/leaderboard reloadReload plugin configuration
/leaderboard update <id>Force a board update
/leaderboard reset <id>Reset a board
/leaderboard resetallReset all boards
/leaderboard set <id> <player> <value>Set an entry manually
/leaderboard remove <id> <player>Remove an entry
/leaderboard helpShow help

Permissions

universalleaderboards.useBase leaderboard commands
universalleaderboards.leaderboardLeaderboard GUI access
universalleaderboards.stats/stats access
universalleaderboards.adminAll admin permissions
universalleaderboards.admin.reloadReload
universalleaderboards.admin.resetReset
universalleaderboards.admin.createCreate
universalleaderboards.admin.deleteDelete
universalleaderboards.admin.updateUpdate
universalleaderboards.bypassBypass restrictions
universalleaderboards.excludeExclude from tracking
universalleaderboards.hiddenHide holder from display
05 · Configuration

Configure your boards

Core configuration files live in plugins/AvenoxLeaderboard/.

config.yml

Performance, cache, tracking, ranking, number formatting and logging.

leaderboards.yml

Board definitions, sources, statistics, update intervals and entry limits.

gui.yml

Main GUI, board-view GUI, stats GUI, item slots, lore and sounds.

messages.yml

Plugin messages and command responses.

storage.yml

SQLite/MySQL storage settings and connection options.

Built-in sources

STATISTICBukkit statistics such as PLAYER_KILLS, DEATHS and PLAY_ONE_MINUTE.
VAULTEconomy balance.
COUNTEREvent-driven counters for blocks mined, blocks placed and mobs killed.
PLACEHOLDERCustom values resolved through PlaceholderAPI.

Ranking modes

COMPETITION1, 2, 2, 4
DENSE1, 2, 2, 3
ORDINAL1, 2, 3, 4

Order

DESCHighest to lowest
ASCLowest to highest
leaderboards.yml · example custom board
my-board:
  display-name: "&bMy Board"
  source: PLACEHOLDER
  placeholder: "%some_placeholder%"
  type: NUMBER
  order: DESC
  timed: ALL_TIME
  update-interval: 30
  max-entries: 100
  enabled: true
07 · Built-in boards

Ready out of the box

These are the seven default boards in the current AvenoxLeaderboard configuration.

⚔

Kills

kills

PLAYER_KILLS statistic

☠

Deaths

deaths

DEATHS statistic

💰

Money

money

Vault economy balance

⛏

Blocks Mined

blocks-mined

Event counter

🧱

Blocks Placed

blocks-placed

Event counter

◷

Playtime

playtime

PLAY_ONE_MINUTE ÷ 20

👹

Mobs Killed

mob-kills

Event counter

06 · Troubleshooting

Common setup issues

Check these first when a board or placeholder is not showing the expected result.

Placeholder shows blank

Confirm PlaceholderAPI is installed, the ulb identifier is correct, and the board ID exists.

Money board is empty

Check that Vault is installed and an economy provider is active on the server.

GUI changes are not visible

Check gui.yml and reload/restart the server after configuration changes.

Counter is not increasing

Verify the relevant board is enabled and that the player is not excluded by a configured permission/filter.

08 · FAQ

Quick answers

Why do my %ulb_...% placeholders show blank?

Make sure PlaceholderAPI is installed and the AvenoxLeaderboard expansion is registered. The identifier is ulb. Also verify the board ID and position are valid.

What do I need for the Money leaderboard?

Use Vault with an economy provider. The plugin can also fall back to PlaceholderAPI's %vault_eco_balance% when the Vault integration is available.

Can I make custom leaderboards?

Yes. The engine supports PlaceholderAPI-based custom boards and custom providers. Define a board in leaderboards.yml and add a GUI button if you want it visible in the main menu.

Where are the GUI settings?

Edit plugins/AvenoxLeaderboard/gui.yml. You can change titles, slots, materials, names, lore, navigation and sounds.

Copied!