GameForge Twitch Team Bot

Simple Node.js bot that polls the GameForge Twitch Team roster, detects go-live transitions, and posts live events to a Discord webhook.

Features

• Polls team membership on each cycle (auto add/remove behavior based on current API response)
• Polls stream status for current team members
• Posts one Discord embed per go-live event
• Uses SQLite to avoid duplicate announcements across restarts
• Uses .env for all auth and runtime configuration

Setup

1. Install Node.js 20+
2. Copy .env.example to .env
3. Fill in Twitch and Discord values in .env
4. Install dependencies:

npm install

5. Start bot:

npm start

Trigger Test Message

Send a one-off test embed to your Discord webhook:

npm run test-message

If DRY_RUN=true, this command logs and skips sending.

Notes

• Team is always treated as "GameForge Twitch Team" in messages and logs.
• IGNORED_USERS is case-insensitive.
• DRY_RUN=true logs what would be posted without sending Discord messages.
• If Twitch returns 404 for team membership, set TEAM_MEMBER_LOGINS in .env with comma-separated Twitch logins.

Twitch API note

The bot uses GET /helix/teams?name=<team_login> to resolve the GameForge Twitch Team members. If Twitch returns 404 or an empty team list, it automatically falls back to TEAM_MEMBER_LOGINS and resolves users through GET /users.