Features

Commands

/invoke - LFG Command

The main command for creating basic recruitment posts.

Parameters

Modal Fields

After filling in the modal and submitting, a recruitment message is posted to the channel.

/custom - Ranked Matchmaking & Scrims

Create a custom match recruitment with automatic team balancing.

Parameters

Modal Fields

Symmetric vs Asymmetric Match

/preset - Run Preset

Quickly create recruitment from a saved preset.

Parameters

To make a recruitment created from a preset a scheduled recruitment, set the start time from the recruitment message after it is posted (see Editing a Recruitment).

How to Create a Preset

Presets are not created with a dedicated command — they are saved from an existing recruitment message. Press the gear icon button on a recruitment message created with /invoke or /custom to open the Recruitment Settings panel. Press "Save as preset" and enter a name to save that recruitment's settings as a preset.

You can save up to 1 preset on the Free plan and up to 20 on the Plus plan.

/preset-delete - Delete Preset

Delete a saved preset.

Only the preset creator or server admin can delete.

How to Delete

This command takes no parameters. Running it opens a modal where you pick which saved presets to delete. You can select more than one at a time.

/recurring - Recurring Posts

Run a saved preset automatically at a set time, every day or every week.

Parameters

Modal Fields (when creating)

Recruitments Created by a Recurring Post

The recruitment is posted in the channel where you ran the command. Its content matches the preset. The recruitment type depends on the start time: leave it empty and you get a player cap recruitment, set it and you get one that starts at that time on the day it is posted. Recruitments created by a recurring post carry a mark at the start of the footer.

When you set a start time: the recruitment message shows the scheduled start time, and once that time arrives the members are notified. If the recruitment is full at that point it completes; if there are open spots it stays open. To start earlier, the host can press Start Now from the gear icon button.

When you do not include yourself: the recruitment starts with no members and the host seat empty. The first person to press Join becomes the host and can then use the host-only actions such as Cancel, End, editing the settings, and creating VCs.

Deleting

Choosing delete for action opens a modal listing the registered recurring posts, and you can select more than one at a time. Server admins can delete any recurring post on the server, and everyone else can only delete the ones they registered.

Limits and Automatic Stops

• You can register 5 recurring posts on the Free plan and up to 20 on the Plus plan.
• Deleting a preset also deletes any recurring post that uses it.
• A recurring post stops after failing to post to its target channel three times in a row.
• A recurring post stops if the member who registered it with "Include yourself as a member" leaves the server.
• Stopped recurring posts never restart on their own. They appear as "Stopped" in the delete list, so remove them if you no longer need them.

/ranking - Leaderboard

Display the server rating leaderboard.

Features

Running the command displays an interactive leaderboard message.

Highlights

• Rating Type Switching: Select from dropdown to instantly update the leaderboard
• Pagination: Up to 100 players displayed, 10 per page
• Personal Rating: Click "Check Rating" to see your rank and rating for all rating types (with avatar thumbnail)
• Persistent: Buttons and dropdowns remain functional after Bot restart

/config - Server Settings

Requires the Administrator permission. Configure server-wide settings.

Settings List

After running the command, select a setting item from the menu. A modal will appear where you can enter the new values. Recruitment Image Settings is the exception: it opens a settings panel visible only to you instead of a modal.

/support - Community Support

Post a community support message to the channel.

Available on Plus plan servers only.

Features

Posts a community support announcement with a link to the Monvoke website and a button to the support page.

Server members can access the support page from the button to purchase Stars and contribute towards Plus plan fees.

/id - ID Sharing

Register and manage the IDs and profile link you share in VCs.

Registered IDs and your profile link are automatically displayed when you join dedicated VCs or Autorooms. Convenient for sharing game IDs or friend codes.

A profile link is a link to a Discord message where you wrote your profile. You can register one per server, and it is shown regardless of ID labels.

You can register a separate ID for each label. If your server has ID labels set up, the ID shown switches automatically depending on which VC you join (see ID Sharing for setup).

Options

Actions

Recruitment Details

Recruitment Types

Basic Recruitment

Best for "I want to gather X members right now" scenarios where you want to close as soon as the group is full.

• Automatically completes once the number you entered (how many players you want to gather, not counting yourself) have joined
• Perfect for spontaneous pickup games

