drain keeps track of how long everybody spends in voice, and can hand out roles for it.

​
setting it up

voice time is kept from the start. rewards are yours to add.
open the dashboard, pick your server and go to messages & voice. the voice time switch turns tracking on or off for the server. under voice rewards, add up to 25 roles, each with how long it takes and how long it’s kept for (0 keeps it for good), then save.

​
ways to type it

,voicetime shows today, 7 days, 30 days, all time, and the rank this week. the leaderboard takes today, week (the default), month or all, the same as messages.

​
what counts

everybody except bots, anybody in the server’s afk channel, and people who opted out.
turning tracking off for the server stops new time being counted. time already kept stays.

​
how reward time builds up

a reward gives somebody a role once they’ve spent enough time in voice with other people. reward time is stricter than the time on ,voicetime:
  • it only counts in a channel with at least two eligible people in it
  • somebody who’s deafened, by themselves or the server, isn’t eligible. muted is fine
  • it only starts building once the server has at least one reward. time from before then doesn’t count
once somebody’s reward time reaches a reward, they get the role. a reward with an expiry is taken back when it runs out. to get it again they earn the whole threshold again, counted from the moment it ran out, so an expiring reward is one people keep by staying active.

​
every command

​
worth knowing

  • removing a reward doesn’t take the role back from people who already have it
  • if drain restarts while people are in voice, their time is closed off at the last minute drain saw them, never stretched over the gap