機能紹介

Monvokeの全コマンドと機能の詳細リファレンスです。

コマンド一覧

/invoke - 募集コマンド

基本的な募集を作成するためのメインコマンドです。

パラメータ

パラメータ 必須/任意 説明
schedule 任意 日時指定募集にする（形式: DDHHMM / 日本時間 / 7日以内）
image_url 任意 添付画像のURL
color 任意 募集メッセージのアクセントカラー
background 任意 募集メッセージの背景画像

入力項目（モーダル）

項目 必須 説明
タイトル 任意 最大100文字。募集の見出し
説明 必須 最大1000文字。募集の詳細説明（複数行可）
募集人数 必須 1-50の数字。実際の上限は「入力値+募集者」。ただし最大50人
既存ユーザー 任意 最初から参加者として追加するユーザーを選択
メンションするロール 任意 募集投稿時にメンション通知するロールを選択

モーダルに情報を入力して送信すると、募集メッセージが投稿されます。

/custom - カスタムマッチ募集

自動チーム分け機能付きのカスタムマッチ募集を作成します。

パラメータ

パラメータ 必須/任意 説明
rating_type 任意 レーティングタイプを選択（サーバーで設定したもの）
asymmetric 任意 1v4（キラー1人+サバイバー4人）または 2v8（キラー2人+サバイバー8人）を選択。未指定の場合は対称マッチ
schedule 任意 日時指定募集にする（形式: DDHHMM / 7日以内）
image_url 任意 添付画像のURL
color 任意 募集メッセージのアクセントカラー
background 任意 募集メッセージの背景画像

入力項目（モーダル）

項目 必須 説明
タイトル 任意 最大100文字。募集の見出し
説明 必須 最大1000文字。募集の詳細説明（複数行可）
募集人数 必須 自分を除いた募集人数。1〜9の奇数のみ（対称マッチのみ）。募集者を含めた合計を2チームに分割するため、4対4なら7と入力する。非対称マッチは人数固定のため不要
既存ユーザー 任意 最初から参加者として追加するユーザーを選択
メンションするロール 任意 募集投稿時にメンション通知するロールを選択

対称マッチと非対称マッチ

マッチ形式 募集人数 チーム構成 向いているゲーム
対称 奇数（1,3,5,7,9人）+ 募集者 チームA vs チームB FPS、MOBA など
非対称（1v4） 5人固定 キラー1人 vs サバイバー4人 Dead by Daylight など
非対称（2v8） 10人固定 キラー2人 vs サバイバー8人 Dead by Daylight 2v8 など

/preset - プリセット実行

保存済みのプリセットから素早く募集を作成します。

パラメータ

パラメータ 必須/任意 説明
name 必須 実行するプリセット名
schedule 任意 日時指定募集にする（形式: DDHHMM / 日本時間 / 7日以内）

プリセットの作成方法

プリセットは専用のコマンドではなく、作成済みの募集メッセージから保存します。/invoke や /custom で作成した募集メッセージの ⚙️ ボタンを押すと設定モーダルが開きます。「プリセットとして保存」欄にプリセット名を入力して送信すると、その募集の設定がプリセットとして保存されます。

保存できるプリセット数は Freeプランで1個、Plusプランで最大20個です。

/preset-delete - プリセット削除

保存済みのプリセットを削除します。

プリセットの作成者またはサーバー管理者のみ削除できます。

パラメータ

パラメータ 必須/任意 説明
name 必須 削除するプリセット名

/ranking - ランキング表示

サーバー内のレートランキングを表示します。

機能

コマンドを実行すると、インタラクティブなランキングメッセージが表示されます。

要素 説明
プルダウンメニュー レーティングタイプを選択してランキングを切り替え
ページ送りボタン ページ送り（1ページ20人表示）
レート確認ボタン クリックしたユーザー自身の全レーティングタイプのレートを表示

特徴

  • レーティングタイプ切り替え: プルダウンから選択するとランキングが即座に更新
  • ページネーション: 最大100人まで表示、20人ずつページ送り
  • 個人レート確認: 「レート確認」ボタンで自分の全レーティングタイプのレートと順位を確認（サムネイルにアイコン表示）
  • 永続化: Bot再起動後もボタン・プルダウンが機能

