Features

Commands

/invoke - Recruitment Command

The main command for creating basic recruitment posts.

Command Format

/invoke [schedule:MMDDHHMM] [mention:@role] [start_image_url:image_url] [end_image_url:image_url] [raid:enabled]

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

# Mention a role
/invoke mention:@RaidMembers

# 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 start_image_url:https://cdn.discord.com/attachments/.../image.png

/custom - Custom Match Recruitment

Create a custom match recruitment with automatic team balancing.

Plus plan feature.

Command Format

/custom [game_type:game_type] [asymmetric:enabled] [mention:@role] [start_image_url:image_url] [end_image_url:image_url]

Parameters

Symmetric vs Asymmetric Match

Examples

# Basic custom match (symmetric)
/custom

# With game type
/custom game_type:Valorant

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

/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 10 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] [game_type:type] [asymmetric:enabled]

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)
/preset-create type:custom game_type:DbD asymmetric:enabled

/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

• Game 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 game types (with avatar thumbnail)
• Persistent: Buttons and dropdowns remain functional after Bot restart

Examples

# Display leaderboard
/ranking

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

/config - Server Settings

Admin-only command. Configure server-wide settings.

Settings List

For image URL settings, use none to remove the image, or reset to restore the default.

Examples

# Set default image
/config setting:default_recruitment_image value:https://cdn.discord.com/.../image.png

# Add a game type
/config setting:add_game_type value:Valorant

# Reset ratings
/config setting:reset_rating value:Valorant

# Set timezone (JST)
/config setting:timezone value:+9

/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

/language - Server Language Setting

Set a unified Bot display language for the entire server.

Requires admin permissions.

Command Format

/language language:<language_name|Disable>

Parameters

Available Languages

• English
• Japanese
• French
• German
• Korean
• Portuguese (Brazil)
• Disable (revert to each user's client language)

Once set, all Bot responses, recruitment messages, and related features in the server will use the specified language. Selecting Disable reverts to normal behavior (based on each user's client language).

Examples

# Set server language to English
/language language:English

# Set server language to Japanese
/language language:Japanese

# Disable override (use each user's client language)
/language language:Disable

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

Recruitment messages display the following buttons:

Join Button

• Officially join the recruitment
• Added to participant list
• If tentatively joined, converts to full join
• Cannot join if full

Leave Button

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

Tentative Button

• Register as tentative 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

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

Important: Tentative join does not reserve a spot. If all participant slots are filled by other users while you're tentative, 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

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 into Solo (1) vs Team (4).

• Fixed 5 players: Solo 1 + Team 4
• Organizer defaults to Solo side
• Buttons: "Solo" "Team" "Tentative" "Leave" "Cancel"

Team Balancing Logic

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

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 game type, per server, per user
• Game 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 game type from dropdown to view leaderboard
3. Click "Check Rating" button to see your rating and rank for all game types

Rating Reset (Admin Only)

/config setting:reset_rating value:Valorant

Resets all user ratings for the specified game 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

Plus plan feature. 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 (max 10)
• Each trigger can have a decoration (emoji prefix) for created VCs

Setup

# Add a trigger channel
/config setting:add_autoroom_trigger value:<voice_channel_id>

# Remove a trigger channel
/config setting:remove_autoroom_trigger value:<voice_channel_id>

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 Settings

Configure default images displayed on recruitment messages. You can set different images for active and completed recruitment.

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

/config setting:vc_category_id value:<category_id>

Setting a category ID creates VCs in the specified category. If not set, VCs are automatically created in the recruitment channel's category.

Required Bot Permission: Manage Channels

Auto Room Trigger Channel Setup

Plus plan feature. You can register multiple trigger channels (max 10).

# Add a trigger channel
/config setting:add_autoroom_trigger value:<voice_channel_id>

# Remove a trigger channel
/config setting:remove_autoroom_trigger value:<voice_channel_id>

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 and easy to read.

# Add a recruitment-only channel
/config setting:add_recruitment_only_channel value:<text_channel_id>

# Remove a recruitment-only channel
/config setting:remove_recruitment_only_channel value:<text_channel_id>

Limit: Free plan 1ch / Plus plan 10ch

Game Type Management

Manage game types for custom matches.

# Add a game type
/config setting:add_game_type value:Valorant

# Delete a game type
/config setting:delete_game_type value:Valorant

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

Timezone Setting

Set which timezone is used to interpret the schedule parameter for scheduled recruitment.

# Set to JST (UTC+9)
/config setting:timezone value:+9

# Set to US Eastern Time (UTC-5)
/config setting:timezone value:-5

# Reset to default
/config setting:timezone value:reset

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

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