Nightbot Commands

Broadcaster Commands


Command
Broadcaster !nightbot join
Broadcaster !nightbot remove

Broadcaster Commands


Command Description Example
Broadcaster !nightbot join This is what tells Nightbot to join your chatroom. This only works in Nightbot's channel.
Night: !nightbot join
Nightbot: night -> Joining channel: night
Broadcaster !nightbot remove Forces Nightbot to leave your chatroom
Night: !nightbot remove
Nightbot: night -> Ok, I will leave this channel. Goodbye.
Broadcaster !songs on/off Enables or Disables song requests in your channel
Night: !songs on
Nightbot: night -> Song requests enabled

Custom Commands

Nightbot is able to be programmed with customized commands which can be utilized to display information to your chatroom.
Most frequently social links are utilized as commands, but there is a multitude of cool commands you can form by utilizing variables.
Command Description Example(s)
Mod !addcom -ul=level  !command  response Allows you add custom commands to Nightbot.
Listing a userlevel is optional.
Possible userlevels are "owner", "mod", and "reg".
To allow everyone to use the command, do not flag a userlevel.
Check the wiki for more in-depth documentation.
Night: !addcom -ul=mod !testing @user@ says they are testing this feature to @touser@ for the @cnt@th time
Nightbot: night -> Command !testing has been created.
Night: !testing Bob
Nightbot: Night says they are testing this feature to Bob for the 5th time
Mod !countdown !command  date Allows you set a date/time for a countdown via the "@countdown@" parameter in commands
Night: !countdown !newyear Jan 1 2013 12:00:00 EST
Nightbot: night -> The countdown to "Jan 1 2013 12:00:00 EST" has been added to the database.
Mod !delcom !command Delete a custom command added to Nightbot
Night: !delcom !testing
Nightbot: night -> The command "!testing" has been removed from the database.
Mod !editcom -ul=level  !command  response Lets you edit existing custom commands on Nightbot.
Night: !editcom -ul=mod !testing @user@ says they are retesting this feature to @touser@ for the @cnt@th time
Nightbot: night -> Command !testing has been updated.

General Commands


Command Description Example
Mod !cancelad Cancels an impending advertisement that a timer is about to run. It's pretty useful for those badly timed ad moments.
Night: !cancelad
Nightbot: night -> The commercial has been canceled.
!commands Takes you to this page
Night: !commands
Nightbot: night -> The bot commands for this channel are available at http://nightbot.tv/commands/night
Mod !disable !command true/false Disables any chat commands that are unwanted. Works with any chat command.
Night: !disable !topic true
Nightbot: night -> Command !topic disabled.
Mod !game game name Updates the channel's game on Twitch
Night: !game Battlefield 3
Nightbot: night -> Updated current game: Battlefield 3
Mod !giveaway on/off Starts a random number giveaway, or turns off any giveaway function.
Night: !giveaway on
Nightbot: night -> The random giveaway is about to begin
Mod !reg add/del username Users on the regular list are able to post links and evade spam filters
Night: !reg add blindfolded
Nightbot: night -> blindfolded has been added to the regulars list.
Mod !silence on/off Silences Nightbot in your channel. You can still use !commands, but it won't respond.
Night: !silence on
Nightbot: night -> Nightbot is now silenced in this channel.
Mod !status title Updates the channel's status/title on Twitch
Night: !status Battlefield 3 in HD
Nightbot: night -> Updated current status: Battlefield 3 in HD
Mod !winner Picks a random user from chat as the winner
Night: !winner
*Nightbot !!! gspwar !!! (gspwar currently follows this channel)

Poll Commands

Nightbot has the ability to poll chatters to help you make decisions in your channel.
Any moderator can start a poll, but only one poll can be open at a time.
Command Description Example
Mod !poll open option | option | etc. This allows you to start a poll within the chat.
Night: !poll open yes | no | maybe
Nightbot: night -> Started a poll with the options: 1: yes, 2: no, 3: maybe. Type "!vote [OptionNumber]" cast your vote!
Mod !poll close Closes the poll and displays the results
Night: !poll close
Nightbot: night -> The poll has been closed! [Results] yes: 1 votes, no: 0 votes, maybe: 0 votes
Mod !poll reset Restarts a poll (with 0 votes)
Night: !poll reset
Nightbot: night -> Restarted a poll with the options: 1: yes, 2: no, 3: maybe. Type "!vote [OptionNumber]" cast your vote!
Mod !poll results Displays the results of both an ongoing poll or a closed poll
Night: !poll results
Nightbot: night -> [Results] yes: 1 votes, no: 0 votes, maybe: 0 votes
!vote option number Casts a vote in an open poll
Night: !vote 1
Nightbot: night -> You have now cast your vote for test

