AsBalTop

<div align="center">

🏆 AsBalTop

Lightning-Fast Balance Leaderboard GUI

by ItzAzeem | AsDevs

Discord

Website

Version

License

Java

Vault

</div>

---

<div align="center">

*Real-time balance ranking in a stunning inventory GUI — zero lag.*

</div>

---

🎯 What is AsBalTop?

AsBalTop is a beautiful, interactive inventory GUI for Minecraft servers. The moment a player types `/baltop`, they see a beautiful, interactive inventory GUI displaying your server's richest players — just like the big servers you see on YouTube!

No databases. No complicated setup. Just drop the JAR in, configure it, and go.

---

<div align="center">

</div>

---

✨ Features

🏆 Live Balance Leaderboard

- Display 30-second smart caching (configurable up to 50) - 30-second smart caching — updates instantly - Rank-specific materials: Gold Block (#1), Iron Block (#2), Copper Block (#3) - Async player loading — 30-second smart caching - 30-second smart caching — reduces database queries by 90% - Fallback support if balance data unavailable

🎨 Fully Customizable GUI

- Adjustable button positions — 9 to 54 slots - Adjustable button positions — change icons per rank - Adjustable button positions — use hex codes `&#FF5500` or classic `&c` - Adjustable button positions — add descriptions under each rank - Adjustable button positions — Refresh and Your Info buttons - Adjustable button positions — place buttons anywhere

🔘 Interactive Buttons

- Fully customizable — Updates leaderboard in real-time (Emerald icon) - Fully customizable — Shows your personal rank & balance (Player Head) - Fully customizable — change names, positions, and icons

💰 Economy Integration

- Minimum balance filters — Works with Essentials, CMI, EconomyShop, and more - Minimum balance filters — Use $, €, £, or custom symbols - Minimum balance filters — Show balances as $1,234.50 or $1,234 - Minimum balance filters — Hide players below a certain amount

⚡ Blazing Performance

- Async operations — instant opening - Async operations — minimal footprint - Async operations — never freezes your server - Async operations — intelligent data refresh - Async operations — pure in-memory operation - Async operations — all heavy lifting done off-thread

🎯 40+ Customization Options

- One clean YAML file — customize every text element - One clean YAML file — `{player}`, `{balance}`, `{rank}` - One clean YAML file — personalize everything - One clean YAML file — control who can use which commands - One clean YAML file — all settings in one place

---

📜 Commands

| Command | Description | Permission | |---|---|---| | `/baltop` | Open balance leaderboard GUI | `baltop.use` | | `/baltop reload` | Reload config without restart | `baltop.reload` | | `/baltop help` | Show help message | *(everyone)* |

Aliases: `/moneytop` · `/wealthtop` · `/topbalance`

---

🔑 Permissions

| Permission | Description | Default | |---|---|---| | `baltop.use` | Use `/baltop` command | `true` | | `baltop.reload` | Reload plugin config | `op` | | `baltop.*` | All permissions | `op` |

---

⚙️ Configuration

```yaml

╔═══════════════════════════════════════════════╗

║ AsBalTop Configuration ║

║ Made by ItzAzeem | v1.0.0 ║

╚═══════════════════════════════════════════════╝

GUI Settings

gui: title: "§c§lBalance Top" # GUI title with colors size: 54 # Inventory slots (9-54)

Top Players Settings

top-players: count: 10 # Show top 10 players minimum-balance: 0 # Hide poor players cache-duration: 30 # Cache for 30 seconds

Rank Display Settings

rank-display: rank-1-material: "GOLD_BLOCK" rank-1-name: "§6§l#1 - §e{player}" rank-1-lore: - "§6Balance: §a${balance}" - "§e🥇 1st Place"

rank-2-material: "IRON_BLOCK" rank-2-name: "§f§l#2 - §7{player}" rank-2-lore: - "§7Balance: §a${balance}" - "§72nd Place 🥈"

rank-3-material: "COPPER_BLOCK" rank-3-name: "§c§l#3 - §8{player}" rank-3-lore: - "§8Balance: §a${balance}" - "§83rd Place 🥉"

other-material: "STONE" other-name: "§7§l#{rank} - §f{player}" other-lore: - "§7Balance: §a${balance}"

Button Settings

buttons: refresh-button: enabled: true slot: 49 material: "EMERALD" name: "§a§lREFRESH" lore: - "§eClick to refresh" - "§ethe leaderboard"

info-button: enabled: true slot: 53 material: "PLAYER_HEAD" name: "§b§lYOUR RANK" lore: - "§7Rank: §b{rank}" - "§7Balance: §a${balance}"

Economy Settings

economy: hook: "Vault" symbol: "$" decimal-places: 2

Messages

messages: prefix: "§6§lAsBalTop§r " gui-opened: "§aBalance top opened!" gui-refreshed: "§a✓ Leaderboard refreshed!" ```

---

🖥️ Compatibility

| Software | Supported | |---|---| | Paper 1.20 — 1.21+ | ✅ | | Spigot 1.20 — 1.21+ | ✅ | | Purpur 1.20 — 1.21+ | ✅ | | Java 25+ | ✅ Recommended | | Vault | ✅ Required |

---

🔧 Installation

1. Download `AsBalTop-1.0.0.jar` 2. Drop it into your `/plugins` folder 3. Restart your server 4. Edit `plugins/AsBalTop/config.yml` (optional) 5. Run `/baltop reload` — done! ✅

---

🎨 Customization Examples

Example 1: Professional Theme

```yaml gui: title: "§f[§6BALTOP§f] Balance Leaderboard"

rank-display: rank-1-name: "§6🏆 #1 - §e{player}" rank-1-lore: - "§6━━━━━━━━━━━━━━━" - "§eBalance: §a${balance}" - "§e🥇 1st Place" - "§6━━━━━━━━━━━━━━━" ```

Example 2: Colorful GUI

```yaml gui: title: "§6§lWEALTH RANKING"

rank-display: rank-1-material: "DIAMOND_BLOCK" rank-2-material: "EMERALD_BLOCK" rank-3-material: "LAPIS_BLOCK" ```

Example 3: Minimalist

```yaml gui: size: 27 title: "§aTop Players"

top-players: count: 6 ```

---

👨‍💻 Developer

AsDevs — Founder of AsDevs

Passionate Minecraft plugin developer building unique, high-quality tools for SMP and competitive servers.

- 🌐 Website: asdevs.netlify.app - 💬 Discord: discord.gg/xRW5rdAvs5

---

🆘 Support

Having issues? Need help with config?

> Join our Discord for fast support: > 👉 Join our Discord for fast support:

Please do not use Modrinth comments for bug reports — Discord is way faster!

---

<div align="center">

Made with ❤️ by ItzAzeem | AsDevs

*Enjoying AsBalTop? Please leave a ⭐ review on Modrinth — it really helps!*

</div>