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 projectRun /setup straight from Discord, or use the dashboard wizard — pick the main server, set the basics and options, check, create.
  4. 4Add sub-servers and role rulesAdd sub-servers and build role rules that give or take roles across your network.

How it works

9
What is a project?A self-contained configuration of a main server, sub-servers and rules.
How a subscription finds its networkOne subscription covers one network: how CloudMod picks which one, how to move it, and what happens when a plan drops.
Main server vs. sub-serverThe main server is the source of truth; sub-servers receive the sync.
Connections to other serversLet members of someone else's server get roles on yours — or hand out roles on theirs — without sharing a project.
How the sync worksWhat triggers a role or nickname sync, how fast it happens, and what the periodic check does.
Nickname syncHow CloudMod keeps a member's nickname the same on every server of your network — when it happens, what it leaves alone, and how to switch it on or off.
The optional anchor role on sub-serversWhen an anchor role makes sense — and when to leave it off.
Dry-Run vs Auto-FixTwo independent network settings that control how aggressively the bot acts.
Bot languageWhich language the bot and the dashboard speak, where you choose it, and what is never translated.

Moderation & safety

10
Moderation: bans, word filter & auto-responsesNetwork-wide bans, a word filter with quarantine, automatic replies — plus the trusted-user whitelist.
Welcome messagesGreet new members with a message or image banner, say goodbye, thank boosters and celebrate milestones.
Verification GateGate your server behind a one-click verify button: new members get an unverified role on join, the button swaps it for the verified role.
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 raise the server's verification level to High until you lower it again.
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

9
GiveawaysRun Discord giveaways with one-click entry, an automatic winner draw and reroll.
Events & sign-upsPost an event, members pick a role from your line-up, 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.
CountingA counting game for your community — five modes, per-channel rules, streaks and a leaderboard.
StarboardEnough ⭐ reactions and the bot reposts a message to your highlight channel.
SuggestionsA suggestion box with voting, a submit button and optional team review.

Tools

18
Custom commandsAdmin-curated trigger → reply commands with text or embeds, per-user cooldown and per-server scope.
Ticket BotButton, topic-menu or topic-button panels that open private support channels — with templates, claim, close, transcripts, reminders and team stats.
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.
Team dashboardGive your staff their own page at team.cloudmod.io. They sign in with Discord, Discord roles decide who gets in, and they lead the team, handle users and applications and see how the team is doing.

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 four most common causes: hierarchy, missing invite or permission, Dry-run, a paused network.
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 preview cross-server role sync 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, the member list or the public status page.

Pro tips

3
Use Auto-Fix only after stable rulesKeep Dry-Run on until your rules are solid — then Auto-Fix keeps everything in sync.
Use the same role names on every serverMatching role names make building Role Rules across your network fast.
Use the log channel for transparencyA real-time feed of every sync event on a moderator-only channel.