Skip to content
c0bra edited this page Jul 24, 2026 · 2 revisions

Battlevive Bot Wiki

Battlevive Bot is a Discord bot that syncs Battlevive player, lobby, season rating, and leaderboard data into Discord. It manages Battlevive player/rank roles, serves player rank cards, and posts configurable leaderboard images.

This project is under active development.

Wiki pages

  • User Guide - commands and features for Discord members.
  • Server Admin Guide - server setup, permissions, roles, and leaderboard configuration.
  • Deployment - container setup, environment variables, runtime data, and migrations.
  • Developer Guide - project layout, local validation, database development, and debug commands.
  • Database Schema - PostgreSQL tables, ERD, and persistence notes.
  • Troubleshooting - common failures and recovery steps.

Main Discord commands

  • /rank - display your Battlevive rank card.
  • /refresh - refresh Battlevive data, roles, and leaderboard state. Requires Manage Server.
  • /create_roles - create the Battlevive Player role and rank roles.
  • /config leaderboard channel - set the leaderboard channel. Requires Manage Server.
  • /config leaderboard limit - set the leaderboard size from 1-50, or omit the amount for 50. Requires Manage Server.
  • /config reset leaderboard - clear leaderboard configuration. Requires Manage Server.
  • /config show - show this server's leaderboard configuration. Requires Manage Server.

Clone this wiki locally