Troubleshooting Guide

Fix common Flute Music Bot issues

Use this page when you face no sound, lag, command errors, wrong results, or stuck queue problems in Discord.

Start with the symptom that matches your server, then run the recovery steps in order.

No sound in voice channel

Check if Flute has Connect and Speak permissions in the same voice channel as the requester.

Make sure your Discord user is not server-muted and the bot volume is normal with fvolume 80.

  • Run fnowplaying to confirm a track is actually active.
  • Look for channel-specific permission denies on the voice channel.
  • Disconnect and invite the bot again if it joined the wrong room.

Command not responding

Verify the channel allows Flute to read messages, send messages, embed links, and use application commands.

Run fhelp to test a simple bot response before testing music playback.

  • Use the default prefix f if slash commands are not visible yet.
  • Check whether another moderation bot is deleting bot responses.
  • Try the command in a different channel where Flute has full access.

Queue stuck or skipping unexpectedly

Use fstop, then start again with fplay.

Reset effects using fclearfilters if audio pipeline feels unstable.

  • Use fqueue to check whether there are still tracks waiting.
  • Use fremove number for a broken queue item instead of clearing everything.
  • Use fshuffle only after confirming the queue has the right tracks.

Wrong song results

Search with cleaner keywords: artist + title.

Use a direct URL when exact match is required.

  • Avoid one-word searches for popular song titles.
  • Add artist name, remix name, or language when results are similar.
  • Clear the wrong result with fskip or fremove number.

Lag, buffering, or delayed responses

Temporary lag can come from Discord voice routing, music source rate limits, network spikes, or a busy server queue. First lower the number of active effects, then test one short track before rebuilding a long queue.

  • Run fclearfilters and fcleareffects to remove extra audio processing.
  • Use fstop and start with a single track if the queue has many old entries.
  • Check the website live status section to see if the bot is publishing fresh stats.

Premium or 24/7 mode not working

Premium checks depend on Discord login, payment status, and the server/user relationship stored by the bot. If a payment was recent, open the dashboard after login and confirm the plan state before retrying the command.

  • Run fpremium in Discord to see current premium status.
  • Use the dashboard to verify the account connected to Discord.
  • Ask support with Discord user ID and payment time if activation does not appear.

Fast recovery checklist

1

Confirm permissions

Check Connect, Speak, Send Messages, Embed Links, and Use Application Commands.

2

Test a simple command

Run fhelp. If this fails, fix text permissions before testing music.

3

Restart playback state

Run fstop, then use fplay artist title with a clear search term.

4

Remove audio effects

Run fclearfilters and fcleareffects if sound is distorted or silent.

What to send support

If the issue remains after the checklist, join the support server and include useful details so the problem can be reproduced quickly. Clear information avoids repeated questions and helps separate permission issues from playback provider issues.

  • Your Discord server ID and the channel where the command was used.
  • The exact command you ran, for example fplay artist title.
  • The visible error message or a screenshot of the bot response.
  • Whether the problem happens with every song or only one source/link.
  • Whether premium, 24/7 mode, filters, or playlist commands were involved.

Need full command reference?

Use setup and command guides to avoid repeat issues.