ロールパネル
ロールパネルは、メンバーが自分でロールを付けたり外したりできる「パネル」を、サーバーごとに作成・設置するモジュールです。ルール同意ロールの配布や、趣味・通知カテゴリーの選択などに使えます。
コマンドの有効化と権限は コマンド権限設定 で行います。
パネルの設置
ダッシュボードや /rolepanel create で作るのは「パネルの設計図」です。保存しただけではメッセージは送られません。設置したいチャンネルで /rolepanel send を実行するか、/rolepanel settings の「📍 設置」から設置してください。
既存のメッセージに取り付ける
Bot が送るパネルの代わりに、すでにあるメッセージ(お知らせやルールの投稿など)をパネルにできます。ダッシュボードでは「設置先」の「既存メッセージ」、Discord では「📍 設置」から取り付けます。
- 取り付けられるのはリアクション式だけです。
- 取り付け先のチャンネルで、Bot に「チャンネルを見る」「メッセージ履歴を読む」「リアクションの追加」の権限が必要です。
- Discord のリアクションは 1 メッセージに 20 種類までで、ほかのメンバーが付けたリアクションもこの枠に数えられます。
- Bot の停止中に付け外しされたリアクションはロールに反映されません。
/rolepanel settingsの「🔄 リアクションの同期」で揃えられます。
/rolepanel settings で行った変更(ロールの追加・削除、見た目の変更など)は保存されるだけで、設置済みのメッセージには反映されません。 変更後は「📤 公開パネルへの反映」の 反映 を押してください。🔄 更新 は設定画面の表示を最新にするだけです。
パネルの形式
| 形式 | 操作方法 | 特徴 |
|---|---|---|
| ボタン式 | メッセージのボタンをクリックする | 新規作成時の既定です |
| セレクト式 | ドロップダウンから選ぶ | 各項目に説明文を添えられます |
| リアクション式 | メッセージに絵文字でリアクションする | 既存のメッセージに取り付けられます |
ロールを追加するとき、ボタン式・リアクション式では絵文字、セレクト式ではラベルが必須です。絵文字には <:name:id> 形式のカスタム絵文字も指定できますが、その絵文字がサーバーから削除されているなどで参照できないと、正しく表示されないことがあります。
動作モード
3 形式すべてで使えます。ダッシュボードの「パネルモード」と、Discord の /rolepanel settings →「⚙️ 詳細な動作」は同じ設定です。
| モード | 挙動 |
|---|---|
| 「付与と解除(トグル)」(既定) | 持っていなければ付与し、持っていれば外します |
| 「ロール付与のみ」 | 付与だけを行い、操作してもロールは外れません。ルール同意などに向いています |
| 「ロール解除のみ」 | 外すだけを行います |
「リアクション除去」(既定はオフ)はリアクション式でのみ設定できます。オンにすると押された絵文字を Bot が外すため、メンバーがリアクションを外してもロールは変わりません。
上限と制限
| 項目 | Free | Plus | Pro | Max |
|---|---|---|---|---|
| サーバーあたりのパネル数 | 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 | 本人だけに見える設定パネルを開き、ロールの追加・削除、見た目の編集、形式・動作モードの変更、設置、パネル名の変更、削除を行います。パネル名を省略すると一覧が開きます。 |
次のステップ / 関連ページ
最終更新: