機能紹介

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作成などのメニューが表示されます。

ロール機能

募集内でロール(役割)を設定・選択できます。

ロールの使い方

  1. 募集作成時: 募集者がロールを定義
  2. 参加後: 参加者がプルダウンからロールを選択
  3. 表示: ロールは募集メッセージの右側カラムに表示

カスタムマッチ機能

対称マッチ

参加者を自動でチームA/チームBに分割します。

  • 募集人数: 奇数(1,3,5,7人)+ 募集者
  • レート考慮: 高レート順に交互割り当て(チーム均等化)

非対称マッチ(DbD等)

ソロ1人 vs チーム4人の構成で分割します。

  • 固定5人構成: ソロ1人 + チーム4人
  • 募集者はデフォルトでソロ側に配置
  • ボタン構成: 「ソロ」「チーム」「仮参加」「離脱」「中止」

チーム分けロジック

レーティングを考慮した公平なチーム分けを行います:

  1. 参加者をレートの高い順にソート
  2. 交互にチームA/チームBに割り当て
  3. チーム間のレート差を最小化

勝敗報告

カスタムマッチ完了後、募集者は勝敗を報告できます。

  • 表示される選択肢: 「チームAの勝利」「チームBの勝利」など
  • レート更新: 勝敗報告後、参加者のレートが自動更新
  • 無効試合: 試合が成立しなかった場合は無効として報告可能

レーティングシステム

概要

  • ゲームタイプ別、サーバー別、ユーザー別でレートを管理
  • ゲームタイプはサーバー管理者が/configで追加可能。
  • 初期レート: 1500(Elo方式)
  • 勝敗報告で自動更新

レートとランキングの確認方法

/ranking
  1. ランキングメッセージが表示される
  2. プルダウンでゲームタイプを選択してランキングを確認
  3. 「レート確認」ボタンをクリックで自分の全ゲームタイプのレートと順位を確認

レートリセット(管理者のみ)

/config 設定名:レーティングリセット 値:Valorant

指定ゲームタイプの全ユーザーのレートを初期値(1500)に戻します。

VC機能

Plusプラン専用機能です。

専用VC作成機能

募集完了後、募集者は参加者専用のボイスチャンネルを作成できます。

前提条件

  • サーバー管理者が /config でカテゴリーIDを設定済み
  • Botがそのカテゴリー内でVCを作成する権限を持っている。

使い方

  1. 募集完了後、セレクトメニューが表示される
  2. 募集者が「専用VCを作成」または「公開VCを作成」を選択
  3. 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/)

画像の優先順位

  1. コマンドパラメータで指定した画像
  2. サーバーのデフォルト画像
  3. 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として解釈されます。