TOTStats Discord Bot

A Discord bot that automatically assigns roles, syncs nicknames, and displays leaderboards based on player stats from The Outlast Trials.

Add the bot to your server

Features

Setup (/setup)

Profile

Roles are also automatically assigned when a verified member joins the server.

Leaderboard

To remove a leaderboard, simply delete its message in Discord — the bot will automatically clean up the binding.

Self-Hosting with Docker

The easiest way to run the bot is with Docker.

1. Set up docker-compose.yml

services:
  bot:
    container_name: totstats-discord-bot
    image: ghcr.io/outlasttrialsstats/discord-bot:latest
    restart: always
    mem_limit: 1g
    environment:
      DISCORD_BOT_TOKEN: "your-bot-token"
      SPRING_DATASOURCE_URL: "jdbc:postgresql://postgres:5432/totstats"
      SPRING_DATASOURCE_USERNAME: "totstats"
      SPRING_DATASOURCE_PASSWORD: "change-me"
    depends_on:
      - postgres

  postgres:
    container_name: totstats-discord-postgres
    image: postgres:17
    restart: always
    mem_limit: 512m
    environment:
      POSTGRES_USER: totstats
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: totstats
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

2. Start the bot

docker compose up -d

3. Invite the bot

Invite the bot to your server using the OAuth2 URL from the Developer Portal with the bot and applications.commands scopes.

Development

Prerequisites

• Java 25+
• Docker (for PostgreSQL)
• A Discord Bot Token with Server Members Intent enabled

1. Start the database

docker compose up -d

2. Configure environment

Create a .env file in the project root:

DISCORD_BOT_TOKEN=your-bot-token-here

3. Run the bot

./mvnw spring-boot:run