Cloudy Not Working? Complete Troubleshooting Guide

Cloudy Isn't Responding

When the bot fails to react to commands, issues typically stem from permissions, command synchronization, or Discord service disruptions.

Step 1: Verify Cloudy Is Online

Check your server's member list and confirm that Cloudy appears online.

If Cloudy is offline, there may be a temporary outage or maintenance period.

Step 2: Check Bot Permissions

Ensure Cloudy has the following permissions:

• •View Channels
• •Send Messages
• •Embed Links
• •Read Message History
• •Use Application Commands

Step 3: Test Slash Commands

Type / in a text channel and verify that Cloudy's commands appear in the command list. If commands do not appear, Discord may still be synchronizing them.

Step 4: Restart Discord

Close Discord completely and reopen it. This refreshes Discord's command cache and often resolves command-related issues.

Step 5: Try Another Channel

Some channels may have permission restrictions that prevent Cloudy from responding. Try using a command in another channel.

Step 6: Contact Support

If Cloudy remains unresponsive after completing these steps, create a support ticket in the Cloudy Support Server.

Cloudy Won't Join Voice Channels

When the bot fails to connect to voice channels after a music command, follow these steps.

Step 1: Join a Voice Channel

Before using music commands, you must be connected to a voice channel. Cloudy cannot join if the user who requested playback is not connected.

Step 2: Verify Voice Permissions

Ensure Cloudy has permission to: View Channel, Connect, and Speak. These permissions are required for Cloudy to join and play music.

Step 3: Check Channel Limits

If your voice channel has reached its user limit, Cloudy may be unable to join. Increase the channel limit or use another voice channel.

Step 4: Check Role Restrictions

Some voice channels restrict access to specific roles. Verify that Cloudy's role is allowed to join the channel.

Step 5: Use /join

Run /join — Cloudy will attempt to join your current voice channel.

Step 6: Reconnect Cloudy

Run /rejoin — Cloudy will disconnect from the current voice channel and automatically rejoin it, refreshing the voice connection.

Step 7: Use /fixvoice

Run /fixvoice — this command refreshes Cloudy's voice connection and resolves many common connection problems automatically.

Step 8: Force Disconnect

If Cloudy appears stuck in another voice channel, run /forceleave, wait a few seconds, then try /join again.

No Audio Playing

When the bot connects but produces no sound, work through these steps.

Step 1: Verify Cloudy Is Not Muted

Check the voice channel member list and ensure Cloudy is not server-muted. If muted, unmute it and test playback again.

Step 2: Check the Queue

Run /queue to verify there are songs in the queue. If the queue is empty, add a track using /play <song name>.

Step 3: Check Volume

Run /volume to verify the playback volume is not set too low.

Step 4: Verify Your Audio Settings

Check your Discord output device, Discord volume settings, and system audio settings. Sometimes the issue is related to Discord rather than Cloudy.

Step 5: Check if Playback Is Paused

Run /resume — if playback was paused, the current track will continue.

Step 6: Restart Playback

Run /stop, then start a new session with /play <song name>.

Step 7: Try Another Song

The current track may be unavailable. Try playing another song or URL to determine whether the issue is song-specific.

Step 8: Reconnect

Run /rejoin to refresh the voice connection, then /fixvoice to restore audio playback.

Playback Lag and Audio Issues

When experiencing stuttering, distorted audio, delayed playback, or interruptions, follow these steps.

Step 1: Reconnect Cloudy

Run /rejoin — Cloudy will disconnect and automatically rejoin the voice channel.

Step 2: Repair the Voice Connection

Run /fixvoice — this refreshes Cloudy's voice session and resolves most temporary audio issues.

Step 3: Change the Voice Channel Region

Discord voice server issues can cause playback problems. To change the region: open the voice channel settings, navigate to Overview, locate Region Override, select a different region, and save. Then run /rejoin to reconnect Cloudy.

Step 4: Test Another Song

Play another song to determine whether the issue is specific to the current track.

Step 5: Adjust the Volume

Try /volume 50 and test playback again.

Step 6: Verify Your Connection

Check your internet stability, Discord connection quality, and whether other users experience the same issue.

Step 7: Contact Support

If audio issues continue after completing these steps, contact support in the Cloudy Support Server.

Commands Not Showing

Step 1: Restart Discord

Completely close Discord and reopen it.

Step 2: Check Permissions

Ensure Cloudy has the Use Application Commands permission.

Step 3: Wait for Synchronization

Discord may take several minutes to register new slash commands.

Step 4: Reinvite Cloudy

If commands still do not appear, reinviting Cloudy often refreshes command registration.

Step 5: Contact Support

If the issue persists, contact support in the Cloudy Support Server.

Slash Commands Not Updating

Sometimes Discord caches old command data.

Step 1: Restart Discord

Close and reopen Discord.

Step 2: Wait for Command Updates

Global slash command updates can take time to propagate across Discord.

Step 3: Check for Duplicate Bots

Verify that another bot is not causing command conflicts.

Step 4: Reinvite Cloudy

Reinviting the bot can refresh outdated command registrations.

Premium Features Not Working

Step 1: Verify Your Subscription

Confirm that your Cloudy Premium subscription is still active on Patreon or Buy Me a Coffee.

Step 2: Check Server Assignment

Ensure Premium is assigned to the correct server using /premium.

Step 3: Wait for Synchronization

Subscription changes may take up to 45 minutes to update.

Step 4: Refresh Cloudy

Run /rejoin to refresh the active session, then test the premium feature again.

Step 5: Contact Support

If premium features still do not work, create a support ticket in the Cloudy Support Server.

Premium Role Not Assigned

Step 1: Wait for Verification

