Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
bot_commands [2021/08/29 13:29] – Added additional context to admin commands section dante557bot_commands [2021/12/13 08:59] (current) – Adding missing user access column to first section of Admin/Mod commands. Descriptions to be changed later dante557
Line 7: Line 7:
 The following sections should hopefully show everything that can be done command wise out of the box. If any commands are missing please let us know The following sections should hopefully show everything that can be done command wise out of the box. If any commands are missing please let us know
  
 +===== All Viewers Commands =====
 +Below are a list of commands that are available for all your viewers to use. For Convinience, these have been split into seperate sections that relates the most to the purpose of the command.
 ====== General Commands ====== ====== General Commands ======
-The following commands are general commands that are available to all viewers, regardless of if they are a VIP, mod or streamer.+A list of general commands that are available to be used by all viewersThe following commands are general commands that are available to all viewers, regardless of if they are a VIP, mod or streamer.
  
-^  Commands  ^ User Access ^ Info    ^+^  Commands  ^ User Access Required ^ Info    ^
 ^ !bot                        | All Viewers        | Displays the current software version and a link to the Deepbot website. | ^ !bot                        | All Viewers        | Displays the current software version and a link to the Deepbot website. |
-^ !cmdlist                    | All Viewers        | Displays custom commands that have been added to the bot where "Hide from command list" has not been ticked. The way this is displayed to change will be different depending on settings set in "Master Settings"\\ \\ **//If "Show Full Command List On Deepbot Web Dashboard/Pastebin" is ticked//** - Link to Deepbot command dashboard (VIP Feature) or Pastebin (Non-VIP) is displayed.\\ **//If "Show Full Command List On Deepbot Web Dashboard/Pastebin" is not ticked//** - Subset of commands is posted to chat, up to the Twitch character limit for a single message. |+^ !cmdlist                    | All Viewers        | Displays custom commands that have been added to the bot where "Hide from command list" has not been ticked. The way this is displayed to change will be different depending on settings set in "Master Settings"\\ \\ **//If "Show Full Command List On Deepbot Web Dashboard/Pastebin" is ticked//** - Link to Deepbot command dashboard (VIP Feature) or Pastebin (Non-VIP) is displayed.\\ **//If "Show Full Command List On Deepbot Web Dashboard/Pastebin" is not ticked//** - Subset of commands is posted to chat, up to the 500 character limit for a single message imposed by Twitch. |
 ^ !<currency name>            | All Viewers        | Returns information in the format set in **//Master Settings > Default Points String//**.\\ If you wish to use a custom command version that contains your currency name ensure that **//Master Settings > Only Allow Points To Be Checked On Bot Chat//** is ticked\\ When this option is ticked it will instead only return the format that is set in Master Settings if the viewer calls the points command in your bot's Twitch channel | ^ !<currency name>            | All Viewers        | Returns information in the format set in **//Master Settings > Default Points String//**.\\ If you wish to use a custom command version that contains your currency name ensure that **//Master Settings > Only Allow Points To Be Checked On Bot Chat//** is ticked\\ When this option is ticked it will instead only return the format that is set in Master Settings if the viewer calls the points command in your bot's Twitch channel |
