Skip to content

itskaero/brawlhalla-leaderboard

Repository files navigation

Brawlhalla Leaderboard Generator

GitHub Logo

This project is a leaderboard image generator and uploader tailored for Brawlhalla players. It fetches player data using Brawlhalla IDs and produces leaderboard images that are then optionally sent via a configured webhook.

🛠 Features

  • Fetches Brawlhalla player stats from a JSON source or direct list
  • Generates styled leaderboard images (configurable colors and fonts)
  • Sends generated images via Discord webhooks
  • Customizable visual themes and webhook behavior

📂 Setup

  1. Configure client_settings.json:

    • Add your Brawlhalla player IDs
    • Set the webhook URL
    • Modify display settings (optional)
  2. Image & Logo Setup:

    • Place your custom logo in logo.png with same dimensions as sample
    • Customize fonts by replacing font.ttf (adjust positioning if needed)
  3. Optional: Adjust the color scheme in client.py:

    image_generator = ImageGenerator(settings, headingColor=(145,138,138), entriesColor=(255,255,255), entriesBlockColor=(0,0,0))

▶️ Usage

Run the script using:

python client.py

The script:

  • Loads Brawlhalla IDs
  • Generates leaderboard images in pages of 20 entries
  • Sends those images to a Discord webhook

📦 Dependencies

Make sure to install the following Python packages:

pip install requests Pillow beautifulsoup4

Feel free to fork, customize, and expand this project to fit your community or clan needs!

About

Generates and uploads leaderboard images for Brawlhalla players using their IDs and optional webhook delivery.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages