> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dontmisstwice.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Availability

> Players tell the bot when they can play, once — and it feeds every scheduling decision downstream.

Players tell the bot when they can play, once, and it feeds everything
downstream: who to field, who to call in, and who to stop asking.

## What players run

<ResponseField name="/availability set" type="one weekday at a time">
  `day:Wed from:6pm to:11pm`. Set `timezone:` once and it sticks to their
  profile.
</ResponseField>

<ResponseField name="/availability exception" type="a single date">
  Overrides the weekly pattern for one day. Exams, holidays, a late shift.
</ResponseField>

<ResponseField name="/availability view" type="read it back">
  Their own week, privately.
</ResponseField>

<ResponseField name="/availability clear" type="start over">
  Wipes the weekly schedule.
</ResponseField>

Times are forgiving: `6pm`, `6:30 PM`, and `18:30` all work.

<Check>
  A player's schedule covers **every division they play in**. They submit it
  once, not once per team.
</Check>

## Timezones

Windows are stored in **each player's own timezone**, so an org spanning NA and
EU compares correctly, and daylight saving is handled without anyone
re-entering anything.

<Info>
  A player in New York who says "Wednesdays, 6–11pm" means their 6pm, in
  whichever offset is current that week. Nobody does the conversion by hand and
  nothing goes stale in March or November.
</Info>

## What staff see

<Tabs>
  <Tab title="The weekly grid">
    `/roster availability division:SNP-M` — every player's week at a glance, with
    a check mark on the days they have a window.

    The same grid appears on `/admin/roster`.
  </Tab>

  <Tab title="One exact moment">
    `/roster when division:SNP-M time:2026-09-02T20:00:00-04:00` — splits the
    roster into **available**, **unavailable**, and **no schedule on file** for
    that specific instant.

    Players on leave are never listed as available.
  </Tab>
</Tabs>

## The number worth chasing

<Warning>
  **"Unavailable" and "never told us" are different things.** Players with no
  schedule on file are reported separately everywhere, never folded in as busy.

  The dashboard counts them for you. Chase that number — a blank schedule is the
  one thing that quietly makes every other tool less useful.
</Warning>

Availability feeds directly into [lineups](/site-bot/match-day), which is where
you'll feel the gap if people haven't filled it in.