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

# Shift Logging

> Track on-duty staff, quotas, and shift hours inside Discord.

Replace manual hour spreadsheets with clock-in/out commands. Leadership sees who is active, how hours stack up, and whether quotas are met — all from Discord.

In **`/config`**, this module appears as **Shifts**.

## Staff commands

Requires a configured **Staff** role (or higher).

| Command                  | What it does                          |
| ------------------------ | ------------------------------------- |
| **`/shift manage`**      | Clock in, start a break, or clock out |
| **`/shift time`**        | Hours for you or another member       |
| **`/shift active`**      | Live on-duty roster                   |
| **`/shift leaderboard`** | Ranked by total hours                 |

## Admin commands

Requires **Admin** (or higher).

| Command                   | What it does                          |
| ------------------------- | ------------------------------------- |
| **`/shift admin`**        | Override another member's shift state |
| **`/shift quota reset`**  | Clear quota progress for a shift type |
| **`/shift quota status`** | Quota completion across staff         |

## Base module settings

| Setting             | What it controls              |
| ------------------- | ----------------------------- |
| **Module State**    | On/off for shift tracking     |
| **Logging Channel** | Where clock events are posted |

## Shift types

Open **Configure options...** to create the roles your server uses — Moderation, Dispatch, Training, and so on.

| Field               | Example / notes                           |
| ------------------- | ----------------------------------------- |
| **Shift Name**      | `Moderator`                               |
| **Quota**           | `10h` or `2d` — required hours per period |
| **Staff Limit**     | Cap concurrent on-duty staff              |
| **Nickname Prefix** | Prefix while clocked in                   |
| **Required Roles**  | Who may use this type                     |
| **On Duty Role**    | Applied during active shift               |
| **Break Role**      | Applied during breaks                     |

Use **Add Shift Type**, **Edit Shift Type**, **Remove Shift Type**, or **Shift Type List** in the config panel to manage them.

<Note>
  Free servers: up to **3** shift types. **Warden+**: up to **10**. The config panel shows your current count.
</Note>
