Home/Products/LeaderboardUI

LeaderboardUI

A modern Leaderboard UI that displays playerstats

LeaderboardUI Preview 1
Click to Expand

LeaderboardUI is a premium, feature packed visual leaderboard plugin for RocketMod. It introduces a modern, high performance in-game Hall of Fame dialog (/top) that allows players to switch seamlessly between PvP and PvE categories, compete for the top ranks, and view their exact standing on the server in real-time.


Features

🖥️ Interactive In-Game UI (/top)

  • Two Main Mode Switchers:
    • PVP Leaderboards: Competitive player combat statistics.
    • PVE Leaderboards: Server survival, hunting, resource gathering, and economy metrics.
  • PvP Tracked Metrics:
    • Kills: Total player eliminations with secondary KDR & deaths breakdown.
    • Deaths: Total deaths from PvP combat.
    • KDR (Kill/Death Ratio): Live calculated ratio with minimum kill threshold protection against skewing.
    • HS% (Headshot Percentage): Precision accuracy tracking ((Headshots / Kills) * 100).
  • PvE Tracked Metrics:
    • Zombies: Standard zombies eliminated.
    • Mega Zombies: Boss and mega zombies defeated.
    • Animals: Wildlife hunted (deer, wolves, bears, pigs, etc.).
    • Resources: Trees chopped down and mineral resource nodes mined.
    • Harvests: Farmed agricultural crops collected.
    • Fish: Marine life caught using fishing rods.
  • Top 10 Hall of Fame:
    • Clean UI rows with gold (🥇 1st), silver (🥈 2nd), and bronze (🥉 3rd) tier highlights.
    • Shows Rank, Player Name, Primary Metric, and Contextual Secondary Details.
  • Personal Standing Card:
    • Fixed footer displaying the viewing player's personal server rank, character name, and stat tally for the selected category.

💾 Flexible Storage Architecture (LiteDB & MySQL)

  • LiteDB: High-speed, zero-configuration local embedded database stored in leaderboard_stats.db.
  • MySQL: Full relational database support for multi-server networks, websites, or external applications.
  • Periodic Auto-Save: In-memory caching for zero gameplay hitching, periodically flushed to disk or database on a configurable timer

🎁 Automatic Rewards & 🚫 Anti-Cheat Bans

  • Permission Group Rewards: Automatically awards custom Rocket permission groups (such as vip, hunter, slayer) when players hit configured milestone thresholds.
  • Automatic Ban Protection: Configurable multi-rule anti-cheat evaluation triggered on kills or deaths (e.g. automatically banning players exceeding high kill numbers with >80% headshot accuracy within short playtimes).

Commands

CommandAliasesDescriptionDefault Permissions
/top [category]/leaderboard, /ranking, /lbOpens the visual PvP/PvE leaderboard modal. Optional shortcut to jump straight to a category (e.g. /top pve, /top kdr, /top fish).leaderboard, top
/stats [player]/mystatsDisplays a detailed chat summary of your own or another player's PvP and PvE statistics.stats

Permissions

<Permission Cooldown="0">top</Permission>
<Permission Cooldown="0">leaderboard</Permission>
<Permission Cooldown="0">stats</Permission>

Configuration

<?xml version="1.0" encoding="utf-8"?>
<LeaderboardUIConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <!-- Chat message theme and icon -->
  <MessageColor>yellow</MessageColor>
  <MessageIconUrl>https://i.imgur.com/TWjBtCA.png</MessageIconUrl>

  <!-- Database Provider: "litedb" or "mysql" -->
  <DatabaseProvider>litedb</DatabaseProvider>
  <MySQLConnectionString>Server=127.0.0.1;Port=3306;Database=unturned;Uid=root;Pwd=password;</MySQLConnectionString>
  <MySQLTableName>PlayerStats</MySQLTableName>
  <PeriodicSaveIntervalSeconds>60</PeriodicSaveIntervalSeconds>

  <!-- UI MasterBundle Effect IDs -->
  <EffectID>15032</EffectID>
  <EffectKey>1532</EffectKey>
  <MinimumRankingThreshold>0</MinimumRankingThreshold>

  <!-- Automated Milestone Rewards -->
  <EnableRewards>true</EnableRewards>
  <Rewards>
    <Reward Name="Hunter Rank" Stat="Kills" Threshold="50" PermissionGroup="hunter" />
    <Reward Name="Zombie Slayer" Stat="Zombies" Threshold="500" PermissionGroup="slayer" />
  </Rewards>

  <!-- Automatic Ban System -->
  <EnableAutomaticBans>false</EnableAutomaticBans>
  <AutomaticBans>
    <AutomaticBan Reason="Suspicious Accuracy / Kills (AB)">
      <Conditions>
        <Condition Comparer="greater" Stat="Kills" Value="30" />
        <Condition Comparer="greater" Stat="Accuracy" Value="80" />
        <Condition Comparer="less" Stat="Playtime" Value="3600" />
      </Conditions>
    </AutomaticBan>
  </AutomaticBans>
</LeaderboardUIConfiguration>

Upcoming Feature: Discord Bot Integration

We are planning a dedicated Discord Bot companion to bridge your Unturned community with Discord:

🌟 What to Expect

  • Live Slash Commands:
    • /top <pvp | pve> [category]: Post interactive leaderboard embeds directly in your Discord channels with real-time rankings and pagination.
    • /stats <player | steamid>: View rich Discord profile cards displaying a player's combat record, PvE accomplishments, playtime, and current rank.
    • /link <steamid>: Link Discord accounts with Steam IDs so members can run /me to view their personal stats.
  • Automated Weekly & Monthly Hall of Fame:
    • Automated scheduled posts to an announcements channel recognizing the top performers of each season.
    • Synchronized Discord roles for players holding Top 1, Top 3, or Top 10 positions on the server.
  • Shared Database Sync:
    • Operates directly on the shared MySQL database schema (PlayerStats) with zero impact on game server tickrate or performance.
LeaderboardUI

LeaderboardUI

uiutilitypvppvegeneral (misc)
★New(0 ratings)
Free
Sign in to Claim Free
Current Versionv1.0.1
Last Updated11/15/2026

Required Workshop

Unique Visitors31
Subscribers15
Favorites0
Workshop IDs
3814461260

Developer Support

Need help setting up this plugin? Reach out to the developer directly.

Get Support

Latest Changes

v1.0.1

Fixed issue where multiple messages were sent in chat when reaching a rank and after