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 three 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 |
guilds.join | Used once, on your first sign-in, to add you to the Cloudy community server |
Cloudy never asks for email, and it cannot read your messages through this login.
After signing in you land on the server selector. Only servers you can manage are listed — servers where you are a plain member do not appear at all. Each card is in one of two states, and the toolbar filter (All · Installed · Setup) narrows the list:
If a server you just created is missing, use the refresh button in the toolbar. The guild list is cached for about two minutes 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.
The invite link asks for Administrator, so every plugin works without any per-feature setup. If you would rather grant less, the table on Permissions & access lists what each feature needs — for example Manage Roles for reaction roles and verification, Manage Channels for temp voice and channel locks, Ban Members for moderation. A missing 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 creates one configuration row for the server — its slash commands are registered globally and are already there. 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 more than twenty 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.