🎭 ロール管理機能

ShabeleAのロール管理機能では、サーバーのロールを効率的に管理できます。
ロールの付与・削除、権限設定、ロール作成、メンバー検索など、Discord標準の機能を超えた柔軟なロール管理が可能です。

基本機能：ロール付与・削除、権限管理、ロール作成、メンバー検索
高度機能：個別権限設定、バッチ操作、統計機能

スラッシュコマンドによるロール管理

スラッシュコマンド 近日実装予定

ロール付与（スラッシュコマンド）

/ロール 付与 [member: メンバー] [role: ロール] [remove_at: 削除日時] [remove_after: 削除までの時間] [note: メモ]

引数の説明

  • member（必須）
    ロールを付与するメンバー
  • role（必須）
    付与するロール
  • remove_at（省略可）
    指定日時にロールを自動削除（YYYY-MM-DD HH:MM形式）
  • remove_after（省略可）
    指定時間後にロールを自動削除（例: 1d, 2h, 30m）
  • note（省略可）
    監査ログに記録するメモ
/ロール 付与 member:@ユーザー名 role:@メンバーロール
指定したユーザーにメンバーロールを付与します。基本的な使用方法です。
/ロール 付与 member:@ユーザー名 role:@イベント参加者 remove_at:2024-12-31 23:59
イベント参加者ロールを付与し、指定日時に自動削除します。
/ロール 付与 member:@ユーザー名 role:@期間限定 remove_after:7d note:1週間限定の特別ロール
7日後に自動削除される期間限定ロールを付与し、監査ログにメモを残します。
権限： サーバーオーナー、ロール管理権限、またはallow_grant_roleで許可されたロールが必要
自動削除機能： remove_atとremove_afterのどちらか一方を指定可能。設定すると指定時刻に自動でロールが削除されます。

メッセージコマンドによるロール管理

メッセージコマンド

ロール管理メニュー表示

!shw grant_role_menu

ロール管理のメニューを表示します。各種ロール操作にアクセスできる便利なインターフェースです。

!shw grant_role_menu
ロール操作のメニューが表示され、ボタンでロール付与・削除などの操作を直感的に行えます。
メッセージコマンド

ロール付与

!shw grant_role [メンバー/ロール名] [付与するロール名]

引数の説明

  • メンバー/ロール名
    ロールを付与する対象（@メンバー名または@ロール名）
  • 付与するロール名
    付与したいロール名（@ロール名）
!shw grant_role @ユーザー名 @メンバーロール
指定したユーザーにメンバーロールを付与します。
!shw grant_role @全員ロール @イベント参加者
特定のロールを持つ全員にイベント参加者ロールを付与します。
権限： サーバーオーナー、ロール管理権限、または個別に許可されたロールが必要
メッセージコマンド

ロール削除

!shw revoke_role [メンバー/ロール名] [削除するロール名]

引数の説明

  • メンバー/ロール名
    ロールを削除する対象（@メンバー名または@ロール名）
  • 削除するロール名
    削除したいロール名（@ロール名）
!shw revoke_role @ユーザー名 @メンバーロール
指定したユーザーからメンバーロールを削除します。
!shw revoke_role @期間限定ロール @イベント参加者
期間限定ロールを持つ全員からイベント参加者ロールを削除します。
権限： サーバーオーナー、ロール管理権限、または個別に許可されたロールが必要

権限管理コマンド

メッセージコマンド

ロール管理権限の付与

!shw allow_grant_role [メンバー/ロール名] [管理可能ロール1] [管理可能ロール2]...

引数の説明

  • メンバー/ロール名
    権限を与える対象（@メンバー名または@ロール名）
  • 管理可能ロール
    付与・削除できるようにするロール（複数指定可能）
!shw allow_grant_role @モデレーター @イベント参加者 @ゲーム好き
モデレーターロールに、イベント参加者とゲーム好きロールの管理権限を付与します。
!shw allow_grant_role @リーダー @チームメンバー
リーダーロールにチームメンバーロールの管理権限を付与します。
権限： サーバー管理者権限が必要
メッセージコマンド

権限設定の確認

!shw show_allow_grant_role

現在設定されているロール管理権限のルールを一覧表示します。どのメンバー/ロールがどのロールを管理できるかを確認できます。

!shw show_allow_grant_role
設定されている全ての権限ルールをID付きで表示します。削除する際のIDも確認できます。
メッセージコマンド

権限設定の削除

!shw delete_allow_grant_role [ルールID1] [ルールID2]...

引数の説明

  • ルールID
    削除したい権限ルールのID（show_allow_grant_roleで確認可能）
!shw delete_allow_grant_role 1 3 5
ID 1、3、5の権限ルールを削除します。複数のルールをまとめて削除できます。
権限： サーバー管理者権限が必要

ロール作成・管理コマンド

メッセージコマンド

新規ロール作成

!shw create_roles [ロール名1] [ロール名2]...

引数の説明

  • ロール名
    作成したいロールの名前（複数指定可能、スペースが含まれる場合は「"」で囲む）
!shw create_roles "ゲーム好き" "映画好き" "音楽好き"
趣味に関する3つのロールを一度に作成します。スペースが含まれる場合はダブルクォートで囲みます。
!shw create_roles VIPメンバー プレミアム
VIPメンバーとプレミアムの2つのロールを作成します。
権限： ロール管理権限とホワイトリストロールが必要
注意： サーバーのロール数上限（250個）を超えないように注意してください

メンバー検索・統計コマンド

メッセージコマンド

ロール保有者一覧

!shw show_member_having_role [ロール名1] [ロール名2]...

引数の説明

  • ロール名
    確認したいロール名（複数指定可能）
!shw show_member_having_role @メンバー @ゲスト
メンバーロールまたはゲストロールを持っているメンバーの一覧を表示します。
!shw show_member_having_role @モデレーター
モデレーターロールを持つメンバーのみを表示します。
メッセージコマンド

ロール別メンバー数

!shw show_member_count_each_role [ロール名...]（省略可）

引数の説明

  • ロール名（省略可）
    確認したいロール名（省略時は全ロールの人数を表示）
!shw show_member_count_each_role
サーバー内の全ロールのメンバー数を表示します。サーバーの状況把握に便利です。
!shw show_member_count_each_role @メンバー @ゲスト
メンバーロールとゲストロールのみの人数を確認します。

使用上の注意事項

権限について

  • サーバーオーナー: すべてのロール操作が可能
  • ロール管理権限持ち: 自分より下位のロールの操作が可能
  • 個別権限: allow_grant_roleで許可されたロールの操作が可能

ロール階層について

  • ShabeleAのロールより上位のロールは操作できません
  • BOT専用ロールやブーストロールは操作対象外です
  • ロールの並び順を確認してから操作してください

レート制限について

  • 多数のメンバーに対する操作は時間がかかる場合があります
  • 処理中はコマンドを連打せずにお待ちください
  • 10人ごとに進行状況が更新されます
📋 機能一覧に戻る 🏠 ホームに戻る