Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Last revisionBoth sides next revision
bot_commands [2021/08/29 13:29] – Added additional context to admin commands section dante557bot_commands [2021/12/11 22:56] – Added some additional information for organisational purposes. List not complete. Ongoing modification. 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>  |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>  |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)  |