Song Request Commands

Song requests is a fully automated song queueing system in which chatters can request a song from YouTube or Soundcloud and have it play on your stream.
This functionality requires that the AutoDJ Player be open during your cast, as this is how music is played.
Command Description Example
!currentsong Displays the current song that is playing on the stream
Night: !currentsong
Nightbot: night -> "Bowling For soup - I Ran (So Far Away)" - Requested by night - SID 579.
Mod !delsong song id Deletes a song from the song queue
Night: !delsong 21
Nightbot: night -> Song #21 - "Jack Sparrow (feat. Michael Bolton)" removed from database.
!nextsong Displays the next song that will play on the stream
Night: !nextsong
Nightbot: night -> "Timeflies - For You" - Requested by night - SID 22
Broadcaster !promote song id Moves a song to the top of the queue
Night: !promote 34
Nightbot: night -> This song has been promoted.
Mod !skipsong Skips the current song playing and moves on to the next
Night: !skipsong
Nightbot: night -> Song #23 has been skipped
Mod !skipsong vote In the event that song vetoing is enabled, this command allows mods to vote
Night: !skipsong vote
Nightbot: night -> There is now 1 vote to skip "Bon Jovi - It's My Life"
Broadcaster !skipsong veto on/off Toggles song vetoing on and off. Song vetoing allows chatters to use !skipsong
Night: !skipsong veto on
Nightbot: night -> Song vetoing enabled
Broadcaster !skipsong veto autoskip on/off Toggles whethor or not Nightbot will automatically skip the song after the veto limit have been reached. Default: on
Night: !skipsong veto autoskip on
Nightbot: night -> Song Veto Autoskipping Enabled
Broadcaster !skipsong veto limit on/off/number Sets the minimum number of votes that are required to skip a song. Default: 5
Night: !skipsong veto limit 8
Nightbot: night -> Custom song veto threshold set to: 8
!songs Provides instructions on how to request a song
Night: !songs
Nightbot: night -> To request a song, type "!songrequest [youtube video ID]." Your Youtube Video ID is the last part of a Youtube URL after the ?v=
!songs list Provides a link to manage your personal song list
Night: !songs list
Nightbot: night -> You can view your personal song list at http://www.nightbot.tv/usersongs/night
!songs list play Request a song from your personal song list
Night: !songs list play daydreamer
Nightbot: night -> The song "Daydreamer by Flux Pavilion" has been added to the queue.
!songs list stealsong Adds the current playing song to your personal song list
Night: !songs list stealsong
Nightbot: night -> The song "Skrillex - Cinema (Official)" has been stolen.
!songlist Provides a link to the channel song list
Night: !songlist
Nightbot: night -> You can see the full song list here: http://www.nightbot.tv/songlist/night
!songrequest YouTube Video ID or Soundcloud URL Lets you request a song to play on the stream
Night: !songrequest k6lVhGeyXuw
Nightbot: night -> The song "Skrillex - Cinema (Official)" has been added to the queue.
Mod !songrequest userlevel sub/reg/mod/off Forces Nightbot to only take song requests from subscribers, regulars, or moderators
Night: !songrequest userlevel sub
Nightbot: night -> Song requests are now limited to subscribers, regulars, and moderators.
Mod !volume number from 0 to 100 Allows moderators to change the volume of the music remotely
Night: !volume 70
Nightbot: night -> The volume has been changed to 70

Spam Protection Commands

