Away & Timezone
Members mark themselves away for a set time, and tell the server what time it is where they are.
Two questions this answers about a person: is she here right now, and is it even a reasonable hour where she is. In a community spread across timezones, the second one decides whether the first one matters.
Marking yourself away
/afk set
/afk set reason:In a meeting until 3
/afk set reason:Holiday time:2w
time: takes plain durations — 30m, 2h, 3d, 1w, or combinations like 1d12h. No dates to type; the bot counts forward from now.
When someone mentions an away member, the bot posts a short note with the reason, when they're back, and their local time if they've set one.
Posting doesn't always clear it
This is the part worth knowing:
| How you set it | What happens when you post |
|---|---|
/afk set (no time) | Cleared — you're obviously back |
time: under a day | Cleared |
time: of a day or more | Stays. You get a quiet reminder instead |
The reasoning: "back in ten minutes" ends the moment you type something. "Away for two weeks" shouldn't be undone because you checked in once from your phone. Use /afk back when you're really back.
The comparison uses the duration you declared, not the time remaining — so a two-week absence still behaves like a two-week absence on its last day.
Everything expires
Nothing stands forever. A duration you set expires on time; an /afk set without one expires after 30 days. Expiry is silent — the bot won't announce a return you didn't make.
Seeing who's away
/afk list — everyone currently away, soonest back first
/afk info @user — one person, without pinging them
/afk info exists for a specific reason: normally you only learn someone is away by mentioning them, which notifies the very person who asked not to be disturbed. This asks quietly.
/afk list shows up to 20 entries and counts the rest.
Timezones
/timezone set zone:Europe/Berlin
/timezone show user:@alice
/timezone clear
Start typing and the bot suggests matches. It understands cities (berlin, new york), abbreviations (PST, CET, GMT) and many country names (germany, japan) — not just the full Region/City names. If your zone isn't suggested, type the IANA name directly.
/timezone show gives the person's local time, plus how far ahead or behind you they are when you've both set one.
Your timezone applies across the whole network. Set it once on any server in the network and every other server knows it — a single-server bot can't do that.
Why the bot needs this at all
Discord renders timestamps in the reader's timezone. That's useful, but it means Discord can never tell you what time it is for someone else — the one thing you need in order to know whether a reply is coming tonight or tomorrow.
Privacy
A timezone is roughly a location, so it's treated as personal data:
- Nothing is stored until a member runs
/timezone setthemselves. /timezone clearremoves it completely, at any time./afk listmakes absences visible together rather than one at a time. Everything in it was set voluntarily by the member, but it is a broader view than before — worth knowing if your server is careful about that.
Good to know
- AFK status is per server. Your timezone is per network.
- The notice is a normal channel message, so everyone in the conversation sees it — that's the point.
- No dashboard page: enable the plugin and the commands are there.
Requirement: Send Messages in the channels where notices should appear.