跳到主要内容

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 设置了正确的时区。

常见问题

  • 问: 我可以修改结束时间吗? 答: 可以。再次运行命令输入新的时间即可更新。

  • 问: 如果我修改了结束时间,会对已拥有身份组的成员生效吗? 答: 会的。定时模式是基于身份组的配置,一旦修改结束时间,所有持有该身份组的成员都会按照新的时间点过期。