Canoe Leaderboards
PluginLicenseRef-All-Rights-Reserved

Canoe Leaderboards

The Ultimate GUI based Leaderboard plugin

196
Downloads
2
Followers
4 months ago
Updated
📦
4
Versions

📖About Canoe Leaderboards

🏆 Canoe Leaderboards

The ultimate leaderboard plugin for your Minecraft server! Track any statistic with beautiful GUIs, modern formatting, and zero lag.


✨ Why Choose Canoe Leaderboards?

📊 Track Everything

  • Unlimited leaderboards - Create as many as you want
  • Any PlaceholderAPI stat - Money, kills, deaths, playtime, blocks mined, and more
  • Smart filtering - Automatically exclude inactive players
  • Auto-updates - Configurable intervals keep rankings fresh

🎨 Beautiful & Modern

  • Interactive GUI - Clean, easy-to-navigate inventory menus
  • Player heads - See who's on top at a glance
  • MiniMessage formatting - Gradients, colors, hex codes, and styling
  • Custom icons - Set unique materials for each leaderboard type

⚙️ Highly Configurable

  • Multiple leaderboards - Economy, PvP, building, mining - track it all!
  • Custom formats - Design your own rank displays
  • Flexible sizes - Top 5, 10, 25, or any number you want
  • Branded messages - Add your server's custom prefix

🚀 Performance First

  • Async processing - Updates run off the main thread
  • No lag - Efficient caching and smart data handling
  • Inactive player cutoff - Skip players who haven't joined recently
  • Optimized I/O usage - Minimal disk impact

📋 Requirements

⚠️ PlaceholderAPI is required for this plugin to work!

  • Minecraft Server - Paper or Spigot (Tested on 1.21+)
  • PlaceholderAPI - Download here
  • PlaceholderAPI Expansions - Install expansions for the stats you want to track

🎮 Commands & Permissions

Command Permission Description
/leaderboard None Open the leaderboard GUI
/leaderboard reload canoeleaderboards.reload Reload configuration
None canoeleaderboards.updatechecker Receive update notifications on join

🔧 Configuration

Main Settings

# How often to update leaderboards (in minutes)
update-interval: 30

# Ignore players who haven't played in X days
last-played-cutoff-days: 30

# GUI Configuration
gui:
  title: "<dark_gray>Leaderboards"
  rows: 3
  fill-item: GRAY_STAINED_GLASS_PANE
  # Whether to show player heads in the leaderboards.
  # Note: Try this if it causes lag when opening the GUI.
  use-player-heads: truev

Example Leaderboard

leaderboards:
  money:
    name: "<green>Top Money"
    placeholder: "%vault_eco_balance%"
    icon: GOLD_INGOT
    slot: 11
    size: 10 # Number of players to show
    lore:
      - "<gray>Click to see the richest players"
      - "<gray>on the server!"
    player: # How to display player information in the Leaderboard
      title: "{player}"
      lore:
        - "<gray>Position: <yellow>#{rank}"
        - "<gray>Balance: <red>${value}"

Available Placeholders:

  • {rank} - Player's position (1, 2, 3...)
  • {player} - Player's username
  • {value} - The statistic value

🎨 MiniMessage Formatting

Make your leaderboards stand out with modern text formatting:

  • Colors: <red>, <green>, <blue>, <gold>, <aqua>
  • Gradients: <gradient:red:blue>Rainbow Text</gradient>
  • Hex Colors: <#FF5555>Custom colors</color>
  • Formatting: <bold>, <italic>, <underlined>

📖 Full MiniMessage Documentation


📊 Leaderboard Ideas

💰 Economy Leaderboards

richest:
  name: "<gold><bold>💰 Richest Players"
  placeholder: "%vault_eco_balance%"
  icon: GOLD_BLOCK
  format: "<gray>#{rank} <yellow>{player} <gray>- <gold>${value}"

⚔️ Combat Stats

top_killers:
  name: "<red><bold>⚔️ Top Killers"
  placeholder: "%statistic_player_kills%"
  icon: DIAMOND_SWORD
  format: "<gray>#{rank} <red>{player} <gray>- <red>{value} kills"

top_deaths:
  name: "<dark_red><bold>💀 Most Deaths"
  placeholder: "%statistic_deaths%"
  icon: SKELETON_SKULL
  format: "<gray>#{rank} <dark_red>{player} <gray>- {value} deaths"

⏰ Activity Tracking

playtime:
  name: "<aqua><bold>⏰ Most Active"
  placeholder: "%statistic_time_played%"
  icon: CLOCK
  format: "<gray>#{rank} <aqua>{player} <gray>- <aqua>{value}"

🔍 Find More Placeholders


🎯 Perfect For

  • Tycoon Servers - Showcase the richest players
  • PvP Servers - Display top fighters and warriors
  • Survival Servers - Track playtime and achievements
  • Skyblock - Monitor island levels and progress
  • Prison Servers - Rank miners and grinders
  • Any Server - Track literally any statistic!

💡 Pro Tips

  1. Use gradients for eye-catching leaderboard titles
  2. Combine multiple stats - Create separate leaderboards for different aspects
  3. Adjust update intervals - Balance freshness with performance
  4. Set inactive cutoffs - Keep leaderboards relevant with active players
  5. Custom icons - Match materials to the stat being tracked

📝 Support & Community

💬 Need help or have suggestions? Join our Discord community!

🎮 Join Discord Server

Get support, share your configurations, and connect with other server owners!


Servers using Canoe Leaderboards

  • My Own Private SMP

Send me a message on discord via DM or Ticket to get your server here

📈 bStats Metrics

🔄 Updates

This plugin is actively maintained with regular updates and new features. Players with the canoeleaderboards.updatechecker permission will be notified when new versions are available.