# 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.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. |
# Prefix for legacy commands (slash commands don’t need this) PREFIX=! thumperdc
# Or using Yarn yarn install --frozen-lockfile Create a file called .env in the root folder:
[Install] WantedBy=multi-user.target Enable with sudo systemctl enable thumperdc && sudo systemctl start thumperdc . | Q | A | |---|---| | Do I need a premium subscription for music? | No. ThumperDC uses YouTube and SoundCloud public streams. Spotify playback requires a Spotify Premium token and is optional. | | Can I host the bot for free? | Yes, on any VPS with at least 256 MiB RAM and a modest CPU. The bot’s baseline RAM usage is ~50 MiB. | | Is there a public instance I can test? | Some community servers run a public “demo” instance. Ask the maintainer on the official GitHub Issues page for an invite. | | ** | Symptom | Likely Cause | Fix |
# 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: | | /play returns “No results found”
# YouTube API key (optional – required for YouTube search) YT_API_KEY=YOUR_YOUTUBE_API_KEY