UltimateLeaderboard Discord Bot 1.2.0

UltimateLeaderboard Discord Bot is a Discord bot for your Rust server's leaderboard. It reads your UltimateLeaderboard plugin data and shows interactive player statistics in your Discord server as visual stats cards built from Figma templates.

Features

• Statistics cards generated from Figma templates with real player data
• Display kills, deaths, KDR, playtime, favorite weapons, and building statistics
• Real-time data from your UltimateLeaderboard MySQL database
• Steam profile integration with automatic avatar fetching
• Multi-language support with customizable language files
• Discord slash commands

Showcase

Interactive stats command

Statistics cards generated from Figma

 Video overview

The video walks through a live demo, Discord bot configuration, Figma integration, and installation.

Commands

• /stats [steam_id]: show player statistics as visual cards

Requirements

• UltimateLeaderboard plugin with MySQL database
• Discord bot token
• Python 3.12 hosting environment
• Important: Turn on the "Enable real-time stats updates to database" option in the UltimateLeaderboard config so the bot shows accurate data

Configuration

Configuration is one JSON file:

{
  "discord": {
    "botToken": "your-discord-bot-token"
  },
  "database": {
    "host": "localhost",
    "port": 3306,
    "username": "username",
    "password": "password",
    "database_name": "database_name",
    "table_prefix": ""
  }
}

Note: The bot uses cached Figma template data. Cache files are already included in the archive. If you want to use your own Figma template, run the refresh_figma_cache.py script once (you need Figma API credentials only for that script, not for the bot itself).

Displayed statistics

• Kills, Deaths & KDR
• Total playtime with formatting
• Favorite weapons with icons
• Building materials usage
• Combat accuracy by body parts
• Leaderboard position and points
• Steam profile integration

FAQ

Q: What should I read before installation?
A: Read docs/USER_GUIDE.md first. It has the detailed setup instructions.

Q: Do you have a default template?
A: Yes, it is at "docs/UltimateLeaderboard Discord Stats.fig"

Q: Do I need the UltimateLeaderboard plugin?
A: Yes, this bot reads data from the UltimateLeaderboard plugin's MySQL database.

Q: Can I customize the statistics cards?
A: Yes. The cards come from Figma templates, and you can change them completely to match your server's style.

Q: What hosting options are supported?
A: Windows, Linux, Pterodactyl, Docker, and cloud services. A full setup guide is included.

Q: Do I need Figma API credentials?
A: No, the bot works with cached data. The archive includes pre-populated cache files. To use your own Figma template design, run the refresh_figma_cache.py script once to fetch it into the cache. Figma API credentials are only needed for that script, not for the bot itself.

Q: How does the cache system work?
A: The bot uses cached Figma template data instead of calling Figma API during runtime. This makes it faster and more reliable. Cache files are stored in cache/figma directory. The archive already includes these files, so you can start using the bot immediately. If you want to update the template design later, just run refresh_figma_cache.py again.

Quick installation

1. Download and extract the bot files
2. Install dependencies: pip install -r requirements.txt
3. Configure config.json with your Discord bot token and database settings
4. Optional: Run refresh_figma_cache.py if you want to use your own Figma template (cache files are already included)
5. Run: python bot.py

Support

USER_GUIDE.md with step-by-step setup instructions is included. For support, join our Discord: https://discord.gg/mevent