temprole scheduled_role - 创建或编辑定时身份组
命令名称
/temprole scheduled_role
描述
此命令用于将 Discord 服务器中的一个普通身份组设定为定时身份组,RoleTimer Bot 将在预定的时间点自动从所有成员身上移除该身份组。
与“计时身份组”(按时长计算)不同,定时身份组是根据具体的日期和时间来过期的。例如:“2026年1月1日12点30分”过期。到期后,RoleTimer Bot 会自动将该身份组从所有成员身上移除。非常适合用于有固定结束日期的活动,或是在特定日期结算的特殊身份。
你还可以设置“后续身份组”,以便在过期时自动为成员分配新的 Discord 身份组。此外,支持“联动移除身份组”功能,过期时会自动移除指定的身份组。
用法
/temprole scheduled_role <role> <end_time> [auto_delete] [next_role] [next_role_2] [linked_remove_role] [linked_remove_role_2]
参数
必选参数
<role>: 选择要设定为定时身份组的 Discord 身份组。<end_time>: 设置结束时间。格式:YYYY-MM-DD HH:MM(例如2026-05-20 12:00)。- 限制:免费版最长30天,Premium 无限制。
可选参数
[auto_delete]: 如成员数超限,过期时自动删除 Discord 身份组(默认:否)。- 注意:若选择“是”,到期后该身份组将彻底从服务器删除。
[next_role]: 过期后自动分配的 Discord 身份组。[next_role_2]: 过期后自动分配的第二个身份组。[linked_remove_role]: 过期时同步移除的身份组。[linked_remove_role_2]: 过期时同步移除的第二个身份组。
示例
示例 1: 设置 @活动参与者 在 2026年10月1日 00:00 过期。
/temprole scheduled_role role:@活动参与者 end_time:2026-10-01 00:00
示例 2: 设置 @新年快乐 在 2月1日 过期,并自动从服务器删除该身份组。
/temprole scheduled_role role:@新年快乐 end_time:2026-02-01 00:00 auto_delete:是
Premium 功能
- 创建数量:免费版限 5 个,Premium 无限制。
- 成员限制:免费版单个定时身份组限 200 人,Premium 限 1000 人。
- 持续时间:免费版最长 30 天,Premium 无限制。
- 后续身份组:免费版不支持过期后自动分配新身份组,Premium 支持。
- 联动移除身份组:免费版不支持过期时同步移除身份组,Premium 支持。
注意事项
- 所有成员统一过期:无论成员是何时获得该身份组的,大家都会在同一个时刻(设定的结束时间)失去它。
- 处理延迟:如果同一时间有大量成员需要移除身份组,RoleTimer Bot 的处理可能会有一定的延迟。
- 人数超限与自动删除:如果单一身份组的人数超过限制,RoleTimer Bot 将无法逐个移除成员,你可能需要在到期后手动删除身份组。建议将
auto_delete设为是(True),这样即使超限,RoleTimer Bot 也可以在到期时直接删除整个 Discord 身份组,确保移除生效。 - 权限层级:RoleTimer Bot 的身份组层级必须高于目标身份组。
- 时区设置:由于时间点是固定的,请确保服务器已通过
/settings timezone设置了正确的时区。
常见问题
-
问: 我可以修改结束时间吗? 答: 可以。再次运行命令输入新的时间即可更新。
-
问: 如果我修改了结束时间,会对已拥有身份组的成员生效吗? 答: 会的。定时模式是基于身份组的配置,一旦修改结束时间,所有持有该身份组的成员都会按照新的时间点过期。