ロール保持

ロール保持は、メンバーがサーバーを退出して再び参加したときに、退出前に持っていたロールを自動で復元する機能です(いわゆる「スティッキーロール」)。

「機能の有効化」と、サーバー別設定の「このサーバーでロール保持を有効化」が両方オンのサーバーでだけ動作します。コマンドの有効化と権限はコマンド権限設定で行います。

記録されるタイミング

記録されるのは退出した時点のロールではなく、そのメンバーが最後にメッセージを送信した時点のロールです。機能を有効化した直後や、有効化後に一度も発言していないメンバーは記録がないため、再参加してもロールは復元されません。

発言のたびに現在のロールを確認し、前回から変化があったときだけ記録を更新します。

「復元から除外するロール」に指定したロールのほか、次のロールは常に復元されません。設定で解除することはできません。

種類	理由
Discord に管理される連携ロール(managed ロール)	Bot 連携や外部サービスとの連携で Discord が自動管理しているため、Bot 側で付与できません
`@everyone` ロール	全メンバーが標準で持つロールのため、記録・付与の対象ではありません
Bot 自身の最上位ロールと同等以上のロール	Discord の仕様上、Bot は自分と同等以上のロールを付与できません。復元したい場合は、サーバーの設定で Bot のロールをそのロールより上に配置してください

付与できないロールがあっても復元全体は中止されず、付与できるロールだけが付与されます。

いずれもサーバー内専用で、manage_roles(ロールの管理)権限が必要です。

コマンド	できること
`/role-retention settings`	サーバーでの有効/無効と除外ロールを Discord 上で設定します。ダッシュボードのサーバー別設定と同じ内容です。
`/role-retention clear`	保存済みのロール記録を削除します。`member` を指定するとそのメンバー分だけ、省略するとサーバー全体の記録を削除します。

/role-retention clear で削除した記録は元に戻せません。削除後は、メンバーが再び発言して記録し直されるまで、再参加しても復元されません。