Scheduled Recruitment (Enter a Start Time)

Best for "Let's play together at X time on Y day" scenarios where you want to recruit in advance.

• A player cap recruitment notifies members as soon as it fills up, while a scheduled recruitment notifies them at the start time. Even if it fills up before the start time, no notification is sent at that point
• The start time is interpreted in the timezone configured for the server (UTC if unset)
• In the "Start time" field of the modal shown when you create the recruitment, enter a time only (21:00, 2100, or 9pm), a month/day and time (09/03 21:00), a year-month-day and time (2026-09-03 21:00), or six digits for day, hour, and minute (032100 = 21:00 on the 3rd). A time only means the next time that hour comes (today, or tomorrow if it has already passed)
• You can schedule up to one month ahead
• The recruitment message's expiry is counted from the start time (24 hours on Free, 7 days on Plus), so scheduling far ahead never makes the post expire before it begins
• You can set reminders before the start. Choose any of 5, 10, or 30 minutes before, and members and Maybe members receive a DM notification at each selected time
• The start time and reminders can be set or changed from the recruitment message after it is posted (see Editing a Recruitment)

Join / Leave / Maybe

Recruitment messages display the following buttons:

Join Button

• Officially join the recruitment
• Added to member list
• If joined as maybe, converts to full join
• Cannot join if full

Leave Button

• Leave the recruitment
• Removed from member or maybe list
• The host (host) cannot leave

Maybe Button

• Register as maybe when participation is uncertain
• Does not count towards member count
• Use cases:
  • When you're not sure if you can join ("maybe")
  • When you want to be notified if the group is almost full

Maybe Notifications: When full members + maybe members reach the target count, maybe members receive a DM asking "Can you join?" (participation confirmation).

Important: Maybe does not reserve a spot. If all member slots are filled by other users while you're listed as maybe, you'll be treated as not participating at that point. If you want to join, switch to "Join" from the DM or recruitment message.

Cancel Button (Host Only)

• Cancel the recruitment
• All buttons become disabled

Waitlist Button (After Completion)

• Appears after recruitment is complete
• When a member leaves, the first person in the waitlist automatically gets promoted
• Use cases:
  • Join a full recruitment if a spot opens up
  • Register as a cancellation standby

Recruitment Completion

Basic (No Start Time)

The number of members you enter does not count you. Recruitment completes as soon as the member count reaches that number plus the host.

Number of members: 5 → Actual limit: 6 (host + 5)
When 6 members reached → Auto-complete

With Scheduled Start Time

Completes when the start time has passed AND the member count is reached.

Start time: 2024-12-31 20:00
Number of members: 5 → Actual limit: 6

Case 1: 6 members at 19:50 → Recruitment continues → Completes after 20:00
Case 2: 6 members at 20:10 → Completes immediately

After Completion

• All members receive a DM notification.
• The host can create a dedicated VC for the members from the VC action menu on the recruitment message.

Role Feature

Set and select roles within a recruitment.

How to Use Roles

1. At Creation: Host defines roles
2. After Joining: Members select a role from the dropdown
3. Display: The member list is grouped by role

Member Counts per Role

When adding a role, you can optionally set a minimum and a maximum number of members for it. While the count is short or over, a warning appears in the recruitment message.

These numbers are a guideline and do not restrict the recruitment. A recruitment completes even when the role counts are not met.

Groups

A recruitment that has roles can also have groups. Once you add a group, members pick both a role and a group, and the member list is split by group with a count next to each one. Use it when you are forming several parties of the same shape at once.

Short and over warnings are evaluated and shown per group as well.

Member counts per role are shared across every group. You cannot set different numbers for different groups.

Editing a Recruitment

After a recruitment is posted, the host can change its content directly from the recruitment message.

How to Edit

Press the gear icon button on the recruitment message to open the Recruitment Settings panel, which only you can see. Use its buttons and dropdowns, and the recruitment message updates in place.

What You Can Edit

• Edit Recruitment: Change the title, description, and start time. Clearing the title removes it, and a blank start time is left unchanged
• Add users: Adds the selected users as members (up to 25 at a time). Maybe and waitlisted members are moved to a full join
• Kick members: Removes the selected members from the recruitment (up to 25 at a time)
• Reminders: Choose when members and Maybe members get a DM before the start
• Start Now: Starts the recruitment without waiting for the start time or for it to fill (/invoke only)
• Save as preset: Enter a preset name to save this recruitment's settings as a preset

