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 modal asks for minimum player count and maximum player count. Participants are notified when the minimum is reached, and anyone can freely join up to the maximum (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 (notify at minimum, open join to max)
/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

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.
• On Plus plan, 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

Plus plan feature.

Dedicated VC Creation

After recruitment completes, the organizer can create a dedicated voice channel for participants.

Prerequisites

• Server admin has set the category ID via /config
• Bot has permission to create VCs in that 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 in the configured category

VC Types

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

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

Setup

/config setting:autoroom_trigger_channel_id value:<voice_channel_id>

VC Action Menu

After recruitment completes, the following actions are available:

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.

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.

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>

Required Bot Permission: Manage Channels

Auto Room Trigger Channel Setup

/config setting:autoroom_trigger_channel_id value:<voice_channel_id>

Required Bot Permissions: Manage Channels, Move Members

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.