Payment verification typically takes between 15 and 45 minutes after subscribing.

Step 2: Verify Discord Connections

Ensure your Discord account is connected correctly to Patreon or Buy Me a Coffee.

Step 3: Reconnect Your Account

Disconnect and reconnect your Discord account to the payment provider.

Step 4: Verify Support Server Membership

You must remain a member of the Cloudy Support Server to keep Premium access. Leaving the server automatically removes Premium benefits.

Step 5: Contact Support

If more than 45 minutes have passed and you still have not received your Premium role, create a support ticket in the Cloudy Support Server.

Control Panel Issues

If the Control Panel is not functioning correctly, follow these steps.

Step 1: Verify the Control Panel Exists

Check whether the dedicated Cloudy music channel is still present.

Step 2: Check Permissions

Ensure Cloudy can view the channel, send messages, and embed links.

Step 3: Recreate the Control Panel

Run /setup, select Delete Control Panel, then create a new one.

Step 4: Refresh Cloudy

Run /rejoin or /fixvoice to refresh the active session.

Step 5: Test the Panel

Try searching for a song or using playback controls.

Step 6: Contact Support

If the panel remains unresponsive, contact support in the Cloudy Support Server.

Playlist Loading Problems

If playlists fail to load, follow these steps.

Step 1: Verify the Playlist URL

Ensure the URL is valid and accessible.

Step 2: Check Playlist Visibility

Private or deleted playlists cannot be imported.

Step 3: Test an Individual Track

Attempt to load a single track from the same platform.

Step 4: Reconnect Cloudy

Run /rejoin to refresh the player session.

Step 5: Try Again Later

The music provider may be experiencing temporary issues.

Step 6: Contact Support

If playlists consistently fail to load, contact support with the playlist URL and any displayed error messages.

Fixing Missing Permissions

Missing permissions are one of the most common causes of Cloudy issues.

Step 1: Review Bot Permissions

Cloudy should have access to:

• •View Channels
• •Send Messages
• •Embed Links
• •Read Message History
• •Connect
• •Speak
• •Use Voice Activity
• •Use Application Commands

Step 2: Check Channel Overrides

Channel-specific permission overrides may block Cloudy even when server permissions are enabled. Review both text and voice channel permissions.

Step 3: Test with Administrator

For troubleshooting purposes, you may temporarily grant Cloudy the Administrator permission. If Cloudy works correctly afterward, the issue is almost certainly permission-related. Remove Administrator permissions afterward if they are not required.

Using /fixvoice

The /fixvoice command is Cloudy's built-in voice troubleshooting utility. Use it if Cloudy is stuck in a voice channel, connected but not playing music, or experiencing playback issues.

• •Run /fixvoice
• •Wait for Cloudy to refresh its voice connection
• •Start playback again using /play <song name>
• •Verify that Cloudy successfully joins the voice channel and begins playback.

In many cases, this command resolves voice-related issues instantly.

Using /forceleave

The /forceleave command forcibly disconnects the bot from its current voice channel. Use it when Cloudy is stuck, remains connected after playback ends, or normal disconnect commands fail.

• •Run /forceleave
• •Cloudy will immediately disconnect from the voice channel
• •Wait a few seconds for the voice session to reset
• •Run /join or /play <song name> to start a fresh session

Common Issues and Solutions

• •Cloudy is not responding — Verify Cloudy is online, check permissions, and restart Discord.
• •Commands are not showing — Restart Discord, wait for command synchronization, or reinvite Cloudy.
• •Commands are not updating — Wait for Discord to refresh command data or reinvite Cloudy.
• •Cloudy won't join a voice channel — Verify voice permissions, check channel restrictions, and use /join or /fixvoice.
• •Cloudy is stuck in a voice channel — Use /forceleave to disconnect Cloudy and start a fresh session.
• •Music is not playing — Check the queue, use /resume, and verify Cloudy is not muted.
• •No audio can be heard — Check volume settings, verify audio devices, and use /fixvoice.
• •Playback is lagging or stuttering — Use /rejoin, change the voice channel region, and check your internet connection.
• •Songs keep buffering — Try another song, reconnect Cloudy, or wait for the source service to recover.
• •Playlist won't load — Verify the playlist URL, check playlist visibility, and try again later.
• •Queue is empty — Add songs using /play or enable Autoplay if available.
• •Cloudy disconnects unexpectedly — Check voice channel permissions and reconnect using /join.
• •Control Panel is not working — Recreate the Control Panel using /setup and verify permissions.
• •Buttons in the Control Panel do not respond — Refresh the player session using /rejoin or recreate the Control Panel.
• •Premium features are unavailable — Verify your subscription status and ensure Premium is assigned to the correct server.
• •Premium role not received — Wait up to 45 minutes for verification and confirm your Discord account is linked correctly.
• •Cloudy joins but immediately leaves — Check channel limits, role restrictions, and voice permissions.
• •Cloudy appears offline — Verify Cloudy's status and check for service outages or maintenance announcements.
• •Cloudy cannot speak in the voice channel — Ensure Cloudy has the Speak permission and is not server-muted.
• •Wrong song is playing — Use /skip and search for the track again using a more specific query.
• •Playback stopped unexpectedly — Check the queue and restart playback using /play.

If your issue is not listed above, please contact the Cloudy Support Team and provide details about the problem, including any error messages or screenshots.

Still Need Help?

If none of the solutions above resolve your issue, please join the Cloudy Support Server and create a support ticket. When opening a ticket, include your Server or Guild ID (using /debug), the command you used, any error messages received, screenshots of the issue, and a detailed description of the problem. Providing this information helps the support team diagnose and resolve your issue more quickly.