Timed roles

For everything that should end on its own: event access, a trial moderator, a giveaway winner's perk.

Alpha — new; tell us if something looks off.

Commands

/temprole add member:@Ada role:@Event duration:12h reason:Summer event
/temprole remove member:@Ada role:@Event
/temprole list member:@Ada

duration understands s, m, h, d and w — for example 90m, 12h, 7d, 2w, or combined like 1w 12h. It must be between 1 minute and 365 days.

reason is optional and shows up in /temprole list. Leave out member in list to see every timed role on the server.

remove takes the role back right away. To only cancel the timer and leave the role in place, add keep:True:

/temprole remove member:@Ada role:@Event keep:True

The role then stays until someone removes it manually.

Settings

The Timed Roles page has these options:

• a Default duration, so /temprole add can be used without typing one,
• Log expiries — write a line to your log channel whenever a role runs out,
• an Overview channel (see below),
• Reminders for your team (see below).

Overview channel

Pick a channel and CloudMod keeps one message there that lists every running timed role — who has it, which role, and when it runs out:

@Ada · @Event · expires in 3 hours · 26 September 2026 21:00
@Linus · @Trial Mod · expires in 6 days · 2 October 2026 18:30

• The soonest expiry is at the top.
• The countdowns are Discord timestamps, so they tick down live in everyone's client — in their own time zone.
• The message is edited whenever a timed role is given, extended, removed or expires, and refreshed every ten minutes. If someone deletes it, CloudMod posts it again.
• Nobody is pinged: mentions inside the list never notify anyone.
• A very long list is split over a few messages; beyond five, the rest is counted instead of shown.
• Remove the channel (or switch the plugin off) and CloudMod deletes the overview message.

Best in a channel members can read but not write in, so the list stays on top.

Reminders for your team

CloudMod can remind your team before a timed role runs out — so someone can extend it in time. Set it up on the Timed Roles page:

• Reminder channel — where the reminders go. Without a channel there are no reminders.
• Role to ping — the team role that gets pinged. Leave it on the default to ping the admin role from the project settings. Only that role is pinged, never the members whose role runs out.
• Remind before expiry — 1 day, 6 hours, 4 hours, 2 hours, 30 minutes and 10 minutes. All are on by default; untick the ones you don't need.

A reminder looks like this:

⏰ @Mods — @Ada's Event expires in 2 hours (26 September 2026 21

).

Good to know:

• Each reminder is sent once per timed role, also across restarts.
• Shorter roles skip steps that were already past when the role was given. A 12-hour role never gets the one-day reminder.
• Extending a role starts over: giving the same role again with a new duration brings the reminders back for the new end.
• After downtime, CloudMod sends only the latest missed reminder instead of all of them at once.
• If several roles reach a step in the same minute, they arrive as one message with a list.

How many roles you can run at once

Your plan limits how many different roles can be timed at the same time. One event role can go to as many members as you like — it still counts once.

Good to know

• /temprole needs Manage Roles and only works on your main server.
• Expiry is checked once a minute, so a role can outlive its deadline by up to a minute.
• Expiry survives restarts: the deadline is saved, and CloudMod catches up on anything that expired while it was offline.
• If CloudMod loses the permission to remove the role, it keeps the timer and tries again after ten minutes instead of forgetting it.
• The role must sit below the CloudMod role. Roles managed by an integration (Server Booster, Twitch subs) cannot be assigned by any bot.
• If the member left the server, the timer is simply dropped.

Requirement: Manage Roles. The overview also needs Send Messages and Embed Links in its channel, the reminders need Send Messages.