機能紹介
Monvokeの全コマンドと機能の詳細リファレンスです。
コマンド一覧
/invoke - 募集コマンド
基本的な募集を作成するためのメインコマンドです。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
schedule |
任意 | 日時指定募集にする(形式: MMDDHHMM / 日本時間 / 7日以内) |
image_url |
任意 | 添付画像のURL |
raid |
任意 | レイドモード(有効 のとき)。作成直後に「募集完了」状態で自由参加開始。上限人数を設定するか、無制限にするかを選べる。 |
入力項目(モーダル)
| 項目 | 必須 | 説明 |
|---|---|---|
| タイトル | 必須 | 最大100文字。募集の見出し |
| 説明 | 必須 | 最大1000文字。募集の詳細説明(複数行可) |
| 募集人数 | 必須 | 1-50の数字。実際の上限は「入力値+募集者」。ただし最大50人 |
| 既存ユーザー | 任意 | 最初から参加者として追加するユーザーを選択 |
| メンションするロール | 任意 | 募集投稿時にメンション通知するロールを選択 |
※ レイドモード(raid:有効)を指定した場合、募集人数の入力は任意です。数値を入力すると上限人数付きレイド、空欄にすると無制限モード(人数上限なし)になります。レイドモードでは作成直後に「募集完了」状態となり、誰でも自由に参加できます(順番待ちなし)。
モーダルに情報を入力して送信すると、募集メッセージが投稿されます。
使用例
# 基本的な募集
/invoke
# 開始時間を指定する(例: 01/07 21:30)
/invoke schedule:01072130
# レイドモード(作成直後に完了状態、自由参加。空欄で無制限、数値入力で上限あり)
/invoke raid:有効
# 画像付き募集
/invoke image_url:https://cdn.discord.com/attachments/.../image.png
/custom - カスタムマッチ募集
自動チーム分け機能付きのカスタムマッチ募集を作成します。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
rating_type |
任意 | レーティングタイプを選択(サーバーで設定したもの) |
asymmetric |
任意 | 1v4(キラー1人+サバイバー4人)または 2v8(キラー2人+サバイバー8人)を選択。未指定の場合は対称マッチ |
schedule |
任意 | 日時指定募集にする(形式: MMDDHHMM / 7日以内) |
image_url |
任意 | 添付画像のURL |
入力項目(モーダル)
| 項目 | 必須 | 説明 |
|---|---|---|
| タイトル | 必須 | 最大100文字。募集の見出し |
| 説明 | 必須 | 最大1000文字。募集の詳細説明(複数行可) |
| チーム人数 | 必須 | 片チームの人数(対称マッチのみ)。非対称マッチは人数固定のため不要 |
| 既存ユーザー | 任意 | 最初から参加者として追加するユーザーを選択 |
| メンションするロール | 任意 | 募集投稿時にメンション通知するロールを選択 |
使用例
# 基本的なカスタムマッチ(対称)
/custom
# レーティングタイプを指定
/custom rating_type:Valorant
# 非対称マッチ 1v4(DbD等)
/custom asymmetric:1v4
# 非対称マッチ 2v8(DbD 2v8モード等)
/custom asymmetric:2v8
# 開始時間を指定する(例: 01/07 21:30)
/custom schedule:01072130
/preset - プリセット実行
保存済みのプリセットから素早く募集を作成します。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
name |
必須 | 実行するプリセット名(オートコンプリート対応) |
schedule |
任意 | 日時指定募集にする(形式: MMDDHHMM / 日本時間 / 7日以内) |
使用例
# プリセットから募集を作成
/preset name:ランクマ5人
# プリセット + 日時指定
/preset name:ランクマ5人 schedule:01072130
/preset-create - プリセット作成
募集の設定をプリセットとして保存します。
1サーバーにつき最大1個まで作成できます。Plusプランでは最大20個まで作成可能です。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
type |
必須 | invoke(通常募集)または custom(カスタムマッチ) |
mention |
任意 | 募集開始時にメンション通知するロール |
roles |
任意 | 参加者が選択できるロール(カンマ区切り、invoke型のみ) |
start_image_url |
任意 | 募集中に表示する画像のURL |
end_image_url |
任意 | 募集完了時に表示する画像のURL |
raid |
任意 | レイドモード(invoke型のみ) |
rating_type |
任意 | レーティングタイプ(custom型のみ) |
asymmetric |
任意 | 非対称マッチ(custom型のみ) |
使用例
# invoke型プリセットを作成
/preset-create type:invoke mention:@ゲーマー
# invoke型 + ロール付きプリセットを作成
/preset-create type:invoke mention:@ゲーマー roles:タンク,ヒーラー,DPS
# custom型プリセットを作成(非対称マッチ 1v4)
/preset-create type:custom rating_type:DbD asymmetric:1v4
/preset-delete - プリセット削除
保存済みのプリセットを削除します。
プリセットの作成者またはサーバー管理者のみ削除できます。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
name |
必須 | 削除するプリセット名(オートコンプリート対応) |
使用例
# プリセットを削除
/preset-delete name:ランクマ5人
/ranking - ランキング表示
サーバー内のレートランキングを表示します。
Plusプラン専用機能です。
機能
コマンドを実行すると、インタラクティブなランキングメッセージが表示されます。
| 要素 | 説明 |
|---|---|
| プルダウンメニュー | レーティングタイプを選択してランキングを切り替え |
| ページ送りボタン | ページ送り(1ページ20人表示) |
| レート確認ボタン | クリックしたユーザー自身の全レーティングタイプのレートを表示 |
特徴
- レーティングタイプ切り替え: プルダウンから選択するとランキングが即座に更新
- ページネーション: 最大100人まで表示、20人ずつページ送り
- 個人レート確認: 「レート確認」ボタンで自分の全レーティングタイプのレートと順位を確認(サムネイルにアイコン表示)
- 永続化: Bot再起動後もボタン・プルダウンが機能
使用例
# ランキングを表示
/ranking
# 表示後、プルダウンでレーティングタイプを選択
# 「レート確認」ボタンで自分のレートを確認
/config - サーバー設定
サーバー管理者専用のコマンドです。サーバー全体の設定を変更します。
設定項目一覧
コマンド実行後、設定項目を選択するとモーダルが表示され、各種値を入力・変更できます。
| 設定名 | 説明 |
|---|---|
| デフォルト添付画像URL | 募集メッセージに表示するデフォルト画像のURL |
| 専用VCを作成するカテゴリー | 専用VC作成先カテゴリーの設定 |
| オートルーム | トリガーチャンネルの追加・削除・VC名装飾の設定(Freeプラン: 1個 / Plusプラン: 最大20個 + ゴースト機能) |
| レーティングタイプ | レーティングタイプの追加・削除・リセットをまとめて設定 |
| タイムゾーン | スケジュール募集の時刻入力に使用するタイムゾーン(UTCオフセット) |
| デフォルトメンション先 | 募集時にデフォルトでメンション通知するロールを設定(空欄で無効化) |
| 募集専用チャンネル | 通常メッセージを自動削除するチャンネルの追加・削除(Free: 1ch / Plus: 10ch) |
| 表示言語 | サーバー全体のBot表示言語を統一。無効化で各ユーザーのクライアント言語に戻す |
| 読み上げ機能 | 読み上げ音声・言語・発信者名読み上げの設定(Plusプラン) |
| 背景画像の登録・削除 | 募集画像の背景として使用するPNG画像(1128×770px・3MB以下)を登録・削除(Plusプラン / 上限10枚) |
| 募集の見た目 | 募集画像のキャラクターとデフォルト背景を設定 |
使用例
# デフォルト画像を設定(設定名を選択後にモーダルが表示される)
/config
# レーティングタイプを管理
/config
# タイムゾーンを設定
/config
/support - コミュニティ支援
コミュニティ支援の募集メッセージをチャンネルに投稿します。
Plusプラン加入済みサーバー専用コマンドです。
機能
コマンドを実行すると、チャンネルにコミュニティ支援の案内メッセージが投稿されます。メッセージにはMonvokeの紹介リンクと支援ページへのリンクボタンが含まれます。
サーバーメンバーはボタンからMonvoke Webサイトの支援ページにアクセスし、スターを購入してPlusプランの料金を支援できます。
使用例
# チャンネルにコミュニティ支援の案内を投稿
/support
/id - ID共有
VC作成時に共有されるIDを登録・管理します。
登録したIDは、専用VCやオートルームに参加した際に自動で表示されます。ゲームIDやフレンドコードの共有に便利です。
オプション
| パラメータ | 説明 | 必須 |
|---|---|---|
操作 |
登録・確認・削除のいずれかを選択 | はい |
id |
登録するID(登録時のみ) | 登録時のみ |
操作一覧
| 操作 | 説明 |
|---|---|
| 登録 | IDを登録または更新する |
| 確認 | 現在登録されている自分のIDを表示する |
| 削除 | 登録済みのIDを削除する |
使用例
# IDを登録する
/id 操作:登録 id:Player#1234
# 登録済みのIDを確認する
/id 操作:確認
# IDを削除する
/id 操作:削除
/join - TTS読み上げ開始
BotをVCに参加させ、テキストの読み上げを開始します。
Plusプラン専用機能です。
動作
コマンドを実行すると、Botがあなたの参加しているVCに入り、そのVC内のテキストチャンネルに投稿されたメッセージを順番に読み上げます。200文字を超えるメッセージはスキップされます。
使用例
# 読み上げを開始
/join
/leave - TTS読み上げ終了
BotをVCから退出させ、読み上げを終了します。
Plusプラン専用機能です。
使用例
# 読み上げを終了
/leave
/voice - 読み上げ音声設定
自分の読み上げに使用する音声を個別に設定します。
Plusプラン専用機能です。
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
voice |
必須 | 使用する音声名(オートコンプリート対応) |
設定した音声はサーバーのデフォルト音声より優先されます。サーバーのデフォルト音声は /config で変更できます。
使用例
# 読み上げ音声を設定
/voice voice:Ara
募集機能の詳細
募集タイプ
基本の募集機能
「今から○人集めたい」といった、その場で人数が揃ったらすぐに締め切りたい募集に向いています。
- 指定した人数(募集者を含む)が集まった時点で自動的に完了
- 手軽にその場の突発募集を立てたいときに便利
日時指定募集(schedule: MMDDHHMM)
「○日の○時から一緒に遊びたい」といった、事前に開始時刻を決めて募集したい場合に向いています。
- 指定した開始日時までは「募集中」として継続
- 開始日時はJST(日本時間)で入力
MMDDHHMM(例: 01/07 21:30 →01072130)を記号なしで入力- 7日以内の日時を指定可能
- 開始時間になったら参加者にDM通知が送信されます。
参加・離脱・仮参加の仕組み
募集メッセージには以下のボタンが表示されます:
参加ボタン
- 正式に募集に参加
- 参加者リストに追加
- 仮参加中の場合、正式参加に変更
- 満員の場合は参加不可
離脱ボタン
- 募集から離脱
- 参加者または仮参加者リストから削除
- 募集者(ホスト)は離脱できません
仮参加ボタン
- 参加が不確定な場合に仮登録
- 参加人数にはカウントされない。
- 用途:
- 参加できるか不確定な場合(「行けたら行きます」)の意思表示
- 人数が集まりそうなときに、参加できるかの最終確認を受けたい場合
仮参加者への通知: 正式参加人数 + 仮参加人数が目標人数に到達したタイミングで、仮参加中のユーザーに「参加できますか?」と促すDM通知が送信されます(参加意思の確認)。
重要: 仮参加は参加枠の確保ではありません。仮参加のまま他のユーザーで参加者枠が埋まった場合、その時点では非参加の扱いになります。参加したい場合は、DMや募集メッセージから「参加」へ切り替えてください。
中止ボタン(募集者のみ)
- 募集を中止
- 全てのボタンが無効化
順番待ちボタン(募集完了後)
- 募集が完了した後に表示されるボタン
- 参加者が離脱した場合、順番待ちリストの先頭から自動的に参加者に昇格
- 用途:
- 満員の募集に空きが出たら参加したい場合
- キャンセル待ちとして登録
募集完了の仕組み
基本(schedule未指定)の場合
参加者が指定人数(募集者含む)に達すると即座に完了します。
募集人数: 5 → 実際の上限: 6人(募集者+5人)
参加者が6人に到達 → 自動完了
scheduleで開始時間を指定した場合
開始時刻が過ぎ、かつ人数が揃った時点で完了します。
開始時刻: 2024-12-31 20:00
募集人数: 5 → 実際の上限: 6人
ケース1: 19:50に6人揃った → 20:00まで募集継続 → 20:00以降に完了
ケース2: 20:10に6人揃った → 即座に完了
完了後の流れ
- 参加者にDMで募集完了通知が送信されます。
- 募集者向けにVC作成などのアクションメニューが表示されます。
ロール機能
募集内でロール(役割)を設定・選択できます。
ロールの使い方
- 募集作成時: 募集者がロールを定義
- 参加後: 参加者がプルダウンからロールを選択
- 表示: ロールは募集メッセージの右側カラムに表示
クイック募集
スラッシュコマンドを使わずに、テキストメッセージを送るだけで募集を作成できる機能です。
コマンド入力が苦手な場合や、素早く募集を立てたいときに便利です。
書式
説明テキスト@半角数字
「説明」と「募集人数(自分を除く)」を @ でつなげて送信します。
# 例: 3人募集(自分を含めると計4人)
apex一緒にやろう@3
# 例: 4人募集(5人部屋)
ランクマ行きたい人@4
利用条件
- この機能を使うには、あらかじめ募集専用チャンネルの設定が必要です
- 設定は
/configコマンドのrecruit_channel項目で行います - 設定したチャンネル内でのみ有効です
説明テキストがプリセット名と一致した場合は、そのプリセットが呼び出され、募集人数のみ上書きされます。
カスタムマッチ機能
対称マッチ
参加者を自動でチームA/チームBに分割します。
- 募集人数: 奇数(1,3,5,7人)+ 募集者
- レート考慮: 高レート順に交互割り当て(チーム均等化)
非対称マッチ(DbD等)
キラー vs サバイバーの非対称構成で参加者を分割します。
- 1v4モード: キラー1人 + サバイバー4人(合計5人固定)
- 2v8モード: キラー2人 + サバイバー8人(合計10人固定)
- チーム割り当てはランダムシャッフルで決定
チーム分けロジック
レーティングを考慮した公平なチーム分けを行います:
- 参加者をレートの高い順にソート
- 交互にチームA/チームBに割り当て
- チーム間のレート差を最小化
勝敗報告
カスタムマッチ完了後、募集者は勝敗を報告できます。
- 表示される選択肢: 「チームAの勝利」「チームBの勝利」など
- レート更新: 勝敗報告後、参加者のレートが自動更新
- 無効試合: 試合が成立しなかった場合は無効として報告可能
レーティングシステム
概要
- レーティングタイプ別、サーバー別、ユーザー別でレートを管理
- レーティングタイプはサーバー管理者が
/configで追加可能。 - 初期レート: 1500(Elo方式)
- 勝敗報告で自動更新
レートとランキングの確認方法
/ranking
- ランキングメッセージが表示される
- プルダウンでレーティングタイプを選択してランキングを確認
- 「レート確認」ボタンをクリックで自分の全レーティングタイプのレートと順位を確認
レートリセット(管理者のみ)
/config → レーティングタイプ を選択し、モーダルでリセットするタイプを指定します。指定レーティングタイプの全ユーザーのレートを初期値(1500)に戻します。
VC機能
専用VC作成機能
募集完了後、募集者は参加者専用のボイスチャンネルを作成できます。
前提条件
- Botがチャンネルを作成する権限を持っている
/configでカテゴリーIDを設定しておくと、指定カテゴリーにVCが作成される(未設定の場合は募集チャンネルのカテゴリーに作成)
使い方
- 募集完了後、セレクトメニューが表示される
- 募集者が「専用VCを作成」または「公開VCを作成」を選択
- VCが作成される
VCの種類
| 種類 | アクセス権限 |
|---|---|
| 専用VC | 参加者のみ接続・発言可能 |
| 公開VC | 誰でも接続可能 |
作成されるVCの特徴
- 名前: 募集のタイトルがVC名になります。[]と<>で囲まれている部分はタグとして認識し、VC名からは自動的に除去されます。
- チャンネル管理: 募集者にはチャンネル管理権限が付与され、チャンネル編集の概要タブ(VC名など)を変更できます。
- 自動削除: 全員が退出すると自動的に削除されます。
集める機能
募集完了後のアクションメニューから「集める」を選択すると、同じサーバー内で他のVCに接続している参加者を専用VCに移動させることができます。
オートルーム機能
トリガーチャンネルに接続すると、自動的に個別VCが作成されます。
機能概要
- ユーザーがトリガーチャンネルに接続 → 自動でVC作成
- 作成されたVCに自動移動
- VC名: 「{ユーザー名}の部屋」等のランダムな名前
- トリガーチャンネルのビットレートを引き継いで作成
- 作成者にVCの管理権が付与される
- 全員退出で自動削除
- 複数のトリガーチャンネルを設定可能(Freeプラン: 1個 / Plusプラン: 最大20個)
- トリガーごとに装飾(絵文字プレフィックス)を設定可能
- ゴースト機能(Plusプラン専用): 作成された個別VCをトリガーチャンネル元の作成者以外には見えない非公開VCにできます
設定方法
# トリガーチャンネルを追加
/config 設定名:オートルームトリガー追加 値:<ボイスチャンネルID>
# トリガーチャンネルを削除
/config 設定名:オートルームトリガー削除 値:<ボイスチャンネルID>
ID共有
VCに参加すると、メンバーの登録済みIDが自動的にテキストチャンネルに表示されます。
仕組み
専用VCやオートルームにメンバーが参加・退出するたびに、VC内の全メンバーのID一覧が自動更新されます。事前に /id コマンドでIDを登録しておくと、VC参加時にフレンドコードやゲームIDを手動で共有する手間が省けます。
表示内容
- ID登録済みのメンバー: ユーザー名とIDが表示される。
- ID未登録のメンバー: ユーザー名のみ表示される。
自動更新のタイミング
- メンバーがVCに参加したとき
- メンバーがVCから退出したとき
IDの登録方法
/id 操作:登録 id:Player#1234 でIDを登録できます。詳しくは/id コマンドを参照してください。
読み上げ機能
Plusプラン専用機能です。 BotをVCに参加させると、VC内のテキストチャンネルに投稿されたメッセージを高品質な音声で自動読み上げします。
対象メッセージ
- 200文字以下のメッセージが読み上げ対象です。
- 200文字を超えるメッセージはスキップされます。
音声の選定
読み上げに使用する音声は以下の優先順位で決定されます:
- ユーザー個別設定:
/voiceコマンドで自分の音声を設定できます。 - サーバーデフォルト:
/configでサーバー全体のデフォルト音声を変更できます。 - システムデフォルト: 上記いずれも未設定の場合に適用されます。
言語設定と読み上げ精度
読み上げは自動で言語を判定しますが、/config でサーバーの読み上げ言語を明示的に指定すると、より精度の高い読み上げが可能です。日本語サーバーであれば「日本語」を設定することを推奨します。
月間文字数制限
1サーバーあたり月間75,000文字まで読み上げできます。上限に達したメッセージはスキップされます。
使用量はサブスクリプションの更新日にリセットされます。
使い方
- VCに参加した状態で
/joinを実行してBotを招待 - VC内のテキストチャンネルに投稿されたメッセージが順番に読み上げられます
- 読み上げを終了するには
/leaveを実行
サーバー設定
デフォルト画像の設定
/config → デフォルト添付画像URL を選択すると、モーダルで画像URLを設定できます。設定した画像は、コマンドで個別に指定しない限り全ての募集メッセージに表示されます。
画像URLの要件
- プロトコル:
https://で始まること - 拡張子:
.jpg,.jpeg,.png,.gif,.webpのいずれか - 推奨ホスト: Discord CDN (
https://cdn.discord.com/)
画像の優先順位
- コマンドパラメータで指定した画像
- サーバーのデフォルト画像
- Monvokeのデフォルト画像
専用VCカテゴリーの設定
/config → 専用VCを作成するカテゴリー を選択し、モーダルでカテゴリーを設定します。設定したカテゴリーにVCが作成されます。未設定の場合は募集チャンネルのカテゴリーに自動フォールバックします。
必要なBot権限: チャンネルの管理
オートルームトリガーチャンネルの設定
トリガーチャンネルを登録できます。Freeプランは1個まで、Plusプランは最大20個です。
/config → オートルーム を選択すると、モーダルでトリガーチャンネルの追加・削除・VC名装飾・ゴースト機能(Plus専用)をまとめて設定できます。
必要なBot権限: チャンネルの管理、メンバーを移動
募集専用チャンネルの設定
登録されたチャンネルでは、ユーザーの通常メッセージが自動削除されます。スラッシュコマンドのみ利用可能になるため、募集チャンネルの視認性を保てます。
/config → 募集専用チャンネル を選択すると、モーダルでチャンネルの追加・削除をまとめて設定できます。
上限: Freeプラン 1ch / Plusプラン 10ch
レーティングタイプの管理
カスタムマッチ用のレーティングタイプを管理します。
/config → レーティングタイプ を選択すると、モーダルでタイプの追加・削除・レーティングリセットをまとめて設定できます。
登録済みレーティングタイプの確認: /ranking コマンドのプルダウンメニューで確認できます。
タイムゾーンの設定
日時指定募集(schedule引数)の入力をどのタイムゾーンで解釈するかを設定します。
/config → タイムゾーン を選択し、モーダルでUTCオフセットを入力します(例: +9 で日本時間)。空欄で送信するとリセットされます。
未設定の場合、日本語クライアントのユーザーは日本時間(JST)、それ以外はUTCとして解釈されます。
表示言語の設定
/config → 表示言語 を選択すると、サーバー全体のBot表示言語を統一できます。
- 英語・日本語・フランス語・ドイツ語・韓国語・ポルトガル語(ブラジル)から選択可能
- 無効化を選択すると、各ユーザーのクライアント言語設定に戻ります
背景画像の設定
Plusプラン専用機能です。
/config → 背景画像の登録・削除 を選択すると、募集画像の背景として使用するPNG画像を登録・削除できます。
- 形式・サイズ: PNG、1128×770px、3MB以下
- 上限: 1サーバーにつき最大10枚
- 登録時に画像名とフラグ(カンマ区切り)を任意で設定できます
募集の見た目の設定
/config → 募集の見た目 を選択すると、募集画像に表示するキャラクターとデフォルト背景を設定できます。
- キャラクター: Monvoke・看板・なし から選択
- デフォルト背景: 登録済みの背景画像または透過から選択
データ管理
サーバー退出時のデータ削除
BotがサーバーからキックまたはBANされると、そのサーバーのデータは自動的に削除されます。
削除されるもの
- 募集データ(進行中・完了済みすべて)
- ユーザーレートのデータ
/configで設定した内容(デフォルト画像、VCカテゴリなど)- 作成したレーティングタイプ
削除されないもの
- Monvoke Webサイトのサーバー登録
- Plusサブスクリプション
Botを再招待した場合、Plusプランは引き継がれますが、レーティングや設定は初期状態からのスタートとなります。