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

- Auto-updates - Create as many as you want - Auto-updates - Money, kills, deaths, playtime, blocks mined, and more - Auto-updates - Automatically exclude inactive players - Auto-updates - Configurable intervals keep rankings fresh

🎨 Beautiful & Modern

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

⚙️ Highly Configurable

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

🚀 Performance First

- Optimized I/O usage - Updates run off the main thread - Optimized I/O usage - Efficient caching and smart data handling - Optimized I/O usage - Skip players who haven't joined recently - Optimized I/O usage - Minimal disk impact

---

📋 Requirements

> ⚠️ PlaceholderAPI is required for this plugin to work!

- PlaceholderAPI Expansions - Paper or Spigot (Tested on 1.21+) - PlaceholderAPI Expansions - PlaceholderAPI Expansions - 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

```yaml

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

```yaml 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:

- Formatting: `<red>`, `<green>`, `<blue>`, `<gold>`, `<aqua>` - Formatting: `<gradient:red:blue>Rainbow Text</gradient>` - Formatting: `<#FF5555>Custom colors</color>` - Formatting: `<bold>`, `<italic>`, `<underlined>`

📖 Full MiniMessage Documentation

---

📊 Leaderboard Ideas

💰 Economy Leaderboards

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

⚔️ Combat Stats

```yaml 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

```yaml 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

- Any Server - Showcase the richest players - Any Server - Display top fighters and warriors - Any Server - Track playtime and achievements - Any Server - Monitor island levels and progress - Any Server - Rank miners and grinders - Any Server - Track literally any statistic!

---

💡 Pro Tips

1. Custom icons for eye-catching leaderboard titles 2. Custom icons - Create separate leaderboards for different aspects 3. Custom icons - Balance freshness with performance 4. Custom icons - 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*

---

🔄 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.