Features

Complete reference for all Monvoke commands and features.

Commands

/invoke - LFG Command

The main command for creating basic recruitment posts.

Parameters

Parameter Required Description
schedule Optional Create a scheduled recruitment (format: DDHHMM / within 7 days)
image_url Optional Image URL to attach
color Optional Accent color of the recruitment message
background Optional Background image of the recruitment message

Modal Fields

Field Required Description
Title Optional Max 100 characters. Recruitment headline
Description Yes Max 1000 characters. Detailed description (multi-line supported)
Member Count Yes Number 1-50. Actual max is "input + host" (capped at 50)
Existing Users Optional Select users to add as members from the start
Mention Role Optional Select a role to mention when the recruitment is posted

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

Parameter Required Description
rating_type Optional Select a rating type (configured by server admin)
asymmetric Optional Select 1v4 (1 killer + 4 survivors) or 2v8 (2 killers + 8 survivors). Default is symmetric
schedule Optional Create a scheduled recruitment (format: DDHHMM / within 7 days)
image_url Optional Image URL to attach
color Optional Accent color of the recruitment message
background Optional Background image of the recruitment message

Modal Fields

Field Required Description
Title Optional Max 100 characters. Recruitment headline
Description Yes Max 1000 characters. Detailed description (multi-line supported)
Number of Players Yes How many players to recruit, not counting yourself. Odd numbers from 1 to 9 only (symmetric match only). The total including the host is split into two teams, so enter 7 for a 4v4. Not needed for asymmetric matches, where the count is fixed
Existing Users Optional Select users to add as members from the start
Mention Role Optional Select a role to mention when the recruitment is posted

Symmetric vs Asymmetric Match

Match Type Player Count Team Composition Suited For
Symmetric Odd number (1,3,5,7,9) + host Team A vs Team B FPS, MOBA, etc.
Asymmetric (1v4) Fixed 5 players Killer (1) vs Survivors (4) Dead by Daylight, etc.
Asymmetric (2v8) Fixed 10 players Killers (2) vs Survivors (8) Dead by Daylight 2v8, etc.

/preset - Run Preset

Quickly create recruitment from a saved preset.

Command Format

/preset name:preset_name [schedule:DDHHMM]

Parameters

Parameter Required Description
name Yes Preset name to run
schedule Optional Create as scheduled recruitment (format: DDHHMM / within 7 days)

How to Create a Preset

Presets are not created with a dedicated command — they are saved from an existing recruitment message. Press the ⚙️ 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.

Command Format

/preset-delete name:preset_name

Parameters

Parameter Required Description
name Yes Preset name to delete

/ranking - Leaderboard

Display the server rating leaderboard.

Command Format

/ranking

Features

Running the command displays an interactive leaderboard message.

Element Description
Dropdown Menu Select rating type to switch leaderboards
Pagination Buttons Navigate pages (20 players per page)
Check Rating Button View your own ratings across all rating types

Highlights

  • Rating Type Switching: Select from dropdown to instantly update the leaderboard
  • Pagination: Up to 100 players displayed, 20 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.

Setting Description
Default Image URL Default image URL for recruitment messages
Dedicated VC Category Set the category for dedicated VC creation
Auto Room Add/remove trigger channels and set VC name decorations (Free: 1 / Plus: up to 20 + ghost mode)
Rating Type Add, remove, and reset rating types in one modal
Timezone Timezone for scheduled recruitment time input (UTC offset)
Default Mention Set the default role to mention when a recruitment starts (empty to disable)
Recruitment-Only Channel Add/remove channels where regular messages are auto-deleted (Free: 1ch / Plus: 10ch)
Display Language Set a unified Bot display language for the server. Disable to revert to each user's client language
Background Images Register/delete background images for recruitment visuals (PNG, 1128×770px, max 3MB / Plus plan / max 10 images)
Recruitment Appearance Set the character and default background for recruitment images

/support - Community Support

Post a community support message to the channel.

Available on Plus plan servers only.

Command Format

/support

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 Auto Rooms. Convenient for sharing game IDs or friend codes.

Command Format

/id action:<register|check|delete> [id:<your_id>]

Options

Parameter Description Required
action Choose register, check, or delete Yes
id ID to register (register action only) Register only

Actions

Action Description
Register Register or update your ID
Check View your currently registered ID
Delete Delete your registered ID

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 when the specified number (including host) is reached
  • 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
  • Enter start time in DDHHMM format (e.g., 21:30 on the 7th → 072130) without separators
  • Can schedule up to 7 days in advance
  • 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)

Completes immediately when members reach the specified number (including host).

Member count: 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
Member count: 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 gets an action menu (VC creation, etc.).

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: Roles appear in the right column of the recruitment message

Quick Recruit

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

description@number

Connect your description and the number of members you want to recruit (excluding yourself) with @.

# Example: recruiting 3 members (4 total including yourself)
Let's play Apex@3

# Example: recruiting 4 members (5-member lobby)
Looking for ranked players@4

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.


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

/ranking
  1. Leaderboard message is displayed
  2. Select rating type from dropdown to view leaderboard
  3. 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

After recruitment completes, 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

  1. After recruitment completes, a select menu appears
  2. Host selects "Create Dedicated VC" or "Create Public VC"
  3. VC is created

VC Types

Type Access
Dedicated VC Only members can connect and speak
Public VC Anyone can connect

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.

Gather

Select "Gather" from the action menu after recruitment completes to move members who are connected to other VCs in the same server into the dedicated VC.


Auto Room

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: Random name like "{username}'s room"
  • Inherits the trigger channel's bitrate setting
  • 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

Setup

Select Auto Room from /config to open a modal where you can add/remove trigger channels and set VC name decorations.


ID Sharing

When you join a VC, registered IDs of all members are automatically displayed in the text channel.

How It Works

Whenever a member joins or leaves a dedicated VC or Auto Room, 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

How to Register

Register your ID with /id action:register id:Player#1234. 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


Auto Room Trigger Channel Setup

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

Select Auto Room from /config to open a modal where you can add/remove trigger channels, set VC name decorations, 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. Only slash commands can be used, keeping recruitment channels clean.

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

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 Disable to revert to each user's client language setting

Background Images

Plus plan only.

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

Recruitment Appearance

Select Recruitment Appearance from /config to set the character and default background displayed in recruitment images.

  • Character: Choose from Monvoke, Signboard, or None
  • Default background: Choose from registered background images or transparent

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.