CloudModDocs

Documentation

Everything you need to run CloudMod safely and efficiently for your community.

Quickstart

  1. 1Invite the bot to your serversInvite the CloudMod bot with the right permissions to your main and sub-servers.
  2. 2Sign in to the dashboardSign in with Discord — only identify and guilds, no email, no message access.
  3. 3Create a projectThe three-step wizard: main server, options, confirm.
  4. 4Add sub-servers and role rulesAdd sub-servers and create role rules with auto-matching in a single click.

How it works

5
What is a project?A self-contained configuration of a main server, sub-servers and rules.
Main server vs. sub-serverThe main server is the source of truth; sub-servers receive the sync.
The optional „Anchor role" on sub-serversWhen an anchor role makes sense — and when to leave it off.
Dry-Run vs Auto-FixTwo independent settings that control how aggressively the bot acts.
Bot language per projectSet log embeds and owner DMs to German or English per project.

Moderation & safety

9
Moderation: bans, word filter & auto-responsesNetwork-wide bans, a word filter with quarantine, automatic replies — plus the trusted-user whitelist.
Welcome messages & verificationGreet new members, and gate your server behind a one-click verify button.
Honeypot channel (anti-spam)A trap channel that catches spam bots — real users read first, bots post everywhere.
Scam Guard (anti-raid)Auto-action compromised accounts that mass-mention or flood channels — including image scams a word filter can't read.
Account age filterGate new joins by Discord account age — timeout, kick, ban or hold young accounts for review.
Raid AlertsDetect join-rate spikes, alert your team and optionally auto-lock the server until the wave passes.
Auto-responsesTrigger words that make the bot reply — with cooldowns, variables and per-server scope.
Bulk purgeClean a channel fast with /purge — filtered by member, keyword or bots only.
LoggingChoose what gets logged and route each category to its own channel.

Community

8
GiveawaysRun Discord giveaways with one-click entry, an automatic winner draw and reroll.
Events & sign-upsPost an event, members pick a role from your roster, full roles go to the bench.
BirthdaysMembers register their own birthday and the bot celebrates them on the day — with an optional role, an advance reminder and a leap-day rule.
Leveling & XPReward activity with XP, levels, reward roles and a leaderboard.
Invite trackingSee who invited whom — with a leaderboard, bonus invites and fake-account detection.
ReputationLet members thank your support team with +rep — and show a leaderboard.
StarboardEnough ⭐ reactions and the bot reposts a message to your highlight channel.
SuggestionsA suggestion box with voting and staff approve/deny buttons.

Tools

17
Custom commandsAdmin-curated trigger → reply commands with text or embeds, per-user cooldown and per-server scope.
Ticket BotButton panels that open private support channels — with claim, close and transcripts.
Applications & form panelsApplication forms via Discord modals, with review in the channel and in the dashboard.
Button-role panelsSelf-assign roles: members give themselves roles by clicking buttons.
Reaction rolesSelf-assign roles by reacting with an emoji.
Temp voice channelsJoin a lobby, get your own voice channel — with a control panel for its owner.
Timed rolesGive a role for 12h, 7d or 2w — CloudMod takes it back on time.
Sticky messagesKeep a note at the bottom of a channel — it re-posts itself whenever someone writes.
Channel automationsAuto-react to every post in a channel, and optionally open a thread on each one.
Channel mirrorCopy messages from one channel into others — across servers, with edits and deletes.
Stats channelsVoice channels whose name is a live counter — members, boosts, roles, channels.
Status rolesGive a role to members who put your invite in their Discord custom status.
Away & TimezoneMembers mark themselves away for a set time, and tell the server what time it is where they are.
RemindersLet members set their own reminders with /reminder — one-off or repeating.
Server profileGive the bot its own nickname, avatar and banner on each server.
Public network profileYour network in the public directory — with a server list and join buttons.
BrandingPut your own name, colour, logo and footer on the embeds the bot sends.

Integrations

4
Twitch live notificationsAutomatic live posts in Discord when your streamers go online.
Kick live notificationsAutomatic live posts in Discord when your Kick streamers go online.
YouTube notificationsAutomatic Discord posts when a tracked YouTube channel uploads a video or starts a livestream.
Spotify release notificationsPost an embed when an artist you track drops a new single or album.

Troubleshooting

5
Bot isn't reacting to my role changesThe three most common causes: hierarchy, missing invite, Dry-Run.
Nickname sync isn't working for some usersDiscord's hard-coded rules around owner nicknames and role hierarchy.
How do I test before going live?Use Dry-Run to test safely, then switch to Live.
Where do I find Discord IDs?Enable developer mode and copy IDs via right-click — if you need them at all.
Is the bot offline? How can I check?Quick check via the /status slash command or the public status page.

Pro tips

3
Use Auto-Fix only after stable mappingsKeep Dry-Run on until your rules are solid — then Auto-Fix keeps everything in sync.
Name your sub-roles consistently for auto-matchingA shared naming convention lets the mapping dialog pre-fill everything correctly.
Use the log channel for transparencyA real-time feed of every sync event on a moderator-only channel.