Thumperdc !!top!! May 2026

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. |

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 thumperdc

# 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: npm install discord

# YouTube API key (optional – required for YouTube search) YT_API_KEY=YOUR_YOUTUBE_API_KEY | Verify

[INFO] Logged in as ThumperDC#1234 (ID: 987654321098765432) [INFO] Ready! Connected to 0 guilds. Now add the bot to a server (see Invite URL below) and test a slash command, e.g.:

# Prefix for legacy commands (slash commands don’t need this) PREFIX=!