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
DDHHMMformat (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
- At Creation: Host defines roles
- After Joining: Members select a role from the dropdown
- 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
/configand 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:
- Sort members by rating (highest first)
- Alternately assign to Team A / Team B
- 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
- Leaderboard message is displayed
- Select rating type from dropdown to view leaderboard
- 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
/configcreates VCs in the specified category (if not set, VCs are created in the recruitment channel's category)
How to Use
- After recruitment completes, a select menu appears
- Host selects "Create Dedicated VC" or "Create Public VC"
- 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
- Image specified in command parameters
- Server default image
- 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.