ロールパネル

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

このモジュールは無料で利用できます。

ロールパネルとは

メンバーはパネルを操作するだけで、管理者の手を借りずに自分でロールを受け取れます。

パネルには 2 つの形式があります。

形式	操作方法	向いている用途
ボタン式	メッセージのボタンをクリックする	わかりやすく、誤クリックが少ない。動作モードなどの細かい挙動を調整できる
リスト式	ドロップダウンから選ぶ	選択肢が多いときにすっきり見せられる。各項目に説明文を添えられる

1 つのパネルには、絵文字・ラベル・付与するロールの組み合わせ(ロール項目)を複数登録できます。

ダッシュボードで作るのは「パネルの設計図」です。実際に Discord にパネルのメッセージを送信するのは、サーバー側で /rolepanel send などのコマンドを実行したときです。

設定の全体像

ロールパネルの設定画面は、大きく次の 3 つのブロックに分かれています。

ページ最上部の「機能の有効化」トグル
「コマンド権限設定」(/rolepanel 系コマンドの有効・無効や権限)
「ロールパネル設定」(パネルそのものの作成・編集)

ロールパネルを設定する

サイドバーから「ロールパネル」を開く

ダッシュボードで対象の Bot を開き、左側のメニュー(モジュール一覧)から「ロールパネル」を選びます。

「機能の有効化」をオンにする

ページの一番上にある「機能の有効化」のスイッチをオンにします。これがオフのままだと、ロールパネルの機能そのものが動きません。

コマンドの利用可否を確認する(任意)

「コマンド権限設定」では、/rolepanel send・/rolepanel setting・/rolepanel create の 3 つのコマンドごとに、有効・無効や利用できる権限を細かく設定できます。各コマンドの行を開くと詳しい設定が表示されます。

特にこだわりがなければ、初期状態のままで問題ありません。権限設定の詳しい使い方は、各モジュール共通の権限設定と同じ考え方です。

新しいパネルを追加する

「ロールパネル設定」の「新しいパネルを追加」で入力欄が開きます。

「対象サーバー」: パネルを設置するサーバーを選びます。
「パネル名」: 管理用の名前を入力します(例: ロール配布パネル)。

「対象サーバー」と「パネル名」の両方を入力すると「追加」ボタンがクリックできるようになり、「追加」をクリックすると一覧にパネルが 1 つ追加されます。

パネルの基本設定を行う

追加したパネルは一覧にカードとして並びます。パネル名の部分(アコーディオン)を開くと、次の項目を設定できます。

項目	内容
「UIタイプ」	パネルの形式を選びます。「ボタン」を選ぶとボタン式、「セレクトメニュー」を選ぶとリスト式になります。
「チャンネル」	パネルを設置するチャンネルを選びます。
「メッセージID」	既存のメッセージにパネルを紐付ける場合のみ入力します。新しくパネルのメッセージを送信する場合は空欄のままでかまいません。

ボタン式の場合の追加設定を行う

「UIタイプ」でボタン式を選んだときだけ、次の設定が表示されます。

まず「パネルモード」で、ボタンでロールを付け外しするときの挙動を選びます。

パネルモード	挙動
「トグル（複数可）」	ボタンを押すとロールが付き、もう一度押すと外れます。複数のロールを同時に持てます。
「排他（1つのみ）」	このパネル内で同時に持てるロールは 1 つだけです。別の項目を選ぶと前のロールが外れます。
「認証（解除不可）」	一度ロールを付けると、もう一度押してもロールは外れません。ルール同意などに向いています。

さらに「リアクション除去」のスイッチをオンにすると、処理後にメンバーが付けたリアクションを自動で消去します。

ロール項目を追加する

パネルに「どの絵文字・ラベルで、どのロールを配るか」を登録します。「ロール設定」の右側にある「項目を追加」をクリックすると、項目が 1 つ追加されます。

各項目では次を設定します。

設定	内容
絵文字	左の絵文字ボタンをクリックすると絵文字を選べます。初期状態は `✨` です。
「ラベル」	パネルに表示する項目の名前を入力します。
「付与するロールを選択」	この項目で付け外しするロールを選びます。

