Custom Commands
Custom commands let you create channel-specific commands that the bot responds to when typed in chat. You can create commands in any language with any content.
Creating a New Command
From the dashboard, go to the Commands section and click Add Command. Set:
- Command name: The word a viewer types (e.g.
serverordiscord) - Prefix: You can use
!as a prefix or omit it entirely - Response: The message the bot replies with
- Permission: Who can use the command
- Cooldown: Minimum time between uses
Command Examples
Command: !server Response: Discord server: discord.gg/example Command: !youtube Response: My YouTube channel: youtube.com/@channel
Variables
You can use the following variables in a command response — they are automatically replaced with their real values:
| Variable | Description | Example output |
|---|---|---|
| {user} | Username of the person who typed the command | Ahmed_Gamer |
| {channel} | Channel name | MyChannel |
| {count} | Number of times the command has been used | 42 |
| {time} | Current time | 14:30 |
| {date} | Current date | 2026-03-19 |
| {uptime} | Current stream uptime | 2 hours and 15 minutes |
| {game} | Current game | Valorant |
| {title} | Current stream title | Ranked with the squad |
| {viewers} | Current viewer count | 150 |
Example using variables:
Command: !stream
Response: Hey {user}! {channel} is playing {game} for {viewers} viewers — live for {uptime}Supported Nightbot Variables
TheebBot also supports Nightbot variable syntax to make migration easier:
| Variable | Description |
|---|---|
| $(user) | Username of the person who typed the command |
| $(channel) | Channel name |
| $(query) | Text written after the command |
| $(touser) | Targeted user (or sender if none specified) |
| $(twitch) | Information from the Twitch API |
| $(urlfetch) | Fetch content from an external URL |
Permission Levels
| Level | Description |
|---|---|
| Everyone | Anyone in chat can use the command |
| Subscriber | Channel subscribers only |
| VIP | VIP members, subscribers, and moderators |
| Moderator | Channel moderators only |
| Broadcaster | Channel owner only |
Cooldown
The cooldown sets the minimum time (in seconds) between each use of a command. This prevents spam and keeps chat clean. For example, if the cooldown is set to 30 seconds, the bot will not respond to the command again until 30 seconds have passed since the last use.
Ready to get started?
Add TheebBot to your channel now for free and start customizing in minutes