Skip to main content

Search GiselleBot's commands and docs.

Try /ban, or start with / for commands only.

Press Ctrl K anywhere in the dashboard to open this.

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:

  1. Having to befriend all those that are involved in the group DM (this is only true for the creator of the group DM).
  2. Not having access to bots.
  3. 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 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.

See also

Full migration mapping for these commands: Migration Guide.