Raid Rooms

This module allows users to create private, temporary text or voice channels for cooperation purposes, such as during cooperative play time on MOBA games, and then delete the voice channel/text channel after an allotted time.

Its best use case is giving a place to small groups of people that need to talk to each other privately for a short amount of time, then disband the group to later re-form another one with different people.

A similar situation can be achieved by setting up a private group DM, with the downsides of:

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.

In order to preserve the privacy of the group, each raid room will be assigned with a password that will only be shared with the room master (whoever created the room). Other users will only be able to enter the room by knowing the password, or being invited by the room master.

Each user can create a maximum of 2 rooms at the same time on a server: 1 text and 1 voice rooms.

Each raid room will expire after a set amount of time, as defined by the user (a soft cap can be set by the mods/admins). When that happens, the channel is automatically deleted. Warning messages will be sent to the room master before that happens.

When a text raid room expires, a chat log is dumped and saved (encrypted). The chat log will be posted into the raid rooms logger channel (see the First Setup section below).

One or more roles can be set as "supervisor" roles. Supervisors will have moderation powers over raid rooms, similar to how moderators have powers over the rest of the server (see the Supervisor Commands section below).

Note

Premium: Out of the box, each server is limited to having a total of 5 simultaneous Raid Rooms. If you want to remove this limitation, you can unlock the number of Raid Rooms as a Premium feature (see Premium Perks).

First Setup

Upon first creation of a room, a "Raid Rooms" channel category will be created. This category will host all of the created raid rooms and the raid rooms logger channel.

This category and the logging channel are hidden to the rest of the server by default. The corresponding permissions will be updated on each command run for the supervisor roles, and both the category and the logger channel will be 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, happen through a short Discord form - see /raidroom create and /raidroom join below for details.

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}] [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 letting you type your own password instead.

All parameters are optional. If omitted, type/members/duration will be set as the default for the server (see the Administrator Commands section below). If no default values are assigned for the specific server, the overall default values are:

Room Type: text
Members: 4
Duration: 1 hour

Both parameters have a soft cap that can be set for the server. If these soft cap values aren't assigned for the specific server, the overall default values are:

Members: 8
Duration: 1 day

Permissions Needed

Bot: Manage Channels, Manage Messages

Examples

/raidroom create
/raidroom create type:voice
/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's never typed as a visible command argument and can't 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 is executed inside an existing room, the action will be applied on the current room.

Permissions Needed

Bot: Manage Channels, Manage Messages

Examples

/raidroom leave room:abcdef

/raidroom status

Command Syntax

/raidroom status [room:{room id}]

Command Description

Obtain info about a room by knowing its room ID.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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 gains access to a set of additional commands used to manage the owned rooms.

Note

/raidroom close, /raidroom kick, /raidroom ban and /raidroom unban below also work for supervisors, on any active room, not just 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 will be automatically added without any interaction from the target user. The password won't be shared with the target user.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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, deleting the corresponding channel. If the room type was set as text, a chat log is dumped and saved (encrypted). The chat log will be posted into the raid rooms logger channel (see the First Setup section above).

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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 is somehow leaked. The new password will be sent to the room master via DM.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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 will be able to re-join the room if they know the password or are re-invited.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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 the room even if they know the password or are re-invited.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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

Lifts ban status from a user for the specified room (your own, or any room if you are a supervisor). A formerly banned user will now be able to re-join the room if they know the password or are re-invited.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current 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 can only be used when there are less than 5 minutes left on the normal expiration of a room.

The room timer will be refreshed, adding the initial duration to the current time (e.g. if the room was supposed to last 24 hours, 24 more hours will be added to that room).

This command can only be used once.

If the room ID is omitted and the command is executed inside an existing room, the action will be applied on the current room.

Note

Server managers can still prohibit the usage of this command from the server's Raid Rooms page on the dashboard (see the Administrator Commands section 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 assign one (or more) role(s) as supervisor roles, see the Administrator Commands section 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

Prohibits a user from creating Raid Rooms. This command won't break any existing room.

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 status 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" permissions) configure server-specific raid room settings - who the supervisor roles are, 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 is where the settings above are actually configured:

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 create is run with no type option.
Limits - Max Members and Default Members (numeric), plus Max Duration and Default Duration (interval inputs) - these are the soft caps and defaults /raidroom create falls back on.
Extension - a toggle to disable /raidroom extend for Room Masters server-wide.