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.

Cloudy is a Discord bot that you never have to configure through chat commands. Everything — moderation rules, welcome messages, ticket panels, the economy, stream alerts — is set up in the web dashboard at usecloudy.xyz, and the bot picks the changes up within seconds.

This handbook is the complete reference. Every plugin has its own page, and on that page every single field is documented: what it does, what it accepts, what the default is, and what happens at the edges.

How Cloudy is put together

Cloudy is not one monolithic bot with a hundred commands. It is a set of plugins that you switch on individually per server. A plugin that is off costs nothing: it registers no commands, listens to no events, and writes no data.

There are five categories, mirrored 1:1 in the dashboard sidebar:

CategoryPluginsWhat they cover
ModerationModeration, AutoMod, Mod Logs, Verification, TicketsKeeping the server safe and auditable
EngagementWelcome & Goodbye, Leveling, Birthdays, Polls, Giveaways, Reaction RolesGetting members to participate
Games & EconomyEconomy, Animals, Custom GamesVirtual currency, pets, match queues
UtilityEmbed Messages, Automations, Custom Commands, Temp Voice, RemindersEveryday server plumbing
IntegrationsTwitch, Kick, YouTubeNotifications from outside Discord

Three concepts worth learning first

Almost every page in this handbook builds on three ideas. Reading these once will save you from re-reading them twenty times.

Every plugin has a master switch

The toggle in the page header is separate from the settings below it. Turning a plugin off keeps all of its configuration — it simply stops running. This matters for premium: when a license expires, your settings are untouched and come back exactly as they were the moment you renew.

Read more in Plugins & toggles.

Changes are staged, then saved

Editing a field marks the page dirty and a save bar appears at the bottom. Nothing reaches the bot until you press Save. Leaving the page with unsaved changes asks for confirmation.

Read more in Saving & syncing.

Messages support placeholders

Text fields like the welcome message or a custom command response accept placeholders such as {user} and {server}, which the bot replaces per message. Which placeholders are available depends on the plugin — each plugin page lists its own.

Read more in Placeholders.

Free vs. Premium

Four plugins are free on every server, forever:

  • Welcome & Goodbye
  • Embed Messages
  • Reminders
  • Reaction Roles

Everything else needs an active premium license on that server. A license belongs to you, not to the server — you can move it between servers whenever you want. See Premium for the full model.

Premium is enforced by the bot as well as the dashboard. A plugin that is enabled but unlicensed shows as inactive and does nothing at runtime.

Where to go next