Infernum Docs
Everything you need to set up and master Infernum.
Getting Started
- Click Invite Bot and add Infernum to your server.
- Grant the requested permissions (View Channel, Connect, Speak, Use Voice Activity).
- Join a voice channel and run
/play your song. - Pick a result and enjoy. Manage everything else from the dashboard.
Commands
| Command | Description |
|---|---|
| /play <query> | Play a song, album or playlist by name or URL. |
| /pause · /resume | Pause or resume the current track. |
| /skip | Skip the current track (vote-skip for non-DJs). |
| /stop | Stop playback, clear the queue and leave. |
| /queue [page] | Show the current queue. |
| /nowplaying | Show the current track with a progress bar. |
| /volume [0-200] | Show or set the playback volume. |
| /loop <off|track|queue> | Set the repeat mode. |
| /shuffle | Shuffle the upcoming queue. |
| /remove <position> | Remove a track from the queue. |
| /clear | Clear all upcoming tracks. |
| /lyrics | Show lyrics for the current track. |
| /autoplay [on|off] | Toggle recommended-song autoplay. |
| /filter <preset> | Bass Boost, Nightcore, Vaporwave, Karaoke, Reverb or 8D. |
| /playlist <save|load|list|delete> | Manage your personal saved playlists. |
Setup Guide
For self-hosting the bot, you need Node.js 18+, a Lavalink v4 server, and a Discord application.
- Create an application at the Discord Developer Portal and copy the token + client ID.
- Run a Lavalink v4 node with the youtube-source and LavaSrc plugins (Docker compose provided).
- Fill in
.envand runnpm run deploythennpm start. - Optionally add Spotify keys for richer Spotify link support.
Troubleshooting
- Bot won't join voice: confirm it has Connect & Speak in the channel and that your Lavalink node is connected.
- Commands missing: re-invite with the
applications.commandsscope; global commands can take up to an hour to appear. - No audio / stuck at 0:00: usually a Lavalink node issue — check that the node is up and the youtube-source plugin is current.
- Spotify links don't resolve: add your Spotify client ID/secret; without them, links fall back to a plain YouTube search.
FAQ
▸Is Infernum free?
Yes. Every music feature is free. A Premium tier with extras (higher volume ceiling, more filters, saved-playlist slots) is planned but optional.
▸Does Infernum stream from Spotify or Apple Music?
No. Those services are used for metadata only. When you paste a Spotify or Apple Music link we read the track details and stream the matching audio from YouTube. JioSaavn link support is currently unavailable.
▸Why does the bot need Connect and Speak permissions?
To join your voice channel and play audio. Without them Discord blocks the bot from connecting or transmitting.
▸Can I use it on multiple servers?
Absolutely. Each server gets its own independent queue, volume and settings.
▸How do I get a special role with Linked Roles?
Visit the Verify page, connect your Discord account, and Infernum will push your verification metadata so Discord can grant the linked role.