when somebody puts your server’s vanity, /drain, discord.gg/drain, or any text you choose, in their custom status, drain gives them a role and thanks them in a channel. when they take it out, the role goes too.

setting it up

open the dashboard, pick your server and go to vanity. fill in what their status has to say (blank watches for your server’s own vanity link), up to ten roles, and the channel to thank them in, then switch it on. it needs a role or a channel before it can go on. the log channel and the thank you’s title, message and footer are under advanced.

the announcement

anything else in braces is refused, so a typo can’t slip into the announcement.

how matching works

  • only custom status text counts, and capitals don’t matter
  • it has to appear as a whole word: /frayfans doesn’t count for /drain. spaces around the / are fine
  • somebody who goes offline or invisible hasn’t stopped repping. drain waits until it can see their status again

timing

  • somebody who takes the vanity out keeps the role for five minutes, in case they’re just editing their status. this survives restarts
  • every server is checked in full every fifteen minutes, on top of watching statuses change live
  • a rep counts once every 24 hours. the announcement, which pings them, only goes out when a rep counts

every command

,vanity on its own shows how it’s set up.

worth knowing

  • drain only ever takes back a role it gave. if a moderator removes it by hand, drain stops managing it for that person
  • drain needs manage roles with every reward role below its own, and to send messages in the announcement and log channels
  • somebody who leaves the server is forgotten