# Examples

### Built in Commands

TidyLabs has some built in commands for your users to use.

| Usage                       | Permission            | Example Output                                                                                        |
| --------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------- |
| !help                       | Owner                 | Please check the TidyLabs documentation over at <https://docs.tidylabs.stream/> for full instructions |
| !ping                       | Owner                 | !pong                                                                                                 |
| !uptime                     | Everybody             | The stream has been live for...                                                                       |
| !8ball Will it snow?        | Everybody             | Yes!                                                                                                  |
| !giveaway A Lovely Thing    | Owner / Moderator     | \<user> has started a giveaway for A Lovely Thing type !enter to enter                                |
| !subgiveaway A Lovely thing | Owner / Moderator     | \<user> has started a subscriber only giveaway for A Lovely Thing type !enter to enter                |
| !enter                      | Everybody             | \<user> has entered the Giveaway!                                                                     |
| !winner                     | Owner / Moderator     | \<user> has won A Lovely Thing                                                                        |
| !sr \<YouTubeLink>          | Everybody / Subs Only | The song 'XXXX' requested by @tidy has been added to the queue!                                       |
| !removesong SONGID\<ID>     | Owner / Moderator     | Song XXXX has been removed from the playlist.                                                         |
| !title \<title>             | Owner                 | New Title 'XXXXXXXX' has been set :)                                                                  |
| !game \<category>           | Owner                 | Category has been changed to: 'XXXXXXXX'                                                              |
| !host \<user>               | Owner                 | We are now hosting @XXXXXX[ ](https://dlive.tv/frozenbox)at: <https://dlive.tv/XXXXXXX>               |
| !dice \<number>             | Everybody             | @user 🎲X🎲                                                                                           |

### Custom Commands

For custom commands you can use the following tags to automatically replace responses:

\##sender## = the person who requested the command\
\##target## = the person you have tagged in your chat command

| Command | Response                                                               | Usage           | Output                                                           |
| ------- | ---------------------------------------------------------------------- | --------------- | ---------------------------------------------------------------- |
| !so     | Go check out <https://dlive.tv/##target##> - He loves Pineapple Pizza! | !so @tidy       | Go check out <https://dlive.tv/tidy> - He loves Pineapple Pizza! |
| !tickle | ##sender## pick's up a feather duster and tickles ##target## !         | !tickle @cheaky | Tidy pick's up a feather duster and tickles Cheaky !             |

{% hint style="warning" %}
Commands currently have a fixed cooldown of 60 seconds.  Customisation of this option will be added in a future release.
{% endhint %}
