1. Login to DLobby #

Login to DLobby by authenticating through Discord with the "Login with Discord" button.


2. Find your server #

Locate your server in the list that appears. Click the "setup guild" link for your desired server.

Only servers in which you have the MANAGE_GUILD or ADMINISTRATOR permissions will show.


3. Install the DLobby integration #

Follow the instructions on the DLobby setup page by clicking the "install dlobby integration" link.


4. Select a lobby channel #

Select a forum channel in the Discord server for DLobby to use. In this channel, DLobby will spawn a new thread every time a server member executes the /dlobby create slash command to start a new lobby.

We recommend that only DLobby have the MANAGE_THREADS permission on this particular channel, to ensure that server members don't accidentally create or delete existing lobbies.


5. Add command options #

Command options are fields that you (the server admin) create in which the server member fills when they execute the command to create a lobby.

Command options can be a free form text field, selecting from a predetermined list of text, roles, channels, or a yes/no field.

Select the "Add a command option" link at the bottom. DLobby will walk you through creating one command option. Discord allows up to a maximum of 25 command options.

See Command Options for more information about the available kinds of command options available.

Some command option examples:

  • A server has a role for different fighting games that its members play. Create a "game" command option so that the member can make a note to others what game they're playing.

  • A server has a number of voice channels set aside for gaming chat. Create a command option called "voice" so that members know which voice channel is being used by this lobby.


6. Edit the message template #

The message template is what DLobby writes as the first message in each created lobby.

The values that a member passes in to your defined command options get populated into the message template. DLobby uses the Liquid templating engine to render the message into the lobby. The name of each command option is available as a Liquid variable within the message template.

Liquid tl;dr #

Use the following snippet for a required command option. Say you had a command option called "game" of role kind:

game: {{ game }}

Use the following snippet for non-required command options. Say you had a command option called "voice" of channel kind:

{% if voice -%}
voice: {{ voice }}
{% endif -%}

Let's put it all together.

Example:

Say we have the same two command options defined as describe directly above ("game" and "voice").

We would define the message template as:

game: {{ game }}
{% if voice -%}
voice: {{ voice }}
{% endif -%}

When a server member creates a lobby with this command:

/dlobby create lobby-title:"Let's go hunting!" game:"MHGU"

This would result in an opening lobby message of:

game: @MHGU

The thread's title will be "Let's go hunting!". The "MHGU" role will result in a mention of that role and the "voice-01" channel portion is excluded (though it would result in a channel link if included).


7. Upload your command options to Discord #

When you have finished editing command options for a given Discord server, click the "Upload commands" button.

Commands need to be uploaded to Discord any time you make changes. If the "upload commands" button is visible, you have unsaved changes that have not been uploaded to Discord.


Please let us know if you have discovered an error on this page, or have an edit suggestion.