Battlevive Discord Bot

Discord bot that syncs player, lobby, season rating, and leaderboard data from Battlevive/Supabase and manages Battlevive roles, ranks, and match info in Discord.

This project is under active development.

Documentation

Full documentation lives in the GitHub Wiki:

• Wiki home
• User Guide
• Server Admin Guide
• Deployment
• Developer Guide
• Database Schema
• Troubleshooting

Requirements

• Docker or Podman with Compose support
• A Discord bot token
• Battlevive/Supabase API credentials

Setup

cd utils
cp .env.example .env
# fill required values in .env
./init.sh

Running

From the repository root after utils/init.sh completes:

docker compose up -d --build

or:

podman compose up -d --build

Check logs with docker compose logs -f bot or podman compose logs -f bot.

For a standalone image build:

podman build . --file Dockerfile --tag battlevive-bot:local

License

This project is licensed under the AGPL-3.0. See LICENSE.

Third-party assets

• Liberation Mono 2.1.5 is bundled under the SIL Open Font License 1.1. The original license and copyright notice are in app/assets/fonts/LICENSE.txt. Upstream project and official archive: liberationfonts/liberation-fonts, Liberation Fonts 2.1.5 TTF download.