/config - サーバー設定

サーバーの管理者権限（Administrator）を持つメンバーのみ実行できます。サーバー全体の設定を変更します。

設定項目一覧

コマンド実行後、設定項目を選択するとモーダルが表示され、各種値を入力・変更できます。

設定名 説明
デフォルト添付画像URL 募集メッセージに表示するデフォルト画像のURL
専用VCを作成するカテゴリー 専用VC作成先カテゴリーの設定
オートルーム トリガーチャンネルの追加・削除・VC名装飾の設定（Freeプラン: 1個 / Plusプラン: 最大20個 + ゴースト機能）
レーティングタイプ レーティングタイプの追加・削除・リセットをまとめて設定
タイムゾーン スケジュール募集の時刻入力に使用するタイムゾーン（UTCオフセット）
デフォルトメンション先 募集時にデフォルトでメンション通知するロールを設定（空欄で無効化）
募集専用チャンネル 通常メッセージを自動削除するチャンネルの追加・削除（Free: 1ch / Plus: 10ch）
表示言語 サーバー全体のBot表示言語を統一。無効化で各ユーザーのクライアント言語に戻す
背景画像の登録・削除 募集画像の背景として使用するPNG画像（1128×770px・3MB以下）を登録・削除（Plusプラン / 上限10枚）
募集の見た目 募集画像のキャラクターとデフォルト背景を設定

/support - コミュニティ支援

コミュニティ支援の募集メッセージをチャンネルに投稿します。

Plusプラン加入済みサーバー専用コマンドです。

機能

コマンドを実行すると、チャンネルにコミュニティ支援の案内メッセージが投稿されます。メッセージにはMonvokeの紹介リンクと支援ページへのリンクボタンが含まれます。

サーバーメンバーはボタンからMonvoke Webサイトの支援ページにアクセスし、スターを購入してPlusプランの料金を支援できます。

/id - ID共有

VC作成時に共有されるIDを登録・管理します。

登録したIDは、専用VCやオートルームに参加した際に自動で表示されます。ゲームIDやフレンドコードの共有に便利です。

オプション

パラメータ 説明 必須
操作 登録・確認・削除のいずれかを選択 はい
id 登録するID（登録時のみ） 登録時のみ

操作一覧

操作 説明
登録 IDを登録または更新する
確認 現在登録されている自分のIDを表示する
削除 登録済みのIDを削除する

募集機能の詳細

募集タイプ

基本の募集機能

「今から○人集めたい」といった、その場で人数が揃ったらすぐに締め切りたい募集に向いています。

  • 指定した人数（募集者を含む）が集まった時点で自動的に完了
  • 手軽にその場の突発募集を立てたいときに便利

日時指定募集（schedule: DDHHMM）

「○日の○時から一緒に遊びたい」といった、事前に開始時刻を決めて募集したい場合に向いています。

  • 指定した開始日時までは「募集中」として継続
  • 開始日時はJST（日本時間）で入力
  • DDHHMM（例: 7日 21:30 → 072130）を記号なしで入力
  • 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作成などのアクションメニューが表示されます。

ロール機能

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

ロールの使い方

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

クイック募集

スラッシュコマンドを使わずに、テキストメッセージを送るだけで募集を作成できる機能です。

コマンド入力が苦手な場合や、素早く募集を立てたいときに便利です。

書式

説明テキスト@半角数字

「説明」と「募集人数（自分を除く）」を @ でつなげて送信します。

# 例: 3人募集（自分を含めると計4人）
apex一緒にやろう@3

# 例: 4人募集（5人部屋）
ランクマ行きたい人@4

利用条件

  • この機能を使うには、あらかじめ募集専用チャンネルの設定が必要です
  • 設定は /config から 募集専用チャンネル を選んで行います
  • 設定したチャンネル内でのみ有効です

説明テキストがプリセット名と一致した場合は、そのプリセットが呼び出され、募集人数のみ上書きされます。

カスタムマッチ機能

対称マッチ

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

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

非対称マッチ（DbD等）

