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

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 settings modal. Enter a name in the "Save as preset" field and submit 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 closes 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 and the recruitment closes. Recruitments with a scheduled time do not have the Start Now 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.

/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 IDs shared when joining VCs.

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

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 (schedule: DDHHMM)

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

• Stays in "recruiting" status until the specified start time
• The start time is interpreted in the timezone configured for the server (if unset, JST for users on a Japanese client and UTC for everyone else)
• Enter start time in DDHHMM format (e.g., 21:30 on the 7th → 072130) without separators. DD is the day of the month, not "days from now", and the month is not entered (the bot picks the nearest upcoming date in the current or next month)
• You can schedule up to one month ahead. This is the same on every plan. Entering a time beyond that range returns an error and no recruitment is created
• 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
• Members receive DM notifications when the start time arrives

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 Schedule)

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 modal. The title and description are pre-filled with the current values; edit them and submit, and the recruitment message updates in place. Fields left empty are not changed.

What You Can Edit

• Title and description: Replaced with what you submit
• 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)
• Save as preset: Saves this recruitment's settings as a preset

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

What You Cannot Edit

• Number of members, scheduled start time (schedule), and the Mention Role
• Attached image, accent color, and background image
• 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 Recruitment Settings. Selecting and clearing a role is available to members (not to Maybe or waitlisted members).

Note that for custom matches the gear icon disappears once the recruitment is full, so the title and description cannot be changed after teams are formed.

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.

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)

How to Use

The VC action menu appears on the recruitment message as soon as the recruitment is created. There is no need to wait for the recruitment to complete. The host can create the VC ahead of time and wait in it while people join.

If you create the VC while the recruitment is still open, anyone who joins the recruitment afterwards is automatically given permission to connect, and anyone who leaves has it removed (and is disconnected if they were in that VC).

1. A select menu appears on the recruitment message
2. The host selects an action from the menu
3. The selected action is performed

VC Action List

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

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 bring everyone together, they need to join the VC themselves from the recruitment message.

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

VC Types

Created VC Features

• Name: The recruitment title becomes the VC name. Text in [] and <> brackets is recognized as tags and automatically removed from 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.

Features

• User connects to trigger channel → VC is automatically created
• Automatically moved to the newly created VC
• VC name: Each trigger has a naming type. "Uniform" always names rooms "{username}'s Room", "Varied" picks randomly from several patterns like "{username}'s Hideout", and "Numbered" appends a number to the trigger channel's name, as in "{trigger}#1" and "{trigger}#2" (numbering continues from the highest number still present in the category, and gaps are not reused)
• Inherits the trigger channel's overview settings (bitrate, user limit, region override, video quality, and more)
• Creator is granted VC management permissions
• Auto-deleted when everyone leaves
• Multiple trigger channels can be configured (Free plan: 1 / Plus plan: up to 20)
• Each trigger can have a decoration (emoji prefix) for created VCs
• Ghost mode (Plus only): Personal VCs created via the trigger can be made private so only the creator can see them. Right after creation, an access settings message is posted in the VC's chat, where the creator can add users and roles allowed to view the channel

Setup

Select Autoroom from /config to open a modal where you can add/remove trigger channels, set VC name decorations and the naming type, and configure ghost mode (Plus only).

ID Sharing

When you join a VC, registered IDs of all members are automatically posted in that VC's own chat. (Not in a separate text channel — the message goes to the chat built into the voice channel.)

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 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 without registered IDs: Only username is shown

Auto-Update Triggers

• When a member joins the VC
• When a member leaves the VC

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.

Server Settings

Default Image Setting

Select Default Image URL from /config to set the default image displayed on all recruitment messages when no image is specified in the command.

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. Server default image
3. Monvoke default image

Dedicated VC Category Setup

Select Dedicated VC Category 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

You can register trigger channels. Free plan: 1 trigger, Plus plan: up to 20 triggers.

Select Autoroom from /config to open a modal where you can add/remove trigger channels, set VC name decorations and the naming type, 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 Channel 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 schedule parameter for scheduled recruitment.

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

If not set, Japanese client users default to JST, and all others default to UTC.

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 Appearance" below).

Select Background Images from /config 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.

Select Character Images from /config to replace the character shown in recruitment visuals with your own images. 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 Appearance, and selecting it applies your images.

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

Recruitment Appearance

Select Recruitment Appearance from /config to set the character and default background displayed in recruitment images. This setting is available on any plan.

• Character: Choose from Monvoke, Signboard, 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)
• Default background: Choose transparent, one of the 7 built-in backgrounds (Wall, Wasteland, Space, Forest, Playroom, Rainbow, Plaza), or a registered background image

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).

Icon Image

Plus plan only.

Select 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.