Thumperdc !exclusive! -

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

# Spotify credentials (optional – for Spotify playback) SPOTIFY_CLIENT_ID=... SPOTIFY_CLIENT_SECRET=... If you’re using the default SQLite store, you don’t need DATABASE_URL . 4.4 Run the Bot npm start # or: node src/index.js You should see something like:

# Owner ID – your Discord user ID (for admin‑only commands) OWNER_ID=123456789012345678 thumperdc

/ping You should get a “Pong!” reply. 5.1 Generate the Invite Link Replace YOUR_CLIENT_ID with the Application ID from the Discord Developer Portal.

[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.: # Install extra deps npm install express express-session

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

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. | Connected to 0 guilds

[Service] Type=simple User=discordbot WorkingDirectory=/opt/thumperdc ExecStart=/usr/bin/node src/index.js Restart=on-failure EnvironmentFile=/opt/thumperdc/.env