-^ !hscard [card_name        | All Viewers        | Returns information regarding the card in Hearthstone. If no card exists of the name in question the command will return nothing. |+^ !hscard <card_name        | All Viewers        | Returns information regarding the card in Hearthstone. If no card exists of the name in question the command will return nothing. \\ \\ **Card_Name** - The name of the Hearthstone card that you want further information on |
 ^ !vip                        | All Viewers        | Return VIP information (Bronze/Silver/Gold) as well as when it is due to expire. Returns nothing if the viewer in question isn't VIP Bronze, Silver or Gold. | ^ !vip                        | All Viewers        | Return VIP information (Bronze/Silver/Gold) as well as when it is due to expire. Returns nothing if the viewer in question isn't VIP Bronze, Silver or Gold. |
  
 ---- ----
-===== Admin Commands =====+====== Admin/Mod Commands =====
 +The following are the list of mod only commands that are in Deepbot by default.\\ 
 +With any of these commands you can make them accessable to users that are not marked as mods in Deepbot by creating a custom command version which calls the mod command you require.\\ 
 +For these circumstances, you will need to set the "Run As" option when editing the custom command to **User (Elevated Access)** 
  
-^  Commands  ^ User Access Info    ^+^  Commands  ^ User Access Required ^ Info    ^
 ^  !addcmd <cmd> [%level] <message>                       | Mod Level 1 | Adds a custom command to Deepbot that can be executed by all viewers (Unless the optional level value is passed across).\\ \\ **<cmd>** is the name of the command that a viewer would need to call. i.e. !testCommand\\ \\ **[%level]** is an optional value that can be passed across to restrict the command to a specific user group. For this value you will need to add the % sign in front of the numeric user group value\\ The numberic levels are; 1. All viewers; 2. All VIP; 3. All VIP + Mods; 4. VIP Silver + VIP Gold; 5. VIP Silver + VIP Gold + Mods; 6. VIP Gold; 7. VIP Gold + Mods; 8. Mod Only; 9. Bot & Streamer Only.\\ \\ **<message>** is the message that should be posted to chat. Most [[custom command variables|Custom Command Variables]] are supported. \\ \\ **Examples of Usage**\\ !addcmd !exampleCommand This is a custom command for all viewers \\ !addcmd !exampleCommand %2 This is a custom command for all VIP viewers | ^  !addcmd <cmd> [%level] <message>                       | Mod Level 1 | Adds a custom command to Deepbot that can be executed by all viewers (Unless the optional level value is passed across).\\ \\ **<cmd>** is the name of the command that a viewer would need to call. i.e. !testCommand\\ \\ **[%level]** is an optional value that can be passed across to restrict the command to a specific user group. For this value you will need to add the % sign in front of the numeric user group value\\ The numberic levels are; 1. All viewers; 2. All VIP; 3. All VIP + Mods; 4. VIP Silver + VIP Gold; 5. VIP Silver + VIP Gold + Mods; 6. VIP Gold; 7. VIP Gold + Mods; 8. Mod Only; 9. Bot & Streamer Only.\\ \\ **<message>** is the message that should be posted to chat. Most [[custom command variables|Custom Command Variables]] are supported. \\ \\ **Examples of Usage**\\ !addcmd !exampleCommand This is a custom command for all viewers \\ !addcmd !exampleCommand %2 This is a custom command for all VIP viewers |
 ^  !delcmd <cmd>                                          | Mod Level 1 | Deletes the specified channel command from Deepbot\\ \\ **<cmd>** is the name of the command that you wish to delete. i.e. !testCommand | ^  !delcmd <cmd>                                          | Mod Level 1 | Deletes the specified channel command from Deepbot\\ \\ **<cmd>** is the name of the command that you wish to delete. i.e. !testCommand |
Line 26: Line 31:
 ^  !add <points or %> <user/all>                          | Mod Level 2 | Add a specified amount of currency or a percentage of a user's current currency total to a specified user or to everyone in currently in chat. | ^  !add <points or %> <user/all>                          | Mod Level 2 | Add a specified amount of currency or a percentage of a user's current currency total to a specified user or to everyone in currently in chat. |
 ^  !add custom <online/all> <user class id> <amount or %> | Mod Level 2 | Add a specified amount of currency or a percentage of a user's current currency total to a specified user group.\\ This can be to either everyone or to all online viewers that are a part of that user group. \\ \\ User Class options: 1. All Viewers, 2. All VIP, 3. All VIP + Mods, 4. VIP Silver + VIP Gold, 5. VIP Silver + VIP Gold + Mods, 6. VIP Gold, 7. VIP Gold + Mods, 8. Mod Only  | ^  !add custom <online/all> <user class id> <amount or %> | Mod Level 2 | Add a specified amount of currency or a percentage of a user's current currency total to a specified user group.\\ This can be to either everyone or to all online viewers that are a part of that user group. \\ \\ User Class options: 1. All Viewers, 2. All VIP, 3. All VIP + Mods, 4. VIP Silver + VIP Gold, 5. VIP Silver + VIP Gold + Mods, 6. VIP Gold, 7. VIP Gold + Mods, 8. Mod Only  |
-^  !addautohost [stream]  |This command adds a stream to the Auto Hosting feature. (e.g. !addautohost ExpertsOnline) **[Mod Level 2 only]**  +^  !addautohost <stream>                                  | Mod Level 2 | This command adds a stream to the Auto Hosting feature. \\ \\ **stream** The name of the Twithc channel that you want to add to the list. 
-^  !delautohost [stream]  |This command removes a stream from the Auto Hosting feature. (e.g. !delautohost ExpertsOnline) **[Mod Level 2 only]**  +^  !delautohost <stream>                                  | Mod Level 2 | This command removes a stream from the Auto Hosting feature. \\ \\ **stream** The name of the Twitch channel that you want to remove from the list 
-^  !addvideotoblacklist [VideoID]  |This command blacklists specific YouTube videos to prevent them from being added to the list of song requests. +^  !addvideotoblacklist [VideoID]                         | Mod Level 1 | This command blacklists specific YouTube video to prevent them from being added to the list of song requests. 
-^  !addusertoblacklist [Username]  |This command blocks a specific user from requesting songs.  +^  !addusertoblacklist [Username]                         | Mod Level 1 | This command blacklists a specific Twitch user from being able to request songs/videos 
-^  !check <user>  |Check the stream currency balance for the specified user. (e.g. !check expertsonline) +^  !check <user>                                          | Mod Level 1 | Check the stream currency balance for the specified user. (e.g. !check expertsonline) 
-^  !renameuser <old name> <new name>  |Change a user's name in the database to a different Twitch username. (e.g. !renameuser expertsoffline expertsonline) **[Mod Level 2 only]** | +^  !renameuser <old name> <new name>                      | Mod Level 2 | Change a user's name in the database to a different Twitch username. (e.g. !renameuser expertsoffline expertsonline) **[Mod Level 2 only]** | 
-^  !highlight <note>  |Timestamps a certain part of your stream for stream highlights. It saves it to the highlights log in your Deepbot Folder > Log folder. (e.g. !highlight FunnyMoment) +^  !highlight <note>                                      | Mod Level 1 | Timestamps a certain part of your stream for stream highlights. It saves it to the highlights log in your Deepbot Folder > Log folder. (e.g. !highlight FunnyMoment) 
-^  !playnextsong  |Plays the next song in the playlist. +^  !playnextsong                                          | Mod Level 1 | Plays the next song in the playlist. 
-^  !playprevsong  |Plays the previous song in the playlist. +^  !playprevsong                                          | Mod Level 1 | Plays the previous song in the playlist. 
-^  !playsong  |Starts/resumes music. +^  !playsong                                              | Mod Level 1 | Starts/resumes music. 
-^  !pausesong  |Pauses the song currently playing. +^  !pausesong                                             | Mod Level 1 | Pauses the song currently playing. 
-^  !removesong [x]  |Removes a song from the playlist by its number in the queue. For example, !removesong 5 will remove the 5th song that was requested. (This only works if you are using the internal YouTube player.) +^  !removesong [x]                                        | Mod Level 1 | Removes a song from the playlist by its number in the queue. For example, !removesong 5 will remove the 5th song that was requested. (This only works if you are using the internal YouTube player.) 
-^  !permit  |Permits users to post links when link protection is enabled. +^  !permit                                                | Mod Level 1 | Permits users to post links when link protection is enabled. 
-^  /r or /w  |Respond to whispers in the Chat tab. (e.g. /r will respond to the last whisper, while /w <username> will whisper a specific user.) (VIP Exclusive) (In order for this to work, this must be enabled in the Master Settings by clicking the check box next to Enable Whisper messaging (Streamer)) +^  /r or /w                                               | Streamer (Within Bot) | Respond to whispers in the Chat tab. (e.g. /r will respond to the last whisper, while /w <username> will whisper a specific user.) (VIP Exclusive) (In order for this to work, this must be enabled in the Master Settings by clicking the check box next to Enable Whisper messaging (Streamer)) 
-^  !remove <points> <user>  |Removes a specified number of points from a user. (e.g. !remove 100 expertsonline) **[Mod Level 2 only]** +^  !remove <points> <user>                                | Mod Level 2 | Removes a specified number of points from a user. (e.g. !remove 100 expertsonline) **[Mod Level 2 only]** 
-^  !resetcounter <cmd>  |Resets the counter of a command. +^  !resetcounter <cmd>                                    | Mod Level 1 | Resets the counter of a command. 
-^  !startarena <mode> <amount>  |Mode 1 is Knockout Arena, where <amount> is the max wager, and Mode 2 is Tournament Arena, where <amount> is the entry cost into the tournament. (e.g. !startarena 1 100) **[Mod Level 2 Only]** +^  !startarena <mode> <amount>                            | Mod Level 2 | Mode 1 is Knockout Arena, where <amount> is the max wager, and Mode 2 is Tournament Arena, where <amount> is the entry cost into the tournament. (e.g. !startarena 1 100) **[Mod Level 2 Only]** 
-^  !startautohost  |Starts auto-hosting. **[Mod Level 2 only]** +^  !startautohost                                         | Mod Level 2 | Starts auto-hosting. **[Mod Level 2 only]** 
-^  !startguessinggame [preset name]  |A command for mods to start the guessing game. (e.g. !startguessinggame [preset name]) +^  !startguessinggame [preset name]                       | Mod Level 1 | A command for mods to start the guessing game. (e.g. !startguessinggame [preset name]) 
-^  !stopautohost  |Stops auto-hosting. **[Mod Level 2 only]** +^  !stopautohost                                          | Mod Level 2 | Stops auto-hosting. **[Mod Level 2 only]** 
-^  !top [x]  |Displays [x] users with the highest amount of stream currency. [x] must be a number between 1 - 14.  | +^  !top [x]                                               | Mod Level 1 | Displays [x] users with the highest amount of stream currency. [x] must be a number between 1 - 14.  | 
-^  !tophours [x]  |Displays [x] users with the most number of hours watched. [x] must be a number between 1 - 14.  | +^  !tophours [x]                                          | Mod Level 1 | Displays [x] users with the most number of hours watched. [x] must be a number between 1 - 14.  | 
-^  !topranks [x]  |Displays [x] users with the highest stream ranks. [x] must be a number between 1 - 10.  | +^  !topranks [x]                                          | Mod Level 1 | Displays [x] users with the highest stream ranks. [x] must be a number between 1 - 10.  | 
-^  !updategame <game>  |Updates the current stream game/activity. **[Mod Level 2 only]** +^  !updategame <game>                                     | Mod Level 2 | Updates the current stream game/activity. **[Mod Level 2 only]** 
-^  !updatetitle <title>  |Updates the current stream title. **[Mod Level 2 only]** +^  !updatetitle <title>                                   | Mod Level 2 | Updates the current stream title. **[Mod Level 2 only]** 
-^  !volume  |Checks the current volume of the internal YouTube player. +^  !volume                                                | Mod Level 1 | Checks the current volume of the internal YouTube player. 
-^  !volume [x]  |Sets the volume of the internal YouTube player. [x] must be a value between 1 and 100.  |+^  !volume [x]                                            | Mod Level 1 | Sets the volume of the internal YouTube player. [x] must be a value between 1 and 100.  |
 ====== Minigame/Stream Interaction Commands ====== ====== Minigame/Stream Interaction Commands ======
 The following contains information regarding the commands that can be used with the minigames and stream interaction tools that are built into the bot. The following contains information regarding the commands that can be used with the minigames and stream interaction tools that are built into the bot.