Roles and groups are added from the Select a role... dropdown below the recruitment message.

Start Time and Reminders

When the start time is set or changed, members and Maybe members are notified of the new start time by DM.

What You Cannot Edit

• Number of members and the Mention Role
• Attached image, accent color, background image, and display style (recruitment image or text)
• Removing or renaming roles and groups you have already added

To change any of these, cancel the recruitment and create a new one.

Who Can Edit

Only the host can open the Recruitment Settings panel. Selecting and clearing a role is available to members (not to Maybe or waitlisted members).

Quick LFG

Create a recruitment by simply sending a text message — no slash commands needed.

Perfect for users who find slash commands cumbersome, or when you want to post a recruitment quickly.

Format

Send a message in the form description@number of members. The number excludes yourself and must be 1-99. Use @0 to create an unlimited recruitment.

Text inside [ ] in the description becomes the title (e.g., [Ranked] Looking for Gold players@3).

Adding mentions

Mentions included in the same message are applied to the recruitment.

• Role mentions: notify that role about the recruitment (takes priority over the default mention configured via /config)
• User mentions: add those users as members from the start

• Mentions can go anywhere in the message — they are automatically removed from the description
• Bots, the organizer themselves, and users who are not in the server are not added
• If you mention more users than the recruitment has room for, the extras are not added

Requirements

• A recruitment-only channel must be configured before using this feature
• Run /config and choose Recruitment-only channels to set it up
• Only works inside the designated channel

If the description text matches a preset name, that preset will be used with only the member count overridden. If you add a role mention, however, the mentioned role takes priority over the preset's notification target.

Language of the recruitment message

This is decided differently from slash commands. If Display language is set in /config, that language is used. Otherwise the language is detected automatically from the description text you sent (falling back to English if detection fails), because a plain message does not expose the sender's client language.

Custom Match

Symmetric Match

Automatically splits members into Team A / Team B.

• Player count: Odd number (1,3,5,7,9) + host
• Rating-based: Alternating assignment by highest rating (team balancing)

Asymmetric Match (DbD, etc.)

Splits members into killer vs survivor configuration.

• 1v4 mode: 1 killer + 4 survivors (fixed 5 players)
• 2v8 mode: 2 killers + 8 survivors (fixed 10 players)
• Team assignment determined by random shuffle

ELO-based Matchmaking Algorithm

Fair team assignment considering ratings:

1. Sort members by rating (highest first)
2. Alternately assign to Team A / Team B
3. Minimize rating difference between teams

Completion Screen Actions

After a custom match completes, the host can perform the following actions:

• Shuffle: Randomly re-split teams
• Switch Team: Manually move a specific member to the other team

Match Result Reporting

After a custom match completes, the host can report the result.

• Options shown: "Team A wins" "Team B wins" etc.
• Rating Update: Member ratings are automatically updated after reporting
• Void Match: Can report as void if the match didn't complete

Rating System

Overview

• Ratings managed per rating type, per server, per user
• Rating types can be added by server admins via /config
• Initial rating: 1500 (Elo system)
• Automatically updated on match result reporting

Checking Ratings and Leaderboard

1. Run /ranking
2. Leaderboard message is displayed
3. Select rating type from dropdown to view leaderboard
4. Click "Check Rating" button to see your rating and rank for all rating types

Rating Reset (Admin Only)

Select Rating Type from /config and specify the type to reset in the modal. Resets all user ratings for that type to the initial value (1500).

VC Features

Dedicated VC Creation

From the moment a recruitment is created, the host can create a dedicated voice channel for members.

Prerequisites

