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

# Twitch Chatbot

> Automate Twitch chat with custom commands and timers. Control overlays from chat messages.

## Vision Chatbot

The Vision Chatbot automates interactions with your Twitch chat. Create custom commands, schedule automatic messages, and connect chat actions to your overlays - all without writing code.

***

## Features

### Commands

Create custom chat commands that:

* Respond to viewers
* Control overlay layers
* Display information
* Trigger actions

[Learn more about Commands →](/chatbot/commands)

### Timers

Schedule automatic messages:

* Post at regular intervals
* Announce social links
* Remind viewers about events
* Trigger overlay changes

[Learn more about Timers →](/chatbot/timers)

### Filters

Moderate chat automatically:

* Block unwanted content
* Timeout rule breakers
* Delete spam messages

***

## Getting Started

<Steps>
  <Step title="Go to Chatbot">
    In the dashboard sidebar, click **Chatbot**
  </Step>

  <Step title="Connect your channel">
    Ensure your Twitch account is connected
  </Step>

  <Step title="Create your first command">
    Click **Commands** and create a new command
  </Step>

  <Step title="Test it">
    Type the command in your chat to verify it works
  </Step>
</Steps>

***

## How It Works

The chatbot:

1. Monitors your Twitch chat for triggers
2. Matches messages against your commands
3. Executes the configured response or action
4. Optionally controls overlay layers

All of this happens automatically while you focus on streaming.

***

## Integration with Overlays

The chatbot can control your overlays:

| Action                | Example                          |
| --------------------- | -------------------------------- |
| **Modify counters**   | `!death` adds 1 to death counter |
| **Control timers**    | `!pause` pauses a countdown      |
| **Trigger rotations** | Commands cycle logo displays     |
| **Toggle visibility** | Show/hide layers via chat        |

***

## Permissions

Control who can use commands:

### Role-Based Access

* **Everyone** - Any viewer can use
* **Subscribers** - Subscriber-only commands
* **VIPs** - VIP-only commands
* **Moderators** - Mod-only commands
* **Broadcaster** - Only you can use

### Whitelist/Blacklist

* Allow specific users
* Block specific users

***

## Cooldowns

Prevent command spam:

### Global Cooldown

Applies to everyone - no one can use the command until cooldown expires.

### Per-User Cooldown

Each user has their own cooldown - others can still use the command.

***

## Conditions

Commands can have conditions:

| Condition         | Description                |
| ----------------- | -------------------------- |
| **Stream status** | Only when live/offline     |
| **Game**          | Only for specific games    |
| **Title**         | Only when title matches    |
| **Time of day**   | Only during certain hours  |
| **Day of week**   | Only on specific days      |
| **Viewer count**  | Only above/below threshold |

***

## Tips

<Tip>
  **Start simple** - Create a few basic commands before building complex automations.
</Tip>

<Tip>
  **Use cooldowns** to prevent spam, especially on popular commands.
</Tip>

<Tip>
  **Test offline** - Verify commands work before going live.
</Tip>

***

## Next Steps

* [Create Commands](/chatbot/commands) - Set up chat commands
* [Schedule Timers](/chatbot/timers) - Automate recurring messages