Documentation

Voice-Time Roles

Automatically award roles to members based on how long they've spent in voice channels.

Voice-Time Roles reward members for hanging out in voice. Set a threshold like "5 hours in voice gives @Regular" and exceed assigns the role automatically once a member crosses it. You can stack tiers and optionally strip the role if their tracked time later drops below the threshold. It is off by default.

Commands

Needs Manage Roles. Aliases: ,voiceroles, ,vctimeroles, ,vcroles.

,voicetimeroles list                                show config and reward roles
,voicetimeroles enable                              turn rewards on
,voicetimeroles disable                             turn rewards off
,voicetimeroles add <@role> <hours> [removeifbelow] award a role after N hours
,voicetimeroles remove <@role>                      stop awarding a role
,voicetimeroles period <all|month|week>             set the measured time window

Use 0 hours to grant a role instantly. Add removeifbelow to also remove it if the member drops below the threshold.

Example

,voicetimeroles add @Regular 5
,voicetimeroles add @Newcomer 0
,voicetimeroles period week

You can also configure everything on the Voice-Time Roles dashboard page. exceed can only assign roles below its own highest role.