Features

Commands

/invoke - LFG Command

The main command for creating basic recruitment posts.

Parameters

Modal Fields

When raid mode (raid:enabled) is specified, the player count input becomes optional. Enter a number for a capped raid, or leave it blank for unlimited mode (no player cap). In raid mode, recruitment starts in "completed" state immediately, allowing anyone to join freely (no waitlist).

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

Examples

# Basic recruitment
/invoke

# Schedule for a specific time (e.g., Jan 7 21:30)
/invoke schedule:01072130

# Raid mode (starts completed, free join. Blank for unlimited, enter number for cap)
/invoke raid:enabled

# Recruitment with image
/invoke image_url:https://cdn.discord.com/attachments/.../image.png

/custom - Ranked Matchmaking & Scrims

Create a custom match recruitment with automatic team balancing.

Parameters

Modal Fields

Symmetric vs Asymmetric Match

Examples

# Basic custom match (symmetric)
/custom

# With rating type
/custom rating_type:Valorant

# Asymmetric match 1v4 (DbD, etc.)
/custom asymmetric:1v4

# Asymmetric match 2v8 (DbD 2v8 mode, etc.)
/custom asymmetric:2v8

# Schedule for a specific time (e.g., Jan 7 21:30)
/custom schedule:01072130

/preset - Run Preset

Quickly create recruitment from a saved preset.

Command Format

/preset name:preset_name [schedule:MMDDHHMM]

Parameters

Examples

# Create from preset
/preset name:Ranked5v5

# Preset + scheduled
/preset name:Ranked5v5 schedule:01072130

/preset-create - Create Preset

Save recruitment settings as a preset.

Up to 1 preset per server on Free plan, up to 20 on Plus plan.

Command Format

/preset-create type:invoke|custom [mention:@role] [roles:role1,role2] [start_image_url:url] [end_image_url:url] [raid:enabled] [rating_type:type] [asymmetric:1v4|2v8]

Parameters

After running the command, a modal appears. Enter the preset name, title, description, and player count to save.

Examples

# Create invoke preset
/preset-create type:invoke mention:@Gamers

# Invoke preset with roles
/preset-create type:invoke mention:@Gamers roles:Tank,Healer,DPS

# Custom match preset (asymmetric 1v4)
/preset-create type:custom rating_type:DbD asymmetric:1v4

/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

Examples

# Delete a preset
/preset-delete name:Ranked5v5

/ranking - Leaderboard

Display the server rating leaderboard.

Plus plan feature.

Command Format

/ranking

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, 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

Examples

# Display leaderboard
/ranking

# After display, select rating type from dropdown
# Click "Check Rating" button to view your stats

/config - Server Settings

Admin-only command. 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.

Examples

# Open settings (select a setting item from the menu)
/config

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

Examples

# Post community support announcement
/support

/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

Actions

Examples

# Register an ID
/id action:register id:Player#1234

# Check your registered ID
/id action:check

# Delete your ID
/id action:delete

/join - Start TTS

Invites the Bot to your VC to start reading messages aloud.

Plus plan only.

Command Format

/join

How It Works

Once executed, the Bot joins your current voice channel and reads out messages posted in that VC's text channel one by one. Messages exceeding 200 characters are skipped.

Examples

# Start text-to-speech
/join

/leave - Stop TTS

Disconnects the Bot from the VC and stops text-to-speech.

Plus plan only.

Command Format

/leave

Examples

# Stop text-to-speech
/leave

/voice - Set TTS Voice

Set the TTS voice used for your own messages.

Plus plan only.

Command Format

/voice voice:<voice_name>

Parameters

Your personal setting takes priority over the server's default voice. The server default can be changed with /config.

Examples

# Set your TTS voice
/voice voice:Ara

Recruitment Details

Recruitment Types

Basic Recruitment

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

• Automatically completes when the specified number (including organizer) is reached
• Perfect for spontaneous pickup games

Scheduled Recruitment (schedule: MMDDHHMM)

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 MMDDHHMM format (e.g., Jan 7 21:30 → 01072130) without separators
• Can schedule up to 7 days in advance
• Participants 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 participant list
• If joined as maybe, converts to full join
• Cannot join if full

Leave Button

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

Maybe Button

• Register as maybe when participation is uncertain
• Does not count towards participant 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 participants + maybe participants reach the target count, maybe members receive a DM asking "Can you join?" (participation confirmation).

Important: Maybe does not reserve a spot. If all participant 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 (Organizer Only)

• Cancel the recruitment
• All buttons become disabled

Waitlist Button (After Completion)

• Appears after recruitment is complete
• When a participant 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 participants reach the specified number (including organizer).

Player count: 5 → Actual limit: 6 (organizer + 5)
When 6 participants reached → Auto-complete

With Scheduled Start Time

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

Start time: 2024-12-31 20:00
Player count: 5 → Actual limit: 6

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

After Completion

• All participants receive a DM notification.
• The organizer gets an action menu (VC creation, etc.).

Role Feature

Set and select roles within a recruitment.

How to Use Roles

1. At Creation: Organizer defines roles
2. After Joining: Participants 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 players you want to recruit (excluding yourself) with @.

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

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

Requirements

• A recruitment-only channel must be configured before using this feature
• Set it up via the /config command under the recruit_channel option
• Only works inside the designated channel

If the description text matches a preset name, that preset will be used with only the player count overridden.

Custom Match

Symmetric Match

Automatically splits participants into Team A / Team B.

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

Asymmetric Match (DbD, etc.)

Splits participants 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 participants 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 organizer can perform the following actions:

• Shuffle: Randomly re-split teams
• Change Teams: Manually move a specific player to the other team
• All to VC: Move all participants to the same voice channel

Match Result Reporting

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

• Options shown: "Team A wins" "Team B wins" etc.
• Rating Update: Participant 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 organizer can create a dedicated voice channel for participants.

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. Organizer selects "Create Dedicated VC" or "Create Public VC"
3. VC is created

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 organizer 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 participants 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.

Text-to-Speech

Plus plan only. When the Bot joins a voice channel, it reads out messages posted in that VC's text channel using high-quality synthesized speech.

Eligible Messages

• Messages up to 200 characters are read aloud.
• Messages exceeding 200 characters are skipped.

Voice Selection

The voice used for reading is determined by the following priority:

1. User setting: Set your personal voice with the /voice command.
2. Server default: Change the server-wide default voice via /config.
3. System default: Applied when neither of the above is configured.

Language Setting and Accuracy

Language is detected automatically, but you can specify the server's reading language explicitly via /config for higher accuracy. It is recommended to set the language that matches your server's primary language.

Monthly Character Limit

Each server can read up to 75,000 characters per month. Messages that would exceed the limit are skipped.

Usage resets on the subscription renewal date.

How to Use

1. Join a voice channel and run /join to invite the Bot
2. Messages posted in the VC's text channel will be read out in order
3. Run /leave to stop text-to-speech

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