Nightbot has a very customizable spam protection system. Spam protection filters out a large part of the nonsense that people seem to post in chats. All of these filters have the ability of custom timeout messages, which allow you to yell at spammers in a more personal way, and custom limits, which allow you to configure the exact amout of spam you tolerate in your channel.
It is important to note that you can add users to your regulars list to let them bypass these filters. Subscribers can also be configured to bypass these filters as well.
Command Description Example
Mod !allow username Allows a user to post a link. !permit can also be used.
Night: !allow blindfolded
Nightbot: night -> blindfolded has been granted permission to post a link.
Mod !capstime on/off Toggles the caps protection on and off
Night: !capstime on
Nightbot: night -> Caps timeout enabled
Mod !capstime limit on/off/number from 8+ Sets the threshold for caps protection (minimum number of capital letters) Default: 8
Night: !capstime limit 12
Nightbot: night -> Custom caps timeout threshold set to: 12
Mod !capstime msg on/off/message Sets a custom message for Nightbot to give a user when warned or timed out
Night: !capstime msg Please do not post in all caps
Nightbot: night -> Custom caps timeout message set to: Please do not post in all caps
Mod !capstime silence on/off Toggles the timeout messages on and off for caps timeouts.
Night: !capstime silence on
Nightbot: night -> Caps timeouts are now silenced
Mod !emotetime on/off Toggles the emote protection on and off
Night: !emotetime on
Nightbot: night -> Emote timeout enabled
Mod !emotetime limit on/off/number from 5+ Sets the threshold for emote protection (maximum number of emoticons) Default: 5
Night: !emotetime limit 5
Nightbot: night -> Custom emote timeout threshold set to: 5
Mod !emotetime msg on/off/message Sets a custom message for Nightbot to give a user when warned or timed out
Night: !emotetime msg Please do not spam emotes
Nightbot: night -> Custom emote timeout message set to: Please do not spam emotes
Mod !emotetime silence on/off Toggles the timeout messages on and off for emote timeouts.
Night: !emotetime silence on
Nightbot: night -> Emote timeouts are now silenced
Mod !linktime on/off Toggles the link protection on and off
Night: !linktime on
Nightbot: night -> Link timeout enabled
Mod !linktime msg on/off/message Sets a custom message for Nightbot to give a user when warned or timed out
Night: !linktime msg Please do not post links without permission
Nightbot: night -> Custom link timeout message set to: Please do not post links without permission
Mod !linktime silence on/off Toggles the timeout messages on and off for link timeouts.
Night: !linktime silence on
Nightbot: night -> Link timeouts are now silenced
Mod !linktime whitelist add/remove link/wildcard Allows you to permanently permit a link or multiple links on the same website with wildcards
Night: !linktime whitelist add http://*.google.com/*
Nightbot: night -> "http://*.google.com/*" added to the channel whitelist.
Mod !repeatstime on/off Toggles the repetition protection on and off
Night: !repeatstime on
Nightbot: night -> Repetition timeout enabled
Mod !repeatstime limit letters on/off/number from 15+ Sets the letters threshold for repetition protection (maximum number of letters) Default: 8
Night: !repeatstime limit letters 16
Nightbot: night -> Custom letters repetition timeout threshold set to: 16
Mod !repeatstime limit words on/off/number from 4+ Sets the words threshold for repetition protection (maximum number of words) Default: 8
Night: !repeatstime limit words 5
Nightbot: night -> Custom words repetition timeout threshold set to: 5
Mod !repeatstime msg on/off/message Sets a custom message for Nightbot to give a user when warned or timed out
Night: !repeatstime msg Please do not spam
Nightbot: night -> Custom repetition timeout message set to: Please do not spam
Mod !repeatstime silence on/off Toggles the timeout messages on and off for symbol timeouts.
Night: !repeatstime silence on
Nightbot: night -> Symbol timeouts are now silenced
Mod !symboltime on/off Toggles the symbol protection on and off
Night: !symboltime on
Nightbot: night -> Symbol timeout enabled
Mod !symboltime limit on/off/number from 8+ Sets the threshold for symbol protection (maximum number of symbols) Default: 8
Night: !symboltime limit 9
Nightbot: night -> Custom symbol timeout threshold set to: 9
Mod !symboltime msg on/off/message Sets a custom message for Nightbot to give a user when warned or timed out
Night: !symboltime msg Please do not spam symbols
Nightbot: night -> Custom symbol timeout message set to: Please do not spam symbols
Mod !symboltime silence on/off Toggles the timeout messages on and off for symbol timeouts.
Night: !symboltime silence on
Nightbot: night -> Symbol timeouts are now silenced

Topic Commands


Command Description Example
Mod !static message/off Appends a static message to the end of your topic
Night: !static Visit Nightbot.tv
Nightbot: night -> Topic: Static message updated to: Visit Nightbot.tv
!topic States the current topic for the channel
Night: !topic
Nightbot: night -> Topic: Welcome to the Channel! | Status: Borderlands 2 in HD /w Night | Visit Nightbot.tv
Mod !topic message States the channel's topic
Night: !topic Welcome to the Channel!
Nightbot: night -> Topic set to: Welcome to the Channel!
Mod !topic status on/off Toggles the topic status on and off
Night: !topic status on
Nightbot: night -> Topic Status Enabled

Admin/Staff Commands


Command Description Example
Admin !nightbot join channel Forces Nightbot to join a chatroom
Night: !nightbot join night
Nightbot: night -> Joining channel: night
Admin !nightbot remove Forces Nightbot to leave the current channel
Night: !nightbot remove
Nightbot: night -> Ok, I will leave this channel. Goodbye.