機能紹介

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

ロール機能

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

ロールの使い方

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

クイック募集

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

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

書式

説明テキスト@半角数字

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

# 例: 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人固定)
  • チーム割り当てはランダムシャッフルで決定

チーム分けロジック

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

  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 設定名:オートルームトリガー追加 値:<ボイスチャンネル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文字を超えるメッセージはスキップされます。

音声の選定

読み上げに使用する音声は以下の優先順位で決定されます:

  1. ユーザー個別設定: /voice コマンドで自分の音声を設定できます。
  2. サーバーデフォルト: /config でサーバー全体のデフォルト音声を変更できます。
  3. システムデフォルト: 上記いずれも未設定の場合に適用されます。

言語設定と読み上げ精度

読み上げは自動で言語を判定しますが、/config でサーバーの読み上げ言語を明示的に指定すると、より精度の高い読み上げが可能です。日本語サーバーであれば「日本語」を設定することを推奨します。

月間文字数制限

1サーバーあたり月間75,000文字まで読み上げできます。上限に達したメッセージはスキップされます。

使用量はサブスクリプションの更新日にリセットされます。

使い方

  1. VCに参加した状態で /join を実行してBotを招待
  2. VC内のテキストチャンネルに投稿されたメッセージが順番に読み上げられます
  3. 読み上げを終了するには /leave を実行

サーバー設定

デフォルト画像の設定

/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プランは引き継がれますが、レーティングや設定は初期状態からのスタートとなります。