Changelog

---

Added FastStats Metrics

VaultLeaderboards v1.6

• [FIX] Added exception handling for economy providers that return null (e.g., LightEconomy v5.5.1.beta-2)
• [FIX] All economy calls now properly run asynchronously to prevent thread blocking
• [CHANGE] Balances default to 0.0 when economy provider throws exceptions

Note: LightEconomy v5.5.1.beta-2 has a bug where getBalance() returns null internally instead of 0.0 for unknown players. This violates the Vault API contract. We recommend using EssentialsX, CMI, or Treasury for stable economy integration.

Changelog

MySQL Update

Added

• MySQL database support with HikariCP connection pooling
• Cross-server synchronization - Share leaderboards across multiple servers
• Database configuration section in config.yml (host, port, credentials, table-prefix, pool settings)
• New database tables: vl_balances and vl_balance_history with automatic creation
• Balance history tracking - Track changes over time for time-based statistics
• New command: /vl status - Check database connection status
• New command: /vl sync - Force database synchronization
• New command: /vl top [page] - Display paginated top balances
• New placeholder: %vaultleaderboards_topearner_<rank>_<days>d% for time-based leaderboards (e.g., %vaultleaderboards_topearner_1_7d%)
• Automatic fallback to local storage if database connection fails
• Permission node: vaultleaderboards.status
• Permission node: vaultleaderboards.sync
• Permission node: vaultleaderboards.top

Changelog

---

• Reworked the Messages ( smoother colors )
• You can now change the "N/A" in the config.yml

  not-available: "<red>N/A</red>"

• Pushed the latest Version to git https://github.com/GodlyCow203/VaultLeaderboardsV2
• Improved the code

Changelog

---

• Added a Modrinth Update checker to check for latest version
• Added 2 new Commands + TAB Completion:
  • /vaultleaderboards help
  • /vaultleaderboards version
• Made every messages customizable
• Added a new Placeholder:
  • %vaultleaderboards_server_average%
• Improved the Plugin

| Amount now gets formatted
--> 1.0: 100000
--> 1.1: 100k

| Added support for Minimessages | Updated the Config | Added Bstats Support

🪙 VaultLeaderboards

Display top player balances effortlessly — Vault-powered, Placeholder-ready.

A lightweight PlaceholderAPI expansion to show top player money rankings using Vault-compatible economy plugins like EssentialsX. Fully customizable format, easy to set up, and works perfectly with leaderboards, scoreboards, and holograms.

---

📌 Features

• ✅ %vaultleaderboards_top_1% → Shows the #1 richest player
• ✅ %vaultleaderboards_top_5% → Shows any top rank
• ✅ %vaultleaderboards_Steve% → Shows a specific player's name, money, and rank
• ✅ Configurable output colors, suffixes, and formatting
• ✅ Built-in /vl reload command
• ✅ Designed for minimal performance impact
• ✅ Works with any PlaceholderAPI-compatible plugin

---

🧩 Placeholders

Placeholder	Output Example
%vaultleaderboards_top_1%	§aSteve §b12500.0$ §e#1
%vaultleaderboards_top_3%	§aAlex §b9200.5$ §e#3
%vaultleaderboards_<playername>%	Formatted data for player

Just replace <playername> with any valid Minecraft username

---

⚙️ Configuration (config.yml)

You can change how each part is colored and formatted:

format:
  name_color: "§a"
  money_color: "§b"
  money_suffix: "$"
  place_color: "§e"
  place_prefix: "#"