Bot Commands

Here you manage the bot's default commands and your own commands that can be used in chat.

Dashboard overview

On this page you manage default commands and custom commands and adjust permissions, cooldowns, and responses.

Default commands

The default commands are organized into four categories: Information · Moderation · Stream Management · Utility

All commands can be individually configured in the dashboard.

Custom commands

Under this tab you create and manage your own commands. Enter a name under Command and the text the bot should post under Response. You can also set aliases when creating a command, i.e. alternative names. Once created, the command has the same settings as default commands (see Configuration fields below). At the bottom right you will find the Variables button with all available placeholders.

Templates

If you are new to bot commands, the Templates button helps you get started. The templates are deliberately chosen to show you how variables work, grouped into Address viewers, Random & fun and Stream info & counters.

Each template demonstrates one variable, for example:

• !lurk – $(sender) (the name of whoever runs the command)
• !hug – $(sender) and $(touser) (addresses another chatter)
• !slap – $(1) (the text the viewer types after the command)
• !dice – $(random 1 6) (random number)
• !decide – $(randompick("Yes","No","Maybe")) (random choice)
• !randomclip – $(randomclip) (links a random clip from your channel)
• !game – $(game) (current stream category)
• !deaths – $(count deaths +1) (a counter that counts up on every use)

Clicking Use fills the creation form above with that template. You can still adjust the text, then click Add. Templates are therefore not saved directly; they serve as a starting point for learning. Most examples work right away without any changes.

Public commands overview

At the top of the page you will find the link to your public commands overview at https://bytemate.me/commands/[yourchannel]. The Active/Inactive toggle next to it lets you enable or disable this page for your viewers. When the overview is disabled, visitors see a short notice instead.

Configuration fields

Each command supports the following settings:

• User Level: Who is allowed to use this command. The selected role and higher roles can trigger it.
• When active?: Always active or only when the stream is online/offline.
• Cooldown Global/User: Total time or per-viewer time before the command can be used again.
• Command aliases: Alternative names for the command; can be added with or without !.
• Response: Enter your response. Clicking the default button at the top right resets the response to the default. Under the textbox you can see the variables you can use.

The Active toggle for each command enables/disables it for chat.

Per-user command access (Grants)

The grant system lets you give individual viewers access to specific commands — even if their user level would normally be too low.

In the dashboard

Every command has a collapsible "Special User Permissions" section. There you can see all active grants for that command and:

• Enter a Twitch login and choose an expiry (Permanent, 1 hour, 24 hours, 7 days, or 30 days)
• Revoke grants with the Revoke button

Via chat command

Grant access:

!grant @username command [duration]

• @username – Twitch login of the user (@ is optional)
• command – command name without ! (e.g. uptime, so)
• duration – optional: 30m, 2h, 1d – if omitted the grant is permanent

Revoke access:

!revoke @username command

!grant and !revoke are restricted to moderators. Expired grants are deactivated automatically; re-granting updates the expiry.

Variables

A complete list of variables is available in the Bot Variables section. You can write variables as $(...) or ${...}; positional arguments also work with {1}, {2}, etc.