Hot! | Thumperdc

logs/ (rotated daily). Look for [ERROR] lines for stack traces. 9️⃣ Updating the Bot git pull origin main npm ci # reinstall any new deps npm run build # if the repo uses TypeScript npm restart # or stop & start manually Tip: Set up a systemd service (Linux) or a PM2 process to auto‑restart on failure. Example systemd unit [Unit] Description=ThumperDC Discord Bot After=network.target

npm install discord.js@14 # already a dependency # In .env SHARD_COUNT=auto The launcher will automatically spawn the needed number of shards using the built‑in ShardingManager . | Symptom | Likely Cause | Fix | |---------|--------------|-----| | Bot stays offline after npm start . | Invalid token or missing TOKEN env var. | Verify .env contains the exact token, no extra quotes/spaces. | | /play returns “No results found”. | YouTube API key missing or quota exhausted. | Add a valid YT_API_KEY to .env (enable YouTube Data API v3). | | Audio is choppy or silent. | FFmpeg not installed / path not in $PATH . | Install FFmpeg ( apt-get install ffmpeg , brew install ffmpeg , or download from ffmpeg.org). | | Permissions errors when joining voice. | Bot lacks Connect / Speak in the target voice channel. | Grant the bot the proper role permissions or move it to a channel with default permissions. | | Mod‑log messages not appearing. | Mod‑log channel not set, or bot lacks Send Messages there. | Run /modlog #channel-name and ensure the bot’s role can post. | | Dashboard returns 404. | Redirect URI mismatch. | Ensure the OAuth2 redirect URI in the Developer Portal matches the one used by the dashboard ( /auth/callback ). | | Bot crashes after a long session. | Memory leak in queue handling (rare). | Update to the latest version ( git pull && npm install ) – recent releases fix a known leak. | thumperdc

# Bot token from step 3 TOKEN=YOUR_DISCORD_BOT_TOKEN_HERE logs/ (rotated daily)

# In .env DASHBOARD_ENABLED=true DASHBOARD_PORT=8080 Run with npm run dashboard . The dashboard uses Discord OAuth2; you must register a Redirect URI ( https://yourdomain.com/auth/callback ) in the Developer Portal. 7.3 Scaling with Multiple Shards For bots in >2,500 guilds: | Verify

# Install extra deps npm install express express-session passport-discord