Duels Leaderboard

⚔️ Duels Leaderboard
A lightweight and efficient PlaceholderAPI expansion designed for Duels Optimised. It reads local JSON player data files asynchronously and lets you display top player leaderboards on holograms, scoreboards, or chat menus without paying for paid extensions!

✨ Features
🔋 Async File Scanning: Parses and sorts player data files in the background to ensure zero lag on your server's main thread.

🔄 Auto-Caching: Automatically refreshes the leaderboard cache at configurable intervals.

📌 PlaceholderAPI Native: Fully integrates with DecentHolograms and any other plugin supporting PlaceholderAPI.

🆓 100% Free: A lightweight alternative to paid leaderboard extensions.

📋 Placeholders
You can use any rank number from 1 onwards (e.g., 1, 2, 3...):

Top Names: %duels_top_name_% (Example: %duels_top_name_1%)

Top Scores: %duels_top_score_% (Example: %duels_top_score_1%)

⚙️ Dependencies
PlaceholderAPI (Required)

Duels Optimised (Required — reads from /plugins/Duels/users/)

🚀 Hologram Setup Example (DecentHolograms)
Plaintext
/dh create duels_leaderboard
/dh line set duels_leaderboard 1 &e&l★ Duels Leaderboard ★
/dh line add duels_leaderboard &71. &f%duels_top_name_1% &8- &a%duels_top_score_1%
/dh line add duels_leaderboard &72. &f%duels_top_name_2% &8- &a%duels_top_score_2%
/dh line add duels_leaderboard &73. &f%duels_top_name_3% &8- &a%duels_top_score_3%