A chat command is a word your viewers type in chat, like !sound or !nexus, that triggers a reaction on your live: a sound, a voice reading a message, an alert on screen. In NexusTok, it all goes through the New message trigger on the Events page.
How NexusTok spots a command
- The message must be exactly the command: “!sound” triggers, “!sound pls” or “come on !sound” do not.
- Case does not matter: !sound, !Sound and !SOUND trigger the same command. Spaces at the start and end are ignored.
- The ! is not required: a word or a sentence works too (gg, hello…). The ! mostly stops a normal message from triggering by accident.
- With * as the command, the event reacts to every chat message.
- A command takes no argument: !sound 1 and !sound 2 are two different commands, each one to create.
Create your first command
- 1Open the Events page and create an event.
- 2In the library, under TRIGGERS, click New message.
- 3In the Chat command field, type your command, for example !sound.
- 4Add a reaction, for example Play Sound in the AUDIO category, and pick your sound.
- 5Set a value in Cooldown (s), then save the event.
- 6During your live, ask a viewer or a moderator to type !sound.
To type in Chat command
!sound*Anti-spam settings
With no limit, ten viewers typing !sound at once means ten sounds. Two settings in the event panel keep things under control:
- Cooldown (s): after it fires, the command stops responding for that many seconds, for everyone. 0 = no limit.
- Per-viewer cooldown (WHEN section): each viewer gets their own timer. Whoever just triggered it waits, everyone else can still trigger it. This setting uses the Cooldown (s) value: at 0, it limits nothing.
- During the cooldown, the message is simply ignored: nothing fires and nothing shows.
Who can trigger the command
The WHO CAN TRIGGER section keeps a command for part of the chat. If you turn on several options, the viewer has to meet all of them.
- Moderators only: only your live’s moderators. Ideal for management commands.
- Subscribers only: only viewers with a paid monthly subscription to your live, not a plain follow.
- Followers only: only viewers who follow you.
- Specific viewer: a single viewer, whose TikTok username you type (with or without @, the profile username, not the display name). With * as the command, every one of their messages triggers.
In the WHEN section, Heart of the Day only lets through viewers who sent you the small Heart Me gift (ID 7934) today. NexusTok remembers it all day, even if you restart the live or the app: a simple way to reward the people who support you.
Reuse the message with {message}
In the text of a Text to Speech or Send Alert reaction, these variables are replaced with the message details: {nickname} (display name), {username} (TikTok handle) and {message} (the full comment text).
Text templates
{nickname} says: {message}Welcome {nickname}!Text to speech strips emojis before reading and prepares one message at a time: when several arrive together, some can be skipped. With *, keep a cooldown, or a fast chat drowns the voice.
Command ideas
- !sound: Play Sound with a short sound effect, Cooldown (s) at 20 and Prevent stacking.
- !nexus: Text to Speech that introduces your live or your schedule, with a Cooldown (s) of 120 so it does not loop.
- !gg: a victory sound for Followers only, with a Per-viewer cooldown of 120 s.
- !win and !reset: Win Counter set to Increment or Reset to 0, with Moderators only. Your mods keep score for you.
- * with Heart of the Day and a Per-viewer cooldown of 60 s: the TTS reads “{nickname} says: {message}” only for viewers who sent you a Heart Me today.
- * with Specific viewer and a Cooldown (s) of 3600: a jingle when your top supporter writes, at most once an hour.
Does the Test button respect the cooldown and filters?
No. Test plays the reactions directly, without checking the command, the cooldown or who sent it. To check those settings, have someone type the command during a live.
Are chat commands free?
Yes: the New message trigger, sounds, text to speech, alerts and the win counter are part of the free plan, within that plan’s event limit. Video reactions need Pro.
Why does my command not trigger?
Check that the message is exactly the command with no extra word, that the event is active, that the cooldown is over and that the viewer meets the WHO CAN TRIGGER options.
What about YouTube Live?
Commands work with YouTube chat too. However, Moderators only, Subscribers only, Followers only and Heart of the Day rely on TikTok data: on YouTube, a command with any of them turned on fires for nobody.
Set it up on your next live
Install NexusTok, connect your live, add your first overlay to OBS.
Download for freeFree to start, no credit card, Windows 10 and 11