必要な数だけ「項目を追加」を繰り返して、配りたいロールを登録します。不要になった項目は、その項目右側のごみ箱アイコンで削除できます。

ロール項目を 1 つも追加していないと「ロール設定がありません。「項目を追加」から設定してください。」と表示され、パネルは正しく機能しません。少なくとも 1 つは登録してください。

変更を保存する

設定を変更すると、画面下部に「未保存の変更があります」というバーが表示されます。「保存」をクリックすると設定が保存されます。変更を取り消したいときは「破棄」をクリックします。

Discord でパネルを送信する

保存しただけではメッセージは送られません。設置したいサーバーで、Discord 側からロールパネルのコマンド(/rolepanel send など)を実行して、実際にパネルのメッセージを送信します。

コマンド一覧

ロールパネルは、ダッシュボードでの設計と、Discord 側でのコマンド実行を組み合わせて使います。Discord で利用できるコマンドは次の 3 つです。いずれもサーバー内でのみ実行できます。

コマンド	できること	主なオプション
`/rolepanel create`	新しいパネルの設定を作成します。タイプ(ボタン式 / リスト式)を選びます。この時点ではまだチャンネルには設置されません。	`panel_name`(必須)= パネルの管理名、`panel_type`(必須)= 「ボタン式」または「リスト式」
`/rolepanel send`	作成済みのパネルを、コマンドを実行したチャンネルに送信します。Embed と操作用のボタン(リスト式ではセレクトメニュー)が表示されます。	`panel_name`(必須・入力補完あり)= 送信するパネルの名前
`/rolepanel setting`	パネルの設定 UI(本人だけに見える一時メッセージ)を開きます。プレビュー表示、ロールの追加・削除、Embed の編集、タイプ変更、詳細設定にアクセスできます。	`panel_name`(必須・入力補完あり)= 設定するパネルの名前

/rolepanel send で実際にメッセージが送られると、そのメッセージに付いたボタンやセレクトメニューは期限なしで動作し続けます(メッセージが残っているかぎり有効です)。

/rolepanel create のタイプ選択肢には「ボタン式」と「リスト式 (BotShade Premium)」があります。

設定 UI でできること

/rolepanel setting を実行すると、本人だけに見える設定パネル(プレビューの Embed、ロール数、パネルタイプ、各種ボタン)が表示されます。主なボタンは次の通りです。

➕ ロール追加: ロール選択用のドロップダウンが開き、選んだロールの詳細(絵文字・ラベル・説明)を入力するモーダルが表示されます。
➖ ロール削除: パネルに登録済みのロール一覧から、外したいロールを選びます。
📝 Embed編集: タイトル・説明文・色を編集するモーダルを開きます。
🔄 更新: 設定パネルの表示を最新の状態に更新します(設定画面の再描画のみで、設置済みメッセージは更新されません)。
🔄 パネル同期: 設置済みのメッセージに、ここまでの変更(ロールの追加・削除、Embed の変更など)を反映します。
↔️ タイプ変更: パネルのタイプ(ボタン式 / リスト式)を切り替えます。
⚙️ 詳細設定: ボタン式パネルで、リアクション削除や動作モードを設定します。

設定 UI でロールや Embed を変更しても、その内容は保存されるだけで、設置済みのメッセージにはすぐには反映されません。変更後は 🔄 パネル同期 ボタンを押して、設置済みのパネルを更新してください。ロールを追加・削除すると パネルに反映するには「🔄 更新」ボタンを押してください。 という案内が表示されます。

ロールを追加するときのモーダルには、絵文字・ラベル・説明の 3 つの入力欄があります。ボタン式では絵文字が必須、リスト式ではラベルが必須です。ラベルの初期値には選んだロールの名前が入ります。絵文字欄には通常の絵文字のほか、<:name:id> の形式でカスタム絵文字も指定できます。

実際の動作と既定値

パネルを作成・設置したときの初期状態は次の通りです。