キラー vs サバイバーの非対称構成で参加者を分割します。

  • 1v4モード: キラー1人 + サバイバー4人（合計5人固定）
  • 2v8モード: キラー2人 + サバイバー8人（合計10人固定）
  • チーム割り当てはランダムシャッフルで決定

チーム分けロジック

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

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

完了画面での操作

チーム分けが終わったあと、試合を始める前に募集メッセージのボタンから編成を組み替えられます。

  • 「チームを移動」ボタン: 参加者が押すと、自分だけ反対のチームへ移ります
  • 「シャッフル」ボタン: 募集者が押すと、チーム分けをやり直します

どちらのボタンも、対称マッチと非対称マッチの両方で使えます。

勝敗報告

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

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

レーティングシステム

概要

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

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

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

レートリセット（管理者のみ）

/config → レーティングタイプ を選択し、モーダルでリセットするタイプを指定します。指定レーティングタイプの全ユーザーのレートを初期値（1500）に戻します。

VC機能

専用VC作成機能

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

前提条件

  • Botがチャンネルを作成する権限を持っている
  • /config でカテゴリーIDを設定しておくと、指定カテゴリーにVCが作成される（未設定の場合は募集チャンネルのカテゴリーに作成）

使い方

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

VCの種類

種類 アクセス権限
専用VC 参加者のみ接続・発言可能
公開VC 誰でも接続可能

作成されるVCの特徴

  • 名前: 募集のタイトルがVC名になります。[]と<>で囲まれている部分はタグとして認識し、VC名からは自動的に除去されます。
  • チャンネル管理: 募集者にはチャンネル管理権限が付与され、チャンネル編集の概要タブ（VC名など）を変更できます。
  • 自動削除: 全員が退出すると自動的に削除されます。

集める機能

募集完了後のアクションメニューから「集める」を選択すると、同じサーバー内で他のVCに接続している参加者を専用VCに移動させることができます。

オートルーム機能

トリガーチャンネルに接続すると、自動的に個別VCが作成されます。

機能概要

  • ユーザーがトリガーチャンネルに接続 → 自動でVC作成
  • 作成されたVCに自動移動
  • VC名: 「{ユーザー名}の部屋」等のランダムな名前
  • トリガーチャンネルのビットレートを引き継いで作成
  • 作成者にVCの管理権が付与される
  • 全員退出で自動削除
  • 複数のトリガーチャンネルを設定可能（Freeプラン: 1個 / Plusプラン: 最大20個）
  • トリガーごとに装飾（絵文字プレフィックス）を設定可能
  • ゴースト機能（Plusプラン専用）: 作成された個別VCをトリガーチャンネル元の作成者以外には見えない非公開VCにできます

設定方法

/config から オートルームを追加 を選択するとモーダルが開き、トリガーチャンネルの追加・削除とVC名の装飾をまとめて設定できます。

ID共有

VCに参加すると、メンバーの登録済みIDが自動的にテキストチャンネルに表示されます。

仕組み

専用VCやオートルームにメンバーが参加・退出するたびに、VC内の全メンバーのID一覧が自動更新されます。事前に /id コマンドでIDを登録しておくと、VC参加時にフレンドコードやゲームIDを手動で共有する手間が省けます。

表示内容

  • ID登録済みのメンバー: ユーザー名とIDが表示される。
  • ID未登録のメンバー: ユーザー名のみ表示される。

自動更新のタイミング

  • メンバーがVCに参加したとき
  • メンバーがVCから退出したとき

IDの登録方法

/id 操作:登録 id:Player#1234 でIDを登録できます。詳しくは/id コマンドを参照してください。

サーバー設定

デフォルト画像の設定

/config → デフォルト添付画像URL を選択すると、モーダルで画像URLを設定できます。設定した画像は、コマンドで個別に指定しない限り全ての募集メッセージに表示されます。

画像URLの要件

  • プロトコル: https:// で始まること
  • 拡張子: .jpg, .jpeg, .png, .gif, .webp のいずれか
  • 推奨ホスト: Discord CDN (https://cdn.discord.com/)

画像の優先順位

  1. コマンドパラメータで指定した画像
  2. サーバーのデフォルト画像
  3. 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プランは引き継がれますが、レーティングや設定は初期状態からのスタートとなります。