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

🎯 What is AsBalTop?

AsBalTop is a lightning-fast balance leaderboard plugin 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.

✨ Features

🏆 Live Balance Leaderboard

• Display top 10 richest players (configurable up to 50)
• Real-time balance syncing — updates instantly
• Rank-specific materials: Gold Block (#1), Iron Block (#2), Copper Block (#3)
• Async player loading — zero main thread lag
• 30-second smart caching — reduces database queries by 90%
• Fallback support if balance data unavailable

🎨 Fully Customizable GUI

• Adjustable inventory size — 9 to 54 slots
• Rank-specific item materials — change icons per rank
• Custom rank names with colors — use hex codes &#FF5500 or classic &c
• Item lore — add descriptions under each rank
• Interactive buttons — Refresh and Your Info buttons
• Adjustable button positions — place buttons anywhere

🔘 Interactive Buttons

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

💰 Economy Integration

• Vault API — Works with Essentials, CMI, EconomyShop, and more
• Custom currency symbols — Use $, €, £, or custom symbols
• Decimal precision — Show balances as $1,234.50 or $1,234
• Minimum balance filters — Hide players below a certain amount

⚡ Blazing Performance

• <100ms GUI load time — instant opening
• ~5MB memory usage — minimal footprint
• Zero TPS impact — never freezes your server
• Smart 30-second caching — intelligent data refresh
• No databases — pure in-memory operation
• Async operations — all heavy lifting done off-thread

🎯 40+ Customization Options

• Full color code support — customize every text element
• Placeholder variables — {player}, {balance}, {rank}
• Custom messages — personalize everything
• Permission system — control who can use which commands
• One clean YAML file — all settings in one place

📜 Commands

Aliases: /moneytop · /wealthtop · /topbalance

🔑 Permissions

⚙️ Configuration

# ╔═══════════════════════════════════════════════╗
# ║         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

🔧 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

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

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

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

top-players:
  count: 6

👨‍💻 Developer

ItzAzeem — 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: 👉 discord.gg/xRW5rdAvs5

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