機能紹介
Monvokeの全コマンドと機能の詳細リファレンスです。
コマンド一覧
/invoke - 募集コマンド
基本的な募集を作成するためのメインコマンドです。
コマンド形式
/invoke [schedule:MMDDHHMM] [mention:@ロール名] [start_image_url:画像URL] [end_image_url:画像URL] [raid:有効]
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
schedule |
任意 | 日時指定募集にする(形式: MMDDHHMM / 日本時間 / 7日以内) |
mention |
任意 | 募集開始時にメンション通知するロール |
start_image_url |
任意 | 募集中に表示する画像のURL |
end_image_url |
任意 | 募集完了時に表示する画像のURL |
raid |
任意 | レイドモード(有効 のとき)。最低募集人数に達したら参加者へ通知し、その後も最大募集人数まで自由に参加可能(順番待ちなし)。 |
入力項目(モーダル)
| 項目 | 必須 | 説明 |
|---|---|---|
| タイトル | 必須 | 最大100文字。募集の見出し |
| 説明 | 必須 | 最大1000文字。募集の詳細説明(複数行可) |
| 募集人数 | 必須 | 1-50の数字。実際の上限は「入力値+募集者」。ただし最大50人 |
※ レイドモード(raid:有効)を指定した場合、モーダルで 最低募集人数 と 最大募集人数 を入力します。最低募集人数に達した時点で参加者へ通知が送信され、その後も最大募集人数まで自由に参加できます(順番待ちなし)。
モーダルに情報を入力して送信すると、募集メッセージが投稿されます。
使用例
# 基本的な募集
/invoke
# ロールにメンション通知
/invoke mention:@レイドメンバー
# 開始時間を指定する(例: 01/07 21:30)
/invoke schedule:01072130
# レイドモード(最低人数到達後に通知、その後最大人数まで参加可能)
/invoke raid:有効
# 画像付き募集
/invoke start_image_url:https://cdn.discord.com/attachments/.../image.png
/custom - カスタムマッチ募集
自動チーム分け機能付きのカスタムマッチ募集を作成します。
Plusプラン専用機能です。
コマンド形式
/custom [game_type:ゲームタイプ] [asymmetric:有効] [mention:@ロール名] [start_image_url:画像URL] [end_image_url:画像URL]
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
game_type |
任意 | ゲームタイプを選択(サーバーで設定したもの) |
asymmetric |
任意 | 有効 のとき非対称マッチ(1vs4)。未指定の場合は対称マッチ |
mention |
任意 | 募集開始時にメンション通知するロール |
start_image_url |
任意 | 募集中に表示する画像のURL |
end_image_url |
任意 | 募集完了時に表示する画像のURL |
対称マッチと非対称マッチ
| マッチタイプ | 募集人数 | チーム構成 | 適したゲーム |
|---|---|---|---|
| 対称マッチ | 奇数(1,3,5,7,9人)+ 募集者 | チームA vs チームB | FPS、MOBA等 |
| 非対称マッチ | 固定5人 | ソロ(1人) vs チーム(4人) | Dead by Daylight等 |
使用例
# 基本的なカスタムマッチ(対称)
/custom
# ゲームタイプを指定
/custom game_type:Valorant
# 非対称マッチ(DbD等)
/custom asymmetric:有効
/preset - プリセット実行
保存済みのプリセットから素早く募集を作成します。
コマンド形式
/preset name:プリセット名 [schedule:MMDDHHMM]
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
name |
必須 | 実行するプリセット名(オートコンプリート対応) |
schedule |
任意 | 日時指定募集にする(形式: MMDDHHMM / 日本時間 / 7日以内) |
使用例
# プリセットから募集を作成
/preset name:ランクマ5人
# プリセット + 日時指定
/preset name:ランクマ5人 schedule:01072130
/preset-create - プリセット作成
募集の設定をプリセットとして保存します。
1サーバーにつき最大1個まで作成できます。Plusプランでは最大10個まで作成可能です。
コマンド形式
/preset-create type:invoke|custom [mention:@ロール名] [roles:ロール1,ロール2] [start_image_url:画像URL] [end_image_url:画像URL] [raid:有効] [game_type:ゲームタイプ] [asymmetric:有効]
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
type |
必須 | invoke(通常募集)または custom(カスタムマッチ) |
mention |
任意 | 募集開始時にメンション通知するロール |
roles |
任意 | 参加者が選択できるロール(カンマ区切り、invoke型のみ) |
start_image_url |
任意 | 募集中に表示する画像のURL |
end_image_url |
任意 | 募集完了時に表示する画像のURL |
raid |
任意 | レイドモード(invoke型のみ) |
game_type |
任意 | ゲームタイプ(custom型のみ) |
asymmetric |
任意 | 非対称マッチ(custom型のみ) |
コマンド実行後、モーダルが表示されます。プリセット名、タイトル、説明、募集人数を入力して保存します。
使用例
# invoke型プリセットを作成
/preset-create type:invoke mention:@ゲーマー
# invoke型 + ロール付きプリセットを作成
/preset-create type:invoke mention:@ゲーマー roles:タンク,ヒーラー,DPS
# custom型プリセットを作成(非対称マッチ)
/preset-create type:custom game_type:DbD asymmetric:有効
/preset-delete - プリセット削除
保存済みのプリセットを削除します。
プリセットの作成者またはサーバー管理者のみ削除できます。
コマンド形式
/preset-delete name:プリセット名
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
name |
必須 | 削除するプリセット名(オートコンプリート対応) |
使用例
# プリセットを削除
/preset-delete name:ランクマ5人
/ranking - ランキング表示
サーバー内のレートランキングを表示します。
Plusプラン専用機能です。
コマンド形式
/ranking
機能
コマンドを実行すると、インタラクティブなランキングメッセージが表示されます。
| 要素 | 説明 |
|---|---|
| プルダウンメニュー | ゲームタイプを選択してランキングを切り替え |
| ページ送りボタン | ページ送り(1ページ20人表示) |
| レート確認ボタン | クリックしたユーザー自身の全ゲームタイプのレートを表示 |
特徴
- ゲームタイプ切り替え: プルダウンから選択するとランキングが即座に更新
- ページネーション: 最大100人まで表示、20人ずつページ送り
- 個人レート確認: 「レート確認」ボタンで自分の全ゲームタイプのレートと順位を確認(サムネイルにアイコン表示)
- 永続化: Bot再起動後もボタン・プルダウンが機能
使用例
# ランキングを表示
/ranking
# 表示後、プルダウンでゲームタイプを選択
# 「レート確認」ボタンで自分のレートを確認
/config - サーバー設定
サーバー管理者専用のコマンドです。サーバー全体の設定を変更します。
設定項目一覧
| 設定名 | 説明 |
|---|---|
| 募集中のデフォルト画像URL | 募集メッセージに表示する画像 |
| 募集完了時のデフォルト画像URL | 募集完了後の画像 |
| 専用VCカテゴリーID | 専用VC作成先カテゴリー |
| オートルームトリガーチャンネルID | 自動VC作成トリガーチャンネル |
| ゲームタイプ追加 | サーバー独自のゲームタイプを登録 |
| ゲームタイプ削除 | 登録されたゲームタイプを削除 |
| レーティングリセット | 指定ゲームタイプのレーティングを初期化 |
| タイムゾーン | スケジュール募集の時刻入力に使用するタイムゾーン(UTCオフセット) |
画像URLの設定は、値に none で画像なし、reset でデフォルトに戻せます。
使用例
# デフォルト画像を設定
/config 設定名:募集中のデフォルト画像URL 値:https://cdn.discord.com/.../image.png
# ゲームタイプを追加
/config 設定名:ゲームタイプ追加 値:Valorant
# レーティングをリセット
/config 設定名:レーティングリセット 値:Valorant
# タイムゾーンを設定(日本時間)
/config 設定名:タイムゾーン 値:+9
/support - コミュニティ支援
コミュニティ支援の募集メッセージをチャンネルに投稿します。
Plusプラン加入済みサーバー専用コマンドです。
コマンド形式
/support
機能
コマンドを実行すると、チャンネルにコミュニティ支援の案内メッセージが投稿されます。メッセージにはMonvokeの紹介リンクと支援ページへのリンクボタンが含まれます。
サーバーメンバーはボタンからMonvoke Webサイトの支援ページにアクセスし、スターを購入してPlusプランの料金を支援できます。
使用例
# チャンネルにコミュニティ支援の案内を投稿
/support
/id - ID共有
VC作成時に共有されるIDを登録・管理します。
登録したIDは、専用VCやオートルームに参加した際に自動で表示されます。ゲームIDやフレンドコードの共有に便利です。
コマンド形式
/id 操作:<登録|確認|削除> [id:<登録するID>]
オプション
| パラメータ | 説明 | 必須 |
|---|---|---|
操作 |
登録・確認・削除のいずれかを選択 | はい |
id |
登録するID(登録時のみ) | 登録時のみ |
操作一覧
| 操作 | 説明 |
|---|---|
| 登録 | IDを登録または更新する |
| 確認 | 現在登録されている自分のIDを表示する |
| 削除 | 登録済みのIDを削除する |
使用例
# IDを登録する
/id 操作:登録 id:Player#1234
# 登録済みのIDを確認する
/id 操作:確認
# IDを削除する
/id 操作:削除
/language - サーバー言語設定
サーバー全体のBot表示言語を統一します。
管理者権限が必要です。
コマンド形式
/language language:<言語名|Disable>
パラメータ
| パラメータ | 必須/任意 | 説明 |
|---|---|---|
language |
必須 | 統一する言語名、または Disable で無効化 |
選択可能な言語
- 英語
- 日本語
- フランス語
- ドイツ語
- 韓国語
- ポルトガル語(ブラジル)
- Disable(無効化 - 各ユーザーのクライアント言語に戻す)
設定後、そのサーバー内でのすべてのBot応答・募集メッセージ・関連機能の表示が指定した言語に統一されます。Disable を選択すると、通常の動作(各ユーザーのクライアント言語に基づく表示)に戻ります。
使用例
# サーバー全体を英語に統一
/language language:English
# サーバー全体を日本語に統一
/language language:日本語
# 上書きを無効化(各ユーザーのクライアント言語に戻す)
/language language:Disable
募集機能の詳細
募集タイプ
基本の募集機能
「今から○人集めたい」といった、その場で人数が揃ったらすぐに締め切りたい募集に向いています。
- 指定した人数(募集者を含む)が集まった時点で自動的に完了
- 手軽にその場の突発募集を立てたいときに便利
日時指定募集(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で募集完了通知が送信されます。
- Plusプランの場合、募集者向けにVC作成などのメニューが表示されます。
ロール機能
募集内でロール(役割)を設定・選択できます。
ロールの使い方
- 募集作成時: 募集者がロールを定義
- 参加後: 参加者がプルダウンからロールを選択
- 表示: ロールは募集メッセージの右側カラムに表示
カスタムマッチ機能
対称マッチ
参加者を自動でチームA/チームBに分割します。
- 募集人数: 奇数(1,3,5,7人)+ 募集者
- レート考慮: 高レート順に交互割り当て(チーム均等化)
非対称マッチ(DbD等)
ソロ1人 vs チーム4人の構成で分割します。
- 固定5人構成: ソロ1人 + チーム4人
- 募集者はデフォルトでソロ側に配置
- ボタン構成: 「ソロ」「チーム」「仮参加」「離脱」「中止」
チーム分けロジック
レーティングを考慮した公平なチーム分けを行います:
- 参加者をレートの高い順にソート
- 交互にチームA/チームBに割り当て
- チーム間のレート差を最小化
勝敗報告
カスタムマッチ完了後、募集者は勝敗を報告できます。
- 表示される選択肢: 「チームAの勝利」「チームBの勝利」など
- レート更新: 勝敗報告後、参加者のレートが自動更新
- 無効試合: 試合が成立しなかった場合は無効として報告可能
レーティングシステム
概要
- ゲームタイプ別、サーバー別、ユーザー別でレートを管理
- ゲームタイプはサーバー管理者が
/configで追加可能。 - 初期レート: 1500(Elo方式)
- 勝敗報告で自動更新
レートとランキングの確認方法
/ranking
- ランキングメッセージが表示される
- プルダウンでゲームタイプを選択してランキングを確認
- 「レート確認」ボタンをクリックで自分の全ゲームタイプのレートと順位を確認
レートリセット(管理者のみ)
/config 設定名:レーティングリセット 値:Valorant
指定ゲームタイプの全ユーザーのレートを初期値(1500)に戻します。
VC機能
Plusプラン専用機能です。
専用VC作成機能
募集完了後、募集者は参加者専用のボイスチャンネルを作成できます。
前提条件
- サーバー管理者が
/configでカテゴリーIDを設定済み - Botがそのカテゴリー内でVCを作成する権限を持っている。
使い方
- 募集完了後、セレクトメニューが表示される
- 募集者が「専用VCを作成」または「公開VCを作成」を選択
- VCが指定されたカテゴリー内に作成される
VCの種類
| 種類 | アクセス権限 |
|---|---|
| 専用VC | 参加者のみ接続・発言可能 |
| 公開VC | 誰でも接続可能 |
専用VCの特徴
- 名前: 募集のタイトルがVC名になります。[]と<>で囲まれている部分はタグとして認識し、VC名からは自動的に除去されます。
- チャンネル管理: 募集者にはチャンネル管理権限が付与され、チャンネル編集の概要タブ(VC名など)を変更できます。
- 自動削除: 全員が退出すると自動的に削除されます。
オートルーム機能
トリガーチャンネルに接続すると、自動的に個別VCが作成されます。
機能概要
- ユーザーがトリガーチャンネルに接続 → 自動でVC作成
- 作成されたVCに自動移動
- VC名: 「{ユーザー名}の部屋」等のランダムな名前
- トリガーチャンネルのビットレートを引き継いで作成
- 作成者にVCの管理権が付与される
- 全員退出で自動削除
設定方法
/config 設定名:オートルームトリガーチャンネルID 値:<ボイスチャンネルID>
VCアクションメニュー
募集完了後、以下のアクションが選択可能です:
| アクション | 説明 |
|---|---|
| 専用VCを作成 | 参加者限定のVCを作成 |
| 公開VCを作成 | 誰でも参加できるVCを作成 |
| 集める | 参加者を募集者のVCに集約 |
ID共有
VCに参加すると、メンバーの登録済みIDが自動的にテキストチャンネルに表示されます。
仕組み
専用VCやオートルームにメンバーが参加・退出するたびに、VC内の全メンバーのID一覧が自動更新されます。事前に /id コマンドでIDを登録しておくと、VC参加時にフレンドコードやゲームIDを手動で共有する手間が省けます。
表示内容
- ID登録済みのメンバー: ユーザー名とIDが表示される。
- ID未登録のメンバー: ユーザー名のみ表示される。
自動更新のタイミング
- メンバーがVCに参加したとき
- メンバーがVCから退出したとき
IDの登録方法
/id 操作:登録 id:Player#1234 でIDを登録できます。詳しくは/id コマンドを参照してください。
データ管理
サーバー退出時のデータ削除
BotがサーバーからキックまたはBANされると、そのサーバーのデータは自動的に削除されます。
削除されるもの
- 募集データ(進行中・完了済みすべて)
- ユーザーレートのデータ
/configで設定した内容(デフォルト画像、VCカテゴリなど)- 作成したゲームタイプ
削除されないもの
- Monvoke Webサイトのサーバー登録
- Plusサブスクリプション
Botを再招待した場合、Plusプランは引き継がれますが、レーティングや設定は初期状態からのスタートとなります。
サーバー設定
デフォルト画像の設定
募集メッセージに表示されるデフォルト画像を設定します。募集中と募集完了時で異なる画像を表示できます。
画像URLの要件
- プロトコル:
https://で始まること - 拡張子:
.jpg,.jpeg,.png,.gif,.webpのいずれか - 推奨ホスト: Discord CDN (
https://cdn.discord.com/)
画像の優先順位
- コマンドパラメータで指定した画像
- サーバーのデフォルト画像
- Monvokeのデフォルト画像
専用VCカテゴリーの設定
/config 設定名:専用VCカテゴリーID 値:<カテゴリーID>
必要なBot権限: チャンネルの管理
オートルームトリガーチャンネルの設定
/config 設定名:オートルームトリガーチャンネルID 値:<ボイスチャンネルID>
必要なBot権限: チャンネルの管理、メンバーを移動
ゲームタイプの管理
カスタムマッチ用のゲームタイプを管理します。
# ゲームタイプを追加
/config 設定名:ゲームタイプ追加 値:Valorant
# ゲームタイプを削除
/config 設定名:ゲームタイプ削除 値:Valorant
登録済みゲームタイプの確認: /ranking コマンドのプルダウンメニューで確認できます。
タイムゾーンの設定
日時指定募集(schedule引数)の入力をどのタイムゾーンで解釈するかを設定します。
# 日本時間(UTC+9)に設定
/config 設定名:タイムゾーン 値:+9
# 米国東部時間(UTC-5)に設定
/config 設定名:タイムゾーン 値:-5
# デフォルトに戻す
/config 設定名:タイムゾーン 値:reset
未設定の場合、日本語クライアントのユーザーは日本時間(JST)、それ以外はUTCとして解釈されます。