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. server or discord)
  • 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:

VariableDescriptionExample output
{user}Username of the person who typed the commandAhmed_Gamer
{channel}Channel nameMyChannel
{count}Number of times the command has been used42
{time}Current time14:30
{date}Current date2026-03-19
{uptime}Current stream uptime2 hours and 15 minutes
{game}Current gameValorant
{title}Current stream titleRanked with the squad
{viewers}Current viewer count150

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:

VariableDescription
$(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

LevelDescription
EveryoneAnyone in chat can use the command
SubscriberChannel subscribers only
VIPVIP members, subscribers, and moderators
ModeratorChannel moderators only
BroadcasterChannel 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