❓ Frequently Asked Questions (FAQ)
🏠 Documentation Hub > Troubleshooting > FAQ
Q1: Should I use NodeLink or Lavalink?
A: We strongly recommend NodeLink:
- Zero Java Requirement: Built entirely in Node.js (v22+).
- Native Moonlink.js Synergy: Moonlink.js provides native, seamless compatibility with NodeLink.
- Built-in Sources: Multi-source support (YouTube, Spotify, Apple Music, Deezer, SoundCloud) is built directly into NodeLink without hunting down separate Java plugins.
- Lower Resource Usage: Uses ~80 MB RAM compared to Lavalink's ~512 MB – 1 GB Java heap.
Q2: Why is music buffering or skipping in voice channels?
A: Voice audio stuttering is almost always related to:
- Audio Server Location: Ensure your NodeLink or Lavalink node is hosted in a region close to your Discord server's voice region (e.g. US-East, Europe).
- CPU Starvation: If hosting the audio server and the bot on a 1 vCPU machine, high traffic can cause frame drops. Increase CPU allocations.
- Buffer Duration: In
config.jsorapplication.yml, ensure buffer duration is at least 5000ms.
Q3: Why are YouTube searches returning no results or 429 errors?
A: YouTube frequently rate-limits datacenter IPs (AWS, DigitalOcean, Hetzner, OVH):
- In NodeLink, YouTube extractors are continuously maintained.
- In Lavalink, ensure you have installed the
youtube-plugin(v1.11.4+) inapplication.yml. - Alternatively, set
defaultPlatform: "spotify"or"soundcloud"inconfig.reverb.js.
Q4: How do I change the default bot prefix?
A:
- Globally: Change
bot.prefixinconfig.reverb.js(default:"r!"). - Per Server: Any administrator can run
r!setprefix <new_prefix>(e.g.r!setprefix ?). - Slash commands (
/play,/skip, etc.) are also always available regardless of prefix.
Q5: Why does the bot leave the voice channel after a few minutes?
A: Reverb has an automated idle detector (autoDestroyOnIdle: true with a 5-minute timeout). If no tracks are played or everyone leaves the voice channel, Reverb disconnects to save server resources. To keep Reverb in voice permanently, enable 24/7 Mode:
r!247
# or
/247Q6: Can I run Reverb without installing MongoDB or PostgreSQL?
A:Yes! Reverb defaults to SQLite (better-sqlite3), which stores all data in a local file at ./data/reverb.sqlite without requiring any database server installation.
Q7: Is there an official hosted Reverb bot, or do I have to self-host?
A: You do not need to self-host! You can invite the Official Reverb Bot directly to your server:
⏭️ Next Step
Having errors? Visit the Error Solutions Guide for fixes to common issues.
