L-LeaderBoard

L-LeaderBoard is an advanced, high-performance, and feature-rich leaderboard plugin for Minecraft servers. It allows server administrators to create dynamic rankings using any PlaceholderAPI placeholder and display them across NPCs, Holograms, Signs, and Player Skull Heads.

Designed for modern Minecraft server networks, it features native Folia multi-threading support, cross-server MySQL database synchronization with HikariCP, and compatibility with versions 1.16.5 through 1.21.x+.

Features

Universal PlaceholderAPI Support: Track and rank any numerical or formatted placeholder (Balance, Kills, Playtime, Level, Custom Plugin stats, Island Level, Clan points, etc.).
Multi-Platform Support: Native support for Paper, Spigot, Purpur, and Folia (1.16.5 to 1.21.x+).
Smart Look-to-Link NPCs: Link NPCs to leaderboards just by looking directly at them. The NPC automatically changes its skin to match the ranked player in real-time. Supports FancyNpcs, Citizens, and ZNPCsPlus.
Hologram Providers: Compatible with FancyHolograms, DecentHolograms, HolographicDisplays (v2 & v3), and CMI.
Signs & Player Heads: Dynamic signs showing rank, player name, and score. Attached skull blocks automatically wear the skin of the ranked player.
Cross-Server Sync: Fast local SQLite or high-speed MySQL with HikariCP connection pooling for network-wide leaderboards.
Flexible Sorting: Sort rankings in DESC (Descending: highest to lowest) or ASC (Ascending: lowest to highest).
Number Formatting: Clean number formatting (e.g. 1,250,000) and optional number abbreviations (e.g. 1.25M).
Multi-Language: Built-in English (en) and Turkish (tr) translations, switchable via config.yml.

Integrations

Feature	Supported Plugins
Placeholders	PlaceholderAPI (Required)
NPCs	FancyNpcs, Citizens, ZNPCsPlus
Holograms	FancyHolograms, DecentHolograms, HolographicDisplays, CMI

Commands

Permission: lleaderboard.admin (Default: OP)

General

Command	Description
`/lb help`	Displays the help menu
`/lb list`	Lists all active leaderboards
`/lb create <name> <placeholder> <ASC\|DESC> [sec]`	Creates a new leaderboard
`/lb delete <name>`	Deletes an existing leaderboard
`/lb update [name]`	Manually triggers a data refresh
`/lb reload`	Reloads configuration files and hooks

NPCs

Command	Description
`/lb npc set <lb_name> <rank>`	Links targeted NPC to rank
`/lb npc set <lb_name> <rank> <npc_id>`	Links an NPC by name/ID
`/lb npc remove`	Unlinks targeted NPC
`/lb npc remove <npc_id>`	Unlinks an NPC by ID

Holograms

Command	Description
`/lb hologram create <lb_name> <holo_name> [lines]`	Creates a leaderboard hologram
`/lb hologram remove <holo_name>`	Removes a leaderboard hologram

Signs

Command	Description
`/lb sign set <lb_name> <rank>`	Links targeted sign to rank
`/lb sign remove`	Unlinks targeted sign

Quick Start

Step 1 - Create a Leaderboard

/lb create balance %vault_eco_balance% DESC 60

Step 2 - Link an NPC
- Create an NPC using FancyNpcs, Citizens, or ZNPCsPlus.
- Look directly at the NPC and run:
```
/lb npc set balance 1
```
Step 3 - Create a Hologram
- Stand where you want the hologram and run:
```
/lb hologram create balance top_balance 10
```
Step 4 - Create a Sign and Skull
- Place a sign and place a Player Head above or next to the sign.
- Look at the sign and run:
```
/lb sign set balance 1
```

Configuration

database:
  type: SQLITE # SQLITE or MYSQL
  mysql:
    host: "localhost"
    port: 3306
    database: "leaderboard"
    username: "root"
    password: ""
    pool-size: 10
    connection-timeout: 5000

settings:
  language: "en" # en / tr
  data-scan-interval-seconds: 120
  format-numbers: true
  abbreviate-large-numbers: false

npc-settings:
  default-skin: "Steve"
  name-format: "&e#%rank% &f%player_name% &7- &a%value%"

Support

discord: https://discord.gg/W23eQgPFKM