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

1. Step 1 - Create a Leaderboard

   /lb create balance %vault_eco_balance% DESC 60
   

2. 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
     

3. Step 3 - Create a Hologram
   • Stand where you want the hologram and run:

     /lb hologram create balance top_balance 10
     

4. 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