VaultLeaderboards

# 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: ```yaml format: name_color: "§a" money_color: "§b" money_suffix: "$" place_color: "§e" place_prefix: "#"