Raid Rooms
This module creates private, temporary text or voice channels, such as a channel for a team coordinating during a MOBA match, and deletes them after an allotted time.
It suits small groups that need to talk privately for a short while, then disband and re-form later with different people.
A private group DM does something similar, with these drawbacks:
- Having to befriend all those that are involved in the group DM (this is only true for the creator of the group DM).
- Not having access to bots.
- Not having any kind of moderation or 3rd party control over what happens in the group DM.
To keep the group private, each raid room gets a password shared only with the room master (whoever created the room). Other users can enter only by knowing the password or by being invited by the room master.
Each user can create a maximum of 2 rooms at the same time on a server: 1 text room and 1 voice room.
Each raid room expires after the time set by the user (mods and admins can set a soft cap). When it expires, the channel is deleted automatically, and the room master gets warning messages beforehand.
When a text raid room expires, its chat log is dumped and saved encrypted, then posted in the raid rooms logger channel (see First Setup below).
One or more roles can be set as "supervisor" roles. Supervisors have moderation powers over raid rooms, similar to how moderators have powers over the rest of the server (see Supervisor Commands below).
Note
Premium: Out of the box, each server is limited to having a total of 3 simultaneous Raid Rooms. Base raises that to 10, Power to 20 (see Premium Perks).
First Setup
Upon first creation of a room, a "Raid Rooms" channel category is created. This category hosts all of the created raid rooms and the raid rooms logger channel.
This category and the logging channel are hidden from the rest of the server by default. Permissions for the supervisor roles are updated on each command run, and both the category and the logger channel are recreated on the next command run if they are deleted.
You can change the category and channel names, and move the logger channel to another category after it's created.
Note
All 15 room actions below live under one /raidroom command tree. Joining a room, and optionally setting a custom password on creation, use a short Discord form - see /raidroom create and /raidroom join below.
Note
The duration option below takes the standard time code (e.g. 1d3h2m) - or a Discord timestamp mention referring to a future time - described in Time Format Code.
Public Commands
/raidroom create
Command Syntax
/raidroom create [type:{text/voice}] [name:{room name}] [members:{room size}] [duration:{time code}] [custom-password:{true/false}] Command Description
Creates a new raid room. If custom-password is left as false (the default), a random password is generated and sent to the room master via DM. If custom-password is set to true, a form pops up where you type your own room name and password.
Use name to give the room a custom channel name, up to 100 characters. Surrounding and repeated spaces are trimmed, and names are unique within a server: if an active raid room already uses the same name (ignoring case), the create request is rejected so you can pick another. Without name, the room gets a generated name based on its room ID.
All parameters are optional. If omitted, type/members/duration use the server's default (see Administrator Commands below). If the server has no default values set, these are the overall defaults:
- Room Type: text
- Members: 4
- Duration: 1 hour
Members and duration also have a soft cap that can be set for the server. If the server has no soft cap values set, these are the overall defaults:
- Members: 8
- Duration: 1 day
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom create /raidroom create type:voice /raidroom create name:"Friday Raid Night" /raidroom create members:6 /raidroom create custom-password:true
/raidroom join
Command Syntax
/raidroom join room:{room id} Command Description
Join a room by knowing its ID. Running the command opens a form asking for the room's password, so it is never typed as a visible command argument and cannot leak into channel history.
The room option autocompletes against active rooms you can join.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom join room:abcdef
/raidroom leave
Command Syntax
/raidroom leave [room:{room id}] Command Description
Leave a specific room.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom leave room:abcdef
/raidroom status
Command Syntax
/raidroom status [room:{room id}] Command Description
Shows info about a room, given its room ID.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom status room:abcdef
Room Master Commands
After creating a room through /raidroom create, the user that opened the room becomes the "Room Master" and gets additional commands for managing the rooms they own.
Note
/raidroom close, /raidroom kick, /raidroom ban and /raidroom unban below also work for supervisors, on any active room, not only for the room's own master.
/raidroom invite
Command Syntax
/raidroom invite user:{user} [room:{room id}] Command Description
Invite a user to your room. They are added automatically without any action from the target user, and the password is not shared with them.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom invite room:abcdef user:@cycloptux
/raidroom close
Command Syntax
/raidroom close [room:{room id}] Command Description
Closes the room and deletes the corresponding channel. For text rooms, the chat log is dumped and saved encrypted, then posted in the raid rooms logger channel (see First Setup above).
If the room ID is omitted and the command runs inside a room, it applies to that room.
Note
A supervisor closing someone else's room this way still skips warning the room master beforehand.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom close room:abcdef
/raidroom password
Command Syntax
/raidroom password [room:{room id}] Command Description
Assigns a new random password to the room, useful if the password leaks. The new password is sent to the room master via DM.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom password room:abcdef
/raidroom kick
Command Syntax
/raidroom kick user:{user} [room:{room id}] Command Description
Kicks a user from a room (your own, or any room if you are a supervisor). Kicked users can re-join if they know the password or are invited again.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Note
Only one user per command run - run it again to kick more than one.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom kick room:abcdef user:@cycloptux
/raidroom ban
Command Syntax
/raidroom ban user:{user} [room:{room id}] Command Description
Bans a user from a room (your own, or any room if you are a supervisor). Banned users won't be able to re-join even if they know the password or are invited again.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Note
Only one user per command run - run it again to ban more than one.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom ban room:abcdef user:@cycloptux
/raidroom unban
Command Syntax
/raidroom unban user:{user} [room:{room id}] Command Description
Removes the ban on a user for the specified room (your own, or any room if you are a supervisor). A formerly banned user can then re-join if they know the password or are invited again.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Note
Only one user per command run - run it again to unban more than one.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom unban room:abcdef user:@cycloptux
/raidroom extend
Command Syntax
/raidroom extend [room:{room id}] Command Description
Extends the duration of a room that is about to expire. This command only works when there are less than 5 minutes left before the room's normal expiration.
The room timer is refreshed, adding the initial duration to the current time (e.g. if the room was set to last 24 hours, 24 more hours are added to that room).
This command can only be used once.
If the room ID is omitted and the command runs inside a room, it applies to that room.
Note
Server managers can still disable this command for the whole server, from the server's Raid Rooms page on the dashboard (see Administrator Commands below).
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom extend room:abcdef
Supervisor Commands
These commands can only be used by administrators and supervisors. To set one or more roles as supervisor roles, see Administrator Commands below.
/raidroom list
Command Syntax
/raidroom list
Command Description
Lists all active raid rooms in the server.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom list
/raidroom forbid
Command Syntax
/raidroom forbid user:{user} [reason:{text}] Command Description
Blocks a user from creating Raid Rooms. Existing rooms are not affected.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom forbid user:@cycloptux
/raidroom allow
Command Syntax
/raidroom allow user:{user} Command Description
Lifts the prohibition from a user, allowing them to create Raid Rooms again.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom allow user:@cycloptux
/raidroom forbidden
Command Syntax
/raidroom forbidden
Command Description
Lists the users that are currently forbidden from creating Raid Rooms in the current server.
Permissions Needed
- Bot: Manage Channels, Manage Messages
Examples
/raidroom forbidden
Administrator Commands
Administrators and server managers (users with "Manage Server" permission) configure raid room settings for their server, such as the supervisor roles, the default room parameters, and whether Room Masters can extend their own rooms, from the server's Raid Rooms page on the dashboard.
On the Dashboard
Your server's Raid Rooms page holds these settings:
- Supervisors - a multi-select of the roles that get supervisor powers over every room.
- Defaults - the default room type (Text or Voice) used when
/raidroom createis run with notypeoption. - Limits - Max Members and Default Members (numeric), plus Max Duration and Default Duration (interval inputs); these are the soft caps and defaults
/raidroom createfalls back on. - Extension - a toggle to disable
/raidroom extendfor Room Masters server-wide.
See also
Full migration mapping for these commands: Migration Guide.