Altitude Discord Bot

Discord bot for Altitude Interactive, built with discord.py 2.7+.

Requirements

• Python 3.11+

Setup

1. Create a virtual environment
2. Install dependencies
3. Copy .env.example to .env
4. Fill in the real values

Git Bash:

python -m venv .venv
source .venv/Scripts/activate
pip install -e .

PowerShell:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .

Run

python -m altitude_discord_bot

Local terminal runs default to verbose logging when ALTITUDE_ENV is not production. To keep production logs at the normal level, set:

ALTITUDE_ENV=production

You can also force a specific level with:

LOG_LEVEL=DEBUG

Or keep debug output only for this bot's own loggers (suppress discord.* debug noise):

LOG_LEVEL=INTERNAL_DEBUG

Synchronize slash commands globally:

python -m altitude_discord_bot --sync

Synchronize slash commands to every guild the bot is currently in:

python -m altitude_discord_bot --sync-all-guilds

Synchronize slash commands globally:

python -m altitude_discord_bot --sync-global

Synchronize slash commands only to the configured main guild:

python -m altitude_discord_bot --sync-main

Docker

Build the image:

docker build -t altitude-discord-bot .

Run the bot:

docker run --rm \
  --env-file .env \
  altitude-discord-bot

Current features

• startup logging
• verbose command and service trace logging by default for non-production terminal runs
• optional slash command sync for the main guild, all guilds, or globally
• /ping
• /team preview
• /team refresh
• /team status
• daily team sync task for Highlanders avatar publishing through the team service path