Getting Cloudy onto a server takes about a minute. You need to be able to manage the server — see Permissions & access for exactly what that means.
Open usecloudy.xyz and click Sign in. Authentication is Discord OAuth — there is no separate Cloudy password. Cloudy asks for two scopes:
| Scope | Why it is needed |
|---|---|
identify | Your user id, name and avatar for the dashboard header |
guilds | The list of servers you are in, so the dashboard can show which ones you may configure |
Cloudy never asks for email, and it cannot read your messages through this login.
After signing in you land on the server selector. Every server you can manage is listed, split by state:
If a server you just created is missing, use the refresh button in the toolbar. The guild list is cached for a short while to stay inside Discord's rate limits.
Set up Cloudy opens Discord's authorisation screen with the target server preselected. Confirm it, and Discord adds the bot.
Keep the permissions Cloudy requests. They are the union of what the plugins need — for example Manage Roles for reaction roles and verification, Manage Channels for temp voice and channel locks, Ban Members for moderation. Stripping a permission does not break the dashboard; it makes the matching feature fail silently at runtime, which is much harder to debug later.
Back in the selector, the server now shows as installed. Open it and you land on the overview with member counts, channels, roles and server info. The sidebar on the left holds everything else.
Nothing that changes your server. On join, Cloudy registers its slash commands and creates one configuration row for the server. Every plugin starts disabled, no messages are posted, no roles are touched, no channels are created.
Kick or ban the bot from Discord like any other member. Your configuration survives — re-inviting Cloudy restores every setting exactly as it was.
To wipe the configuration as well, use Reset settings & data on the Server defaults page before removing the bot.
Introduction
Cloudy is a modular Discord bot with 21 plugins that you configure entirely from the web dashboard. This handbook documents every plugin and every single setting.
Permissions & access
Who is allowed to open the dashboard, and which Discord permission each Cloudy feature actually needs at runtime.