Bot 機能(モジュール)

ロールパネル

ロールパネルは、メンバーが自分でロールを付けたり外したりできる「パネル」を、サーバーごとに作成・設置するモジュールです。ルール同意ロールの配布や、趣味・通知カテゴリーの選択などに使えます。

コマンドの有効化と権限は コマンド権限設定 で行います。

パネルの設置

ダッシュボードや /rolepanel create で作るのは「パネルの設計図」です。保存しただけではメッセージは送られません。設置したいチャンネルで /rolepanel send を実行するか、/rolepanel settings の「📍 設置」から設置してください。

既存のメッセージに取り付ける

Bot が送るパネルの代わりに、すでにあるメッセージ(お知らせやルールの投稿など)をパネルにできます。ダッシュボードでは「設置先」の「既存メッセージ」、Discord では「📍 設置」から取り付けます。

  • 取り付けられるのはリアクション式だけです。
  • 取り付け先のチャンネルで、Bot に「チャンネルを見る」「メッセージ履歴を読む」「リアクションの追加」の権限が必要です。
  • Discord のリアクションは 1 メッセージに 20 種類までで、ほかのメンバーが付けたリアクションもこの枠に数えられます。
  • Bot の停止中に付け外しされたリアクションはロールに反映されません。/rolepanel settings の「🔄 リアクションの同期」で揃えられます。

/rolepanel settings で行った変更(ロールの追加・削除、見た目の変更など)は保存されるだけで、設置済みのメッセージには反映されません。 変更後は「📤 公開パネルへの反映」の 反映 を押してください。🔄 更新 は設定画面の表示を最新にするだけです。

パネルの形式

形式操作方法特徴
ボタン式メッセージのボタンをクリックする新規作成時の既定です
セレクト式ドロップダウンから選ぶ各項目に説明文を添えられます
リアクション式メッセージに絵文字でリアクションする既存のメッセージに取り付けられます

ロールを追加するとき、ボタン式・リアクション式では絵文字、セレクト式ではラベルが必須です。絵文字には <:name:id> 形式のカスタム絵文字も指定できますが、その絵文字がサーバーから削除されているなどで参照できないと、正しく表示されないことがあります。

動作モード

3 形式すべてで使えます。ダッシュボードの「パネルモード」と、Discord の /rolepanel settings →「⚙️ 詳細な動作」は同じ設定です。

モード挙動
「付与と解除(トグル)」(既定)持っていなければ付与し、持っていれば外します
「ロール付与のみ」付与だけを行い、操作してもロールは外れません。ルール同意などに向いています
「ロール解除のみ」外すだけを行います

「リアクション除去」(既定はオフ)はリアクション式でのみ設定できます。オンにすると押された絵文字を Bot が外すため、メンバーがリアクションを外してもロールは変わりません。

上限と制限

項目FreePlusProMax
サーバーあたりのパネル数1 枚5 枚25 枚無制限
パネルあたりのロール数5 件10 件25 件25 件
パネルあたりのロール数(リアクション式)5 件10 件20 件20 件
セレクト式パネル✕○○○
動作モードの変更(付与のみ・解除のみ)✕○○○
リアクション除去✕○○○

上位プランで作ったセレクト式パネルをほかの形式へ戻す操作は、Free でも行えます。

項目制限
Embed のタイトル最大 256 文字
Embed の説明文最大 2000 文字
ロールのラベル・絵文字・説明各最大 100 文字(説明はセレクト式で表示)
ロール選択ドロップダウン(設定中)180 秒で期限切れ。反応しなくなったら、もう一度ボタンを押して開き直してください

Embed の色の書き方は、ダッシュボードでは 色の指定、Discord の「🎨 見た目」では 埋め込みの編集パネル と同じです。

設置したパネルのボタン・セレクトメニュー・リアクションには期限がなく、メッセージが残るかぎり動き続けます。

エラーメッセージ

{ } の部分には、実際のロール名やパネル名などが入ります。

表示されるメッセージ状況と対処
エラー: ロールを操作する権限がありません。Botのロールが対象ロールより上にあるか確認してください。Discord の仕組み上、Bot は自分より下位のロールしか付け外しできません。サーバーのロール設定で、Bot のロールを対象ロールより上に移動してください。
エラー: このチャンネルにメッセージを送信する権限がありません。設置先チャンネルで Bot に送信権限がありません。チャンネルの権限設定で、Bot にメッセージの送信を許可してください。
このロールはサーバーに存在しないため、付与できませんでした。パネルに登録したロールが Discord 側で削除されています。
このパネルは利用できません (削除済みの可能性があります)。削除済みパネルのボタンが押されました。
エラー: 現在のプランでは{上限}枚までしかパネルを作成できません。パネル数がプランの上限に達しています。
これ以上ロールを追加できません。(上限: {上限}件)ロール数がプランの上限に達しています。
セレクト式のパネルは上位プランでのみ利用可能です。セレクト式は Plus 以上で利用できます。
エラー: {panel_name} という名前のパネルは既に存在します。同じ名前のパネルが既にあります。
エラー: {panel_name} という名前のパネル設定が見つかりません。指定した名前のパネルがありません。
エラー: ロール {role.mention} は既に追加されています。同じロールは 1 つのパネルに重複して追加できません。
削除できるロールがありません。パネルに削除できるロールが登録されていません。

コマンド一覧

いずれもサーバー内でのみ実行できます。

コマンドできること
/rolepanel create名前とタイプ(ボタン式 / セレクト式 / リアクション式)を指定してパネルを作成します。名前かタイプを省略すると作成ウィザードが開き、指定した値は引き継がれます。この時点ではまだ設置されません。
/rolepanel send作成済みのパネルを、実行したチャンネルに送信します。
/rolepanel settings本人だけに見える設定パネルを開き、ロールの追加・削除、見た目の編集、形式・動作モードの変更、設置、パネル名の変更、削除を行います。パネル名を省略すると一覧が開きます。

次のステップ / 関連ページ

最終更新:

目次