項目	既定値	補足
パネルタイプ	ボタン式	新規作成時の既定。リスト式は設定 UI で切り替えられます。
パネルモード	トグル	ボタンを押すとロールが付き、もう一度押すと外れます。
リアクション削除	OFF	既定ではボタン操作後にリアクション表示は自動で消えません。
Embed のタイトル	`{panel_name} \| ロールパネル`	編集しない場合に自動生成される文言です。
Embed の色	`#2f3136`	Discord の暗めの既定色です。`#RRGGBB` 形式(7 文字)で変更できます。
ロール選択ドロップダウンの有効時間	180 秒	設定中のロール追加・削除用ドロップダウンは 3 分操作がないと期限切れになります。
設置済みメッセージの有効時間	期限なし	設置したパネルのボタンやセレクトメニューはメッセージが残るかぎり動き続けます。

パネルモード(ボタン式)

ボタン式パネルでは、⚙️ 詳細設定 から動作モードを選べます。設置済みパネルでボタンを押したときの挙動が変わります。

モード	挙動
トグル	持っていなければ付与し、持っていれば削除します。
追加のみ	持っていなければ付与します。すでに持っている場合はその旨を案内します。
削除のみ	持っていれば削除します。持っていない場合はその旨を案内します。

リアクション削除 をオンにすると、メンバーがパネルのボタンを押したあと、リアクションの表示が自動で取り除かれます。これらの詳細設定はボタン式パネルでのみ有効で、リスト式に切り替えると無視されます。

上限と制限

項目	無料プラン	BotShade Premium
サーバーあたりのパネル数	1 枚	10 枚
パネルあたりのロール数	5 件	25 件

無料プランとプレミアムで上限に差がありますが、現在はベータ版のため全ユーザーにプレミアムが付与されており、プレミアム側の緩い上限(パネル 10 枚・ロール 25 件)で利用できます。リスト式パネル・タイプ変更・詳細設定といった本来プレミアム向けの機能も、すべて無料で使えます。

Embed やロール項目には、入力の長さ・形式に次の制限があります。

項目	制限
Embed のタイトル	最大 256 文字
Embed の説明文	最大 2000 文字
ロールのラベル	最大 100 文字
ロールの絵文字	最大 100 文字(絵文字または `<:name:id>` 形式のカスタム絵文字)
ロールの説明	最大 100 文字(リスト式で表示)
Embed の色	`#RRGGBB` 形式の 7 文字ちょうど

表示されるメッセージ

ロールパネルの操作中に Bot が表示する主なメッセージです({ } の部分は実際のロール名やパネル名などに置き換わります)。設置済みパネルでの操作結果は、本人だけに見える一時メッセージとして表示されます。

成功時

パネル作成: ✅ ロールパネル設定 {panel_name} を作成しました。 に続けて /rolepanel send コマンドでチャンネルに設置してください。 と案内されます。
チャンネルへの設置: ✅ ロールパネル {panel_name} をこのチャンネルに設置しました。
ロール付与: ロール {role.name} を付与しました。
ロール削除: ロール {role.name} を削除しました。
パネル同期: パネルを同期しました。
Embed 更新: Embedの設定を更新しました。パネルに反映するには「🔄 更新」ボタンを押してください。
タイプ変更: タイプを {panelType} に変更しました。

案内(情報)

ロールをパネルに追加: ロール {role.mention} をパネルに追加しました。パネルに反映するには「🔄 更新」ボタンを押してください。
ロールをパネルから削除: ロールを削除しました。パネルに反映するには「🔄 更新」ボタンを押してください。
すでにロールを持っている(追加のみモード): 既にロール {role.name} を持っています。
ロールを持っていない(削除のみモード): ロール {role.name} を持っていません。

エラー時

