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

# Discord Bot

> Stay connected to MANIA from anywhere

<Tabs>
  <Tab title="DM Notifications">
    Default setup - notifications go to your DMs.

    <Steps>
      <Step title="Open Alerts settings">
        In MANIA, go to **Settings → Alerts**.
      </Step>

      <Step title="Click the Discord button">
        Once connected, it will display **Discord: Direct Message**.
      </Step>
    </Steps>

    <Note>
      Can't receive DMs? [Message the bot](https://discord.com/users/1375295078561747034) first to open a DM channel.
    </Note>
  </Tab>

  <Tab title="Server Notifications">
    Send notifications to a Discord server channel.

    <Steps>
      <Step title="Invite the bot">
        Add [MANIA Bot](https://discord.com/oauth2/authorize?client_id=1375295078561747034\&permissions=35840\&scope=bot%20applications.commands) to your server.
      </Step>

      <Step title="Run setup">
        In your desired channel, run `/setup`.
      </Step>
    </Steps>

    <Warning>
      Anyone in the server can use commands to control your bot. Only invite to servers you trust.
    </Warning>
  </Tab>
</Tabs>

## Commands

| Command          | Description                                |
| ---------------- | ------------------------------------------ |
| `/start`         | Start the bot                              |
| `/stop`          | Stop the bot                               |
| `/ss`            | Take a screenshot                          |
| `/cc`            | Request channel change                     |
| `/tof [action]`  | View or change Threads of Fate NPC         |
| `/buff [action]` | View or toggle auto buff                   |
| `/chat <msg>`    | Send a chat message                        |
| `/key <key>`     | Press a key                                |
| `/ld <msg>`      | Send lie detector answer                   |
| `/schedules`     | View and manage scheduled commands         |
| `/setup`         | Switch between DM and server notifications |

### Scheduling

`/start`, `/stop`, `/cc`, `/ss`, `/tof`, and `/buff` can be scheduled for later using the `t` option.

```
/start t: 5pm EST
/stop t: tomorrow 3am
/cc t: in 30 mins
```

Use `/schedules` to view pending commands, or `/schedules cancel: <id>` to cancel one.

### Settings commands

`/tof` and `/buff` accept an optional `action` to change the setting. Without it, they show the current status.

```
/tof action: Tengu
/tof action: Disable
/buff action: Enable
```

**`/tof` choices:** Tengu, Ibaraki, Takeno, Kurama, Disable
**`/buff` choices:** Enable, Disable

### Instance targeting

If you run multiple instances, most commands accept an `id` option to target a specific one. Without it, the command runs on all active instances.

```
/ss id: 1
/stop id: 2
```
