Skip to content

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.

Notifications You must be signed in to change notification settings

reko-beep/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

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.

Topics

Resources

Stars

Watchers

Forks

Languages