• Bot has permission to create channels
• Setting a category ID via /config creates VCs in the specified category (if not set, VCs are created in the recruitment channel's category)

VC Action List

The menu is visible to everyone in the server, but only the host can use it.

Permission to connect to a dedicated VC is updated whenever the recruitment's members change.

Who gets moved: Only members already connected to some voice channel at the moment you press it. Members not in any VC stay where they are and receive no notification. To reach members who aren't in a VC, use Call to mention them from the VC's chat.

Bot permission required: Gather needs the Move Members permission. Without it, pressing the button does nothing and no error is shown.

Using Call: The recruitment must first have a VC linked through Create Dedicated VC, Create Public VC, or Link Current VC. Everyone in the recruitment who isn't in that VC is mentioned, including members sitting in other VCs; the host is excluded. Only the mentions are sent. If everyone is already in the VC, you'll see "All members are already in the VC."

VC Types

Created VC Features

• Name: The recruitment title becomes the VC name.
• Channel Management: The host is granted channel management permissions and can edit the channel overview tab (VC name, etc.).
• Auto Deletion: Automatically deleted when all members leave.

Autoroom

Connecting to a trigger channel automatically creates a personal VC for that user and moves them into it. The VC is deleted automatically once everyone leaves.

• The created VC inherits the trigger channel's settings (bitrate, user limit, and so on)
• The user who created the VC is given management permissions for it
• You can register multiple trigger channels (Free plan: 1 / Plus plan: up to 20)
• The VC naming style and decoration can be chosen per trigger channel
• Ghost mode (Plus only): Created VCs can be made private so only the creator can see them. Users and roles allowed to view the channel can be added later

Configure it from /config (see Autoroom Trigger Channel Setup).

ID Sharing

When you join a VC, registered IDs of all members are automatically posted in that VC's own chat.

How It Works

Whenever a member joins or leaves a dedicated VC or Autoroom, the ID list for all VC members is automatically updated. Pre-registering your ID and profile link with /id saves you from manually sharing friend codes or game IDs when joining a VC.

Display

• Members with registered IDs: Username and ID are shown
• Members with a registered profile link: A "Profile" link appears at the end of the line and takes you to the registered message (shown even without a registered ID)
• Members with neither an ID nor a profile link: Only username is shown

When there are many members and the list gets long, it is split into pages. Use the ⏪ / ⏩ buttons below the list to switch pages; the current page is shown between them, like "1 / 3".

Auto-Update Triggers

• When a member joins the VC
• When a member leaves the VC
• When you register or remove your profile link with /id (the list of the VC you are in)

Switching the Displayed ID (ID Labels)

Under /config → ID Labels, you can register labels with flags (comma-separated keywords, e.g. apex,apexlegends), up to 15 per server. When a VC is created, if a flag keyword appears in the title and description (or the trigger channel name for an Autoroom), only the IDs registered under that label are shown in the ID list. If no flag matches, the default ID (registered without a label) is shown.

Members pick a label when registering with /id, so each member can keep a separate ID per label. Set up one Autoroom trigger channel per game, and each room it creates will show only the IDs for that game.

How to Register

Run /id action:register and pick a label in the modal that opens, then enter your ID. See /id command for details.

Profile Link

On servers where each member writes an introduction message, you can link your introduction message in addition to your ID.

To register a profile link, run /id action:profile and paste the link to the message where you wrote your profile (get it with "Copy Message Link" in the message's menu).

Server Settings

Default Image Setting

In the Recruitment Image Settings panel from /config, press Default attachment image URL to set the image URL for the selected setting (the default settings or a named setting). The image is displayed on recruitment messages when no image is specified in the command. Setting an image per named setting is a Plus plan feature.

The image appears between the participant list and the buttons of the recruitment message (in /custom, after the team display and the VC link). It is also shown when the display style is Text.

Image URL Requirements

• Protocol: Must start with https://
• Extension: Must be .jpg, .jpeg, .png, .gif, or .webp
• Recommended Host: Discord CDN (https://cdn.discord.com/)

Image Priority

1. Image specified in command parameters
2. Image of the named setting assigned to the channel (Plus)
3. Image of the default settings

Dedicated VC Category Setup

Select Category for creating dedicated VCs from /config to choose the category where dedicated VCs are created. If not set, VCs are automatically created in the recruitment channel's category.

Required Bot Permission: Manage Channels

Autoroom Trigger Channel Setup

Select Add Autoroom or Autoroom Settings from /config to add or remove trigger channels, choose the VC naming style and decoration, and configure ghost mode (Plus only).

Required Bot Permissions: Manage Channels, Move Members

Recruitment-Only Channel Setup

In registered channels, regular user messages are automatically deleted, keeping recruitment channels clean.

These channels also enable Quick LFG — sending description@number of members creates a recruitment without a slash command. Quick LFG only works inside a registered channel, so this setup is required to use it.

Select Recruitment-only channels from /config to open a modal where you can add/remove channels.

Limit: Free plan 1ch / Plus plan 10ch

Rating Type Management

Adding rating types is a Plus plan feature. The Free plan uses only the built-in Default type (removing and resetting are available on any plan).

Select Rating Type from /config to open a modal where you can add, remove, and reset rating types in one place.

Check registered rating types: View them in the /ranking command dropdown menu.

Timezone Setting

Set which timezone is used to interpret the start time entered for scheduled recruitment.

Select Timezone from /config and enter a UTC offset (e.g., +1). Leave blank to reset.

If not set, UTC is used.

Display Language Setting

Select Display Language from /config to set a unified Bot display language for the entire server.

• Available: English, Japanese, French, German, Korean, Portuguese (Brazil), Russian
• Select Auto (command executor's language) to revert to each user's client language setting

Background Images

Registering your own images as backgrounds is a Plus plan feature. The 7 built-in backgrounds do not require Plus (see "Recruitment Image Settings" below).

In the Recruitment Image Settings panel from /config, press Background Image Management to register or delete PNG images used as backgrounds for recruitment visuals.

• Format & size: PNG, 1128×770px, max 3MB
• Limit: Up to 10 images per server
• You can optionally set a name and flags (comma-separated) when registering an image

Character Images

Plus plan only.

In the Recruitment Image Settings panel from /config, press Character Image Management to replace the character shown in recruitment visuals with your own images. Use your server's mascot character to make recruitment feel more special to your community. You register one image each for recruiting, full and ended, and they switch automatically as the recruitment changes state.

Once registered, Custom is added to the character options under Recruitment Image Settings, and selecting it applies your images.

For how to create the images and downloadable templates, see the Character Image Creation Guide.

Recruitment Image Settings

Select Recruitment Image Settings from /config to open a settings panel where you can set the display style, the character, user icons, and default background for recruitment images, and the color. The default settings are available on any plan.

In the panel, pick a setting from Select a setting to edit... and press Edit Appearance to change the following items.

• Display Style: Choose Recruitment Image or Text. With Text, no recruitment image is created and the title and description are shown as text
• Character: Choose from Monvoke, Sign, or None. Servers with registered character images can also choose Custom. With anything other than None, the character switches automatically between the recruiting, full, and finished states (on any plan)
• User Icons: Choose whether to show participants' icons in the recruitment image (Show or Hide)
• Default Background: Choose transparent, one of the 7 built-in backgrounds (Wall, Wasteland, Space, Forest, Playroom, Rainbow, Plaza), or a registered background image
• Color: Choose the color of the line on the left edge of the recruitment message

The 7 built-in backgrounds are available to every server. The Plus plan is only required to register your own images as backgrounds (see "Background Images" above).

Press Preview to receive a sample of the whole recruitment message, including its buttons, as a separate message. Saving the settings alone does not show a sample.

Different Settings per Channel (Plus plan)

On the Plus plan, you can create up to 5 named settings in addition to the default settings and use a different look per channel.

• Press Create New to create a named setting (names can be up to 30 characters).
• Use Select channels that use this setting... to assign channels to it. Recruitments created in threads or forum posts within those channels use the same setting.
• Channels without an assignment use the default settings.
• Items left unselected in a named setting use the values of the default settings.
• When the Plus plan ends, named settings are no longer used (you can still delete them).

Icon Image

Plus plan only.

Select Register or Reset Icon Image from /config to replace the icon of Monvoke shown on this server with your own image. Only the display on the server where it is set changes; other servers are not affected.

Data Management

Data Deletion on Server Leave

When the Bot is kicked or banned from a server, all data for that server is automatically deleted.

What Gets Deleted

• Recruitment data (both active and completed)
• User rating data
• Settings configured via /config (default images, VC category, etc.)
• Registered rating types

What Is Preserved

• Monvoke website server registration
• Plus subscription

If the Bot is re-invited, the Plus plan carries over, but ratings and settings start fresh.