🏆 FrozenLeaderBoard

📦 Plugin Info

FrozenLeaderBoard adds fully holographic, in-world leaderboards for your server's top players — kills, deaths, balance, playtime, blocks broken/placed, mobs killed, and weekly kills/deaths — with no external plugins required to run. Place a leaderboard anywhere in the world with one command, and it auto-refreshes on a timer, rotates to face nearby players, and resets weekly stats automatically. Download it if you want DonutSMP/network-style stat displays without setting up a database or a separate hologram plugin.

• Name: FrozenLeaderBoard
• Version: 1.0.0
• Description (plugin.yml): Standalone holographic leaderboard plugin — no dependencies needed!

👤 Author Info

• Author: DrFrozenXD

✅ Versions / Compatibility / Software Support

• API Version: 1.21
• Server software: Paper and forks
• Folia support: ✅ Supported (folia-supported: true)
• Dependencies: None required — works entirely standalone out of the box
• Soft dependencies (optional):
  • Vault — for economy/balance leaderboard support
  • PlaceholderAPI — exposes %frozenlb_<type>_<place>_name% style placeholders for use in scoreboards, chat, tab lists, etc.
  • FrozenShards — unlocks the additional "Most Shards" leaderboard type

🔐 Permissions

Permission	Default	Purpose
frozenlb.admin	op	Access to all /flb commands
frozenlb.set	op	Place a hologram leaderboard at your location
frozenlb.move	op	Move an existing hologram to your location
frozenlb.reload	op	Reload config and refresh all holograms

⌨️ Commands

Command	Aliases	Permission	Usage
/flb	/frozenlb, /frozenleaderboard	frozenlb.admin	/flb <set|move|reload|list> [type]

• set <type> — places a leaderboard hologram of the given type at your current location
• move <type> — moves an already-placed leaderboard to your current location
• reload — reloads config.yml and refreshes every hologram
• list — lists all leaderboard types and shows which ones are currently placed

Full tab completion is provided for subcommands and leaderboard types.

🎯 Uses

• 📊 Display live, auto-updating top-10 boards for: Kills, Deaths, Money, Playtime, Blocks Broken, Blocks Placed, Mobs Killed, Weekly Kills, Weekly Deaths, and Shards (with FrozenShards).
• 🔄 Configurable refresh interval so leaderboard data stays current without hammering the server.
• 🎯 Holograms can face nearby viewers (billboard mode) or stay fixed in place — your choice.
• 📅 Weekly leaderboards automatically reset on a configurable day of the week.
• 🎨 Fully customizable messages with support for & color codes and &#RRGGBB hex colors.
• 🧩 PlaceholderAPI integration to surface leaderboard data anywhere else on your server.
• 🖼️ Per-leaderboard-type hologram styling via individual GUI config files (icon, title, layout).

⚙️ Key Config Areas (config.yml)

• update-interval — how often leaderboard data refreshes (seconds)
• leaderboard-size — number of players shown per board (max 10)
• line-spacing / icon-scale — hologram visual layout tuning
• billboard — toggle whether holograms rotate to face players
• weekly-reset-day — which day weekly boards reset on
• messages.* — every user-facing plugin message
• gui/*.yml — one file per leaderboard type controlling its hologram appearance