同名パネルが存在: エラー: {panel_name} という名前のパネルは既に存在します。
パネル数の上限: エラー: 無料プランでは1枚、BotShade Premiumプランでは10枚までしかパネルを作成できません。
リスト式をプレミアム外で作成しようとした: リスト式のパネルはBotShade Premiumプランでのみ利用可能です。
パネルが見つからない: エラー: {panel_name} という名前のパネル設定が見つかりません。
ロール数の上限: エラー: これ以上ロールを追加できません。(上限: 5件)(無料プランの場合)
同じロールを重複追加: エラー: ロール {role.mention} は既に追加されています。
削除できるロールがない: 削除できるロールがありません。
設置先チャンネルへの送信権限がない: エラー: このチャンネルにメッセージを送信する権限がありません。
ロール操作の権限がない: エラー: ロールを操作する権限がありません。Botのロールが対象ロールより上にあるか確認してください。
ロールがサーバーに存在しない: このロールはサーバーに存在しないため、付与できませんでした。
削除済みパネルのボタンを押した: このパネルは利用できません (削除済みの可能性があります)。
プレミアム機能をプレミアム外で操作しようとした: プレミアム機能です。

注意点・うまくいかないとき

設置済みパネルのメッセージを Discord 上で手動削除すると、設定そのものは残りますが、設置済みメッセージは失われます。この状態で同期しても変化はなく、エラーも表示されません。設置済みパネルが見当たらないときは、/rolepanel send で改めて設置し直してください。
パネルを設置したチャンネルが削除されると、そのパネルへの操作はできなくなります。同期は静かに失敗し、ユーザー向けのエラーは表示されません。
パネルに登録したロールを Discord 側で削除すると、設置済みパネルでそのロールを操作しようとしたメンバーには このロールはサーバーに存在しないため、付与できませんでした。 のようなエラーが表示されます。
ロールの付け外しがうまくいかないときは、Bot のロールが対象のロールより上にあるかを確認してください。Discord の仕組み上、Bot は自分より下位のロールしか付け外しできません。
Embed の色は #RRGGBB 形式の 7 文字ちょうどで入力する必要があります。形式が違うと送信が通らず、入力欄が開いたままになります。
設定中のロール選択ドロップダウンは 180 秒(3 分)操作がないと期限切れになります。反応しなくなったら、もう一度ボタンを押してドロップダウンを開き直してください。
<:name:id> 形式のカスタム絵文字を指定しても、その絵文字がサーバーから削除されているなどで参照できない場合は、ボタンに正しく表示されないことがあります。

設定項目の一覧

パネルごとに設定できる主な項目をまとめます。

項目	種別	説明
「対象サーバー」	追加時のみ	パネルを設置するサーバー。
「パネル名」	追加時のみ	管理用の名前。
「UIタイプ」	全形式	ボタン式かリスト式かを選ぶ。
「チャンネル」	全形式	パネルを設置するチャンネル。
「メッセージID」	全形式	既存メッセージへ紐付けるときのみ入力。
「パネルモード」	ボタン式のみ	「トグル（複数可）」「排他（1つのみ）」「認証（解除不可）」。
「リアクション除去」	ボタン式のみ	処理後にリアクションを自動消去。
絵文字	各ロール項目	項目に表示する絵文字(初期値 `✨`)。
「ラベル」	各ロール項目	項目に表示する名前。
「付与するロールを選択」	各ロール項目	付け外しの対象ロール。

よくある質問

パネルを複数作れますか

はい。「新しいパネルを追加」から、サーバーごとに複数のパネルを作成できます。一覧の各カードには、サーバー ID・パネル名・形式(ボタン式 / リスト式)が表示されます。

パネルを削除したいときは

一覧の各パネルカードにある削除操作(ごみ箱アイコン)でパネルを削除できます。削除後は忘れずに「保存」をクリックしてください。

ボタン式とリスト式で設定項目は違いますか

「パネルモード」や「リアクション除去」は、ボタン式を選んだときだけ表示される設定です。リスト式では、これらの項目は表示されません。

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

Embed メッセージ — パネルと合わせて使う案内メッセージの作成。
コマンド権限設定 — /rolepanel 系コマンドの有効・無効や権限の考え方。
ストレージ — Bot に保存されているデータの確認。