temprole scheduled_role - 設定定時身分組

指令名稱

/temprole scheduled_role

此指令用於將 Discord 伺服器中的一個普通身分組設定為定時身分組。

與「計時身分組」（按時長計算）不同，定時身分組是根據具體的日期和時間來過期的。例如：「2026年1月1日」過期。到期後，RoleTimer Bot 會自動將該身分組從所有成員身上移除。

你還可以設定「後續身分組」，以便在過期時自動為成員分配新的 Discord 身分組。此外，支援「自動刪除」選項：當身分組過期時，直接從 Discord 伺服器中刪除該身分組本身。

/temprole scheduled_role <role> <end_time> [next_role] [auto_delete]

<role>: 選擇要配置的 Discord 身分組。
<end_time>: 設定結束時間。格式：YYYY-MM-DD HH:MM (例如 2026-05-20 12:00)。
- 限制：免費版最長30天，Premium 無限制。

[next_role]: 過期後自動分配的 Discord 身分組。
[auto_delete]: 是否在過期時直接刪除該 Discord 身分組？ (默認：否)。
- 注意：若選擇「是」，到期後該身分組將徹底從伺服器刪除。

範例 1: 設定 @活動參與者 在 2026年10月1日 00:00 過期。

/temprole scheduled_role role:@活動參與者 end_time:2026-10-01 00:00

範例 2: 設定 @萬聖節限定 在 11月1日過期，並自動從伺服器刪除該身分組。

/temprole scheduled_role role:@萬聖節限定 end_time:2026-11-01 00:00 auto_delete:是

所有成員統一過期：無論成員是何時獲得該身分組的，大家都會在同一個時刻（設定的結束時間）失去它。
處理延遲：如果同一時間有大量成員需要移除身分組，RoleTimer Bot 的處理可能會有一定的延遲。
人數超限與自動刪除：如果單一身分組的人數超過限制，RoleTimer Bot 將無法逐個移除成員，你可能需要在到期後手動刪除身分組。建議將 auto_delete 設為 是 (True)，這樣即使超限，RoleTimer Bot 也可以在到期時直接刪除整個 Discord 身分組，確保移除生效。
權限層級：RoleTimer Bot 的身分組層級必須高於目標身分組。