📖 Reverb Documentation Hub

Welcome to the official documentation for Reverb — a modern, high-fidelity Discord music bot built with discord.js v14, Moonlink.js (NodeLink & Lavalink), and a multi-engine database layer.

Whether you are hosting Reverb for the first time, setting up NodeLink, configuring advanced audio filters, or managing guild settings, this multi-page documentation covers everything you need.

---

🤖 Official Bot & Support Server

Don't want to self-host? You can invite the Official Reverb Bot directly to your Discord server or join our official community support server:

• 🔗 Official Bot Invite: Click Here to Invite Reverb
• 💬 Discord Support Server: discord.gg/6UwVYHu2zu

---

🗺️ Documentation Sitemap

🚀 Getting Started

1. System Prerequisites
   Hardware specifications, Node.js 22+, package managers (pnpm, npm, yarn), and system verification.
2. Discord Developer Portal Setup
   Application creation, privileged gateway intents, and OAuth2 invite link with exact permission bits (281891692735824).
3. NodeLink Audio Server Setup (Recommended)
   Installing, configuring, and running NodeLink — the recommended 100% Node.js audio server with built-in multi-source support.
4. Moonlink.js Client Library Guide
   Overview of Moonlink.js, its native NodeLink synergy, queue mechanics, and audio filter pipeline.
5. Lavalink v4 Setup (Alternative)
   Setting up a traditional Java-based Lavalink v4 server, application.yml plugins, and systemd service.
6. Installation & First Boot
   Cloning the repository, installing dependencies (pnpm, npm, yarn), configuring .env, and launching Reverb.

---

⚙️ Configuration

7. Environment Variables (.env)
   Detailed breakdown of all .env keys: bot token, client ID, owner IDs, database drivers, and ports.
8. Bot Configuration (config.reverb.js)
   Audio node cluster definitions, UI emojis, brand colors, default search engine, and timeouts.
9. Database & Storage Layer
   Zero-config SQLite (better-sqlite3), MongoDB (Mongoose), and SQL engines (PostgreSQL/MySQL via Drizzle ORM).

---

🎛️ Features & Operations

10. Music Engine & Audio Pipeline
    Audio volume curves, autoplay algorithms, hardware audio filters (Bassboost, Nightcore, 8D), and LRCLIB synchronized lyrics.
11. Dedicated Song Requests Channel
    How r!setup create / /setup create works, persistent player cards, and real-time queue updater (queueAdd/queueRemove).
12. Command Reference (All 59 Commands)
    Complete directory of all 59 commands across 6 categories (Info, Music, Filters, Playlist, Configuration, Developer) with subcommands and syntax.
13. Guild Customization & DJ System
    Interactive bot nickname changer (r!customise), prefix management (r!setprefix), DJ protection (r!dj), and command channel whitelist (r!whitelist).

---

🏗️ System Architecture

14. System Architecture & Lifecycle
    Technical architecture, ShardingManager, ReverbClient bootstrap sequence, player hierarchies, and multi-driver database repositories.
15. Event Dispatching & Music Events
    Routing and lifecycles of Discord gateway events (client, commands, system) and Moonlink audio streaming events (node, player, queue, track).

---

🩺 Troubleshooting & Support

16. Frequently Asked Questions (FAQ)
    Common questions regarding audio performance, search platforms, and hosting.
17. Error Solutions Guide
    Resolving DiscordAPIError[50013]: Missing Permissions, ECONNREFUSED 127.0.0.1:2333, DisallowedIntentsError, and missing voice permissions.

---

📖 About & History

18. The Reverb Story & Roadmap
    The motivation, history, lessons learned, and future roadmap behind Reverb's revival.

---

⚡ Quick Navigation Matrix

Topic	Primary Guide	Key Configuration File
First Time Setup	Installation Guide	.env
Discord Permissions	Discord Portal Guide	config.reverb.js
Audio Server (Recommended)	NodeLink Setup	config.js
Audio Server (Java)	Lavalink v4 Setup	application.yml
Audio Client Library	Moonlink.js Guide	config.reverb.js
Song Requests Channel	Setup Channel Guide	src/events/system/setupButtons.js
All Bot Commands	Command Reference	src/commands/
System Architecture	Architecture Overview	src/structures/
Project Story & History	The Reverb Story	N/A
Fixing Errors	Error Solutions	N/A

---

Ready to Get Started?

Begin with System Prerequisites to configure your environment.

---

📄 License & Attribution

Reverb is released as free, open-source software under the Apache 2.0 License.

Copyright © 2026 — maintained by The Reverb Team and CodeSuthar.