A Discord bot that monitors Counter-Strike: Global Offensive (and other supported) servers, provides real-time server status updates, and notifies users when specific maps appear on followed servers.

• Real-time Server Monitoring: Automatically queries game servers at a configurable interval to update server status
• Embed Channel: Automatically updates a channel message with rich embed of all configured servers and their status
• Map Notifications: Receive DM alerts when followed maps appear on monitored servers
• Multi-Game Mode Support: Supports Surf, KZ (kreedz climb), and Bhop map prefixes
• Slash Commands: Modern Discord interaction using slash commands with autocomplete support
• Rate Limiting: Built-in rate limiting to prevent abuse (configurable per command)
• IP Validation: Secure IP address/FQDN validation with private IP blocking
• Automatic Cleanup: Automatically removes user follows when they leave the server
• Caching System: User and map image caching to reduce API calls
• Retry Logic: Exponential backoff for failed server queries

• Node.js: Version 20 or higher
• Discord Bot Token: Create a bot application at Discord Developer Portal
• SQLite: Required for map follow data persistence (handled by better-sqlite3 package)

1. Clone the repository

   git clone https://github.com/Sneaks-Community/discordCSGOServerBot.git
   cd discordCSGOServerBot

2. Install dependencies

   npm install

3. Configure the bot

   • Copy the example environment file:

     cp .env.example .env

   • Edit .env with your settings (see Environment Variables below)

4. Configure servers

   • Edit servers.json with your game server details (see Server Configuration below)

5. Run the bot

   npm start

All configuration is done via environment variables. Copy .env.example to .env and configure as needed.

The bot supports the following CS:GO game modes with automatic map detection:

• Prefix: surf_
• Default Stats URL: snksrv.com/surfstats
• Example: surf_beginner

• Prefixes: kz_, bkz_, kzpro_, skz_, vnl_, xc_
• Default Stats URL: snksrv.com/kzstats
• Example: kz_asylum

• Prefix: bhop
• Default Stats URL: snksrv.com/bhopstats
• Example: bhop_strix

Add your CS:GO servers to servers.json:

{
  "ServerName": {
    "ip": "IP_ADDRESS:PORT",
    "nick": "Display Name",
    "show": true,
    "protocol": "csgo",
    "keywords": ["keyword1", "keyword2"]
  }
}

• Node.js v20.x or higher
• Docker (optional, for containerized deployment)

• Bot Permissions:

  • Send Messages
  • Embed Links
  • Read Message History
  • Add Reactions
  • Send Messages in Threads
  • Use External Emojis
  • Use Application Commands

• Required Intents:

  • Guilds
  • GuildMessages
  • GuildMessageReactions
  • DirectMessages
  • DirectMessageReactions

The bot can be run in a Docker container for easy deployment. The Docker image uses a multi-stage build with node:22-alpine for a minimal footprint (~100MB).

1. Clone and configure

   git clone https://github.com/Sneaks-Community/discordCSGOServerBot.git
   cd discordCSGOServerBot

2. Create environment file

   cp .env.example .env
   nano .env  # Edit with your Discord token and settings

3. Configure servers

   Edit servers.json with your game server details.

4. Build and run

   docker-compose up -d

5. View logs

   docker-compose logs -f

# Build the image
docker build -t discord-csgo-bot .

# Run the container
docker run -d \
  --name csgo-server-bot \
  --env-file .env \
  -v $(pwd)/servers.json:/app/servers.json:ro \
  -v bot-data:/app/data \
  discord-csgo-bot

All configuration options can be set via environment variables. See .env.example for the full list.

The Docker compose setup uses named volumes:

• bot-data - SQLite database storage

# Pull latest changes
git pull

# Rebuild and restart
docker-compose up -d --build

• Container won't start: Check that DISCORD_TOKEN is set in your .env file
• Commands not working: Ensure slash commands have propagated (may take a few minutes)
• Database errors: Check volume permissions and disk space
• Permission denied: Ensure the bot-data volume exists and is accessible

First and foremost, review all logs.

• Verify your Discord token is correct and has proper permissions
• Check that .env file exists and contains DISCORD_TOKEN
• Ensure all required environment variables are set

• The bot uses slash commands - type / in any channel the bot has access to
• The bot must be invited to your server with proper permissions
• Slash commands may take a few minutes to propagate after the bot starts
• Try using /help to see available commands

• Verify follow.timeoutSeconds is set appropriately
• Check that the bot can send DMs to users
• Ensure map names match the expected format (alphanumeric, underscores, hyphens)
• Make sure you have /follow set for the maps you want notifications for

• Check server IP and port in servers.json
• Verify the server is accessible from your network
• Review logs for GameDig query errors

Frumpy7

For issues and feature requests, please visit the GitHub Issues page.