ロールポータル
説明
ユーザーガイド
ボタン付きのメッセージを投稿し、クリックしたメンバーに1つ以上のロールを付与します。ただし、指定した必須ロールをすでに持っていることが条件です。最初のステップを終えたメンバーに限定セクションを開放する用途に最適です。
機能
- 任意のチャンネルに、カスタマイズしたEmbedとボタンを投稿します。
- 何かを付与する前に必須ロールを確認します。
- スタッフの操作なしに、ワンクリックで付与するロールを割り当てます。
- チャンネル内で本人にのみ見える形（一時的なメッセージ）で応答するため、成功も拒否も会話を妨げません。
- ボタンは長期間有効です。Botを再起動した後も動作します。
このモジュールはAutoRole、Role Gate、RoleRosterとは異なります
ロールに関わるモジュールは4つあり、それぞれ役割が明確に分かれています。
| モジュール | 仕組み |
|---|---|
| ロールポータル | 条件付きのボタン：ロールAとBを持っている場合に、ロールCを取得できます。 |
| AutoRole | ドロップダウンメニューのパネルで、各自が自由に取得し、取得したものを外すこともできます。条件はありません。 |
| Role Gate | 参加時に自動的に付与されるロール、ロールの入れ替え、長期不在のメンバーからのロール取り除き。クリックは不要です。 |
| RoleRoster | 名簿：あるロールを持つメンバーの一覧を表示します。ロールの付与は行いません。 |
まとめると、4つのうちロールを付与する前に条件を課すのはポータルだけです。
クイックスタート（管理者）
- ダッシュボード → ツールとスタッフカテゴリ → セキュアポータルを開きます。
- 新しいポータルをクリックします。
- 内部名（Discord上には表示されません）を付け、設置するチャンネルを選びます。
- 付与するロールを指定します（必須）。必要に応じて必須ロールも指定します。
- Embedとボタンをカスタマイズし、保存します。
- 一覧で送信アイコンをクリックし、チャンネルにパネルを投稿します。
コマンド
このモジュールにはDiscordコマンドがありません。設定はすべてダッシュボードから行い、メンバーはパネルのボタンのみを使用します。
ダッシュボードでの設定
ポータルの一覧には、それぞれの名前、チャンネル、必須ロール、付与するロールが表示され、パネルを投稿、編集、削除の3つの操作が用意されています。
設定ウィンドウは4つのブロックで構成されています。
- 基本情報：内部名（必須）と設置するチャンネル（必須）。
- 条件と付与内容：
- 必須ロール — 任意。この項目を空のままにすると、誰でもクリックできます。
- 付与するロール — 必須。1つ以上のロールを指定します。
- 外観（Embed）：タイトル、説明、色。
- ボタン：表示テキストと絵文字（絵文字セレクター付き）。
ポータルの数はプレミアムでないサーバーでは1つに制限されています（初期値であり、TennoCoreチームが調整できます）。
知っておきたいこと
- Botにはロールの管理権限が必要で、さらにBotのロールが付与対象のロールより上位に配置されている必要があります。そうでない場合、メンバーには階層に関するエラーメッセージが表示されます。
- 必須ロールはAND条件で判定されます。メンバーは列挙されたすべてのロールを持っている必要があります。不足している場合、Botはどのロールが足りないかを具体的に伝えます。
- ポータルのロールをすでにすべて持っているメンバーには、その旨の案内だけが表示され、何も起きません。
- ポータルがロールを取り除くことはありません。取得と返却を切り替える動作が必要な場合はAutoRoleを使用してください。
- ポータルを編集しても、すでに投稿されたメッセージは変更されません。 テキスト、色、ボタンのラベルは投稿時のままです。最新の内容にするにはパネルを再投稿し、古いメッセージを削除してください。
- 同じポータルのメッセージを複数サーバー内に残さないでください。Botの再起動後に再び有効になるのは最後に投稿されたメッセージのみで、古いボタンは反応しなくなります。
- ダッシュボードでポータルを削除しても、Discordに投稿されたメッセージは削除されません。 ボタンは表示されたままになりますが機能しません。メッセージは手動で削除してください。
- チャンネルはBotが書き込めるチャンネルである必要があります。その間にチャンネルが削除されていた場合、投稿は失敗します。
- ポータルはカスタムBotでも動作します。TennoCoreがサーバーにいない場合は、あなたのBotがボタンを処理します。