# Variables

###

### List of variables

| Variable                 | Description                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| %user%                   | User of the command                                                                                               |
| %target%                 | Everything behind the command                                                                                     |
| %channel%                | Current channel                                                                                                   |
| %subcount%               | Subcount of the channel (requires permission during login)                                                        |
| %followcount%            | Followcount of the channel                                                                                        |
| %viewercount%            | Current viewercount                                                                                               |
| %downtime%               | Downtime of the stream                                                                                            |
| %uptime%                 | Uptime of the stream                                                                                              |
| %randomuser%             | Random chatter                                                                                                    |
| %staticrandomuser%       | Random chatter, but always the same                                                                               |
| %randomnumber%           | Get a random number \| Usage: %randomnumber%10 > Number from 1-10                                                 |
| %staticrandomnumber%     | Get a random number, but always the same                                                                          |
| %title%                  | Current title                                                                                                     |
| %game%                   | Current game                                                                                                      |
| %customapi%              | Get data from a custom API \| Usage: %customapi%<https://decapi.me/twitch/id/katimoms> \| ONLY PLAIN TEXT RESULTS |
| %later%                  | Sends the reponse later \| Usage: This response appears %later%4 Seconds later!                                   |
| %randomffz%              | Random FrankerFaceZ Channel Emote                                                                                 |
| %staticrandomffz%        | Random FrankerFaceZ Channel Emote, but always the same                                                            |
| %ffzemotes%              | Lists all FFZ Emotes                                                                                              |
| %randombttv%             | Random BetterTwitchTV Channel Emote                                                                               |
| %staticrandombttv%       | Random BetterTwitchTV Channel Emote, but always the same                                                          |
| %bttvemotes%             | Lists all BTTV Emotes                                                                                             |
| %triggercount%           | Amout of times a command was triggered \| Usage: any command, this command was triggered %triggercount% times     |
| %counter%                | Use [counters](/commands/system-commands/counters.md)                                                             |
| %chatlines%              | Number of Chatlines sent by user, defined through %target%                                                        |
| %totallines%             | Number of Chatlines sent by all users                                                                             |
| %split%                  | Splits the command into several messages                                                                          |
| %randomactiveuser%       | Random user who was active in the past 15 minutes                                                                 |
| %staticrandomactiveuser% | Random user who was active in the past 15 minutes, but always the same                                            |
| %google%                 | Just google it 4Head \| U will be blacklisted, dont abuse it :)                                                   |
| %youtube%                | YT video search                                                                                                   |
| %condition%              | More complex -> [Condition](/commands/variables/condition.md)                                                     |
| %followdate%             | Date of following                                                                                                 |
| %followduration%         | Time of following \| Usage: %followduration%de or %followduration%en for translation                              |
| %twitter%                | Last Tweet \| Usage: %twitter%NAME                                                                                |
| %crypto%                 | Current value of coins to currency \| Usage: %crypto%FLOWEUR                                                      |
| %song%                   | Current Spotify song \| Spotify connection required!                                                              |

### Examples

| Command        | Response                                                             | Final response                                              |
| -------------- | -------------------------------------------------------------------- | ----------------------------------------------------------- |
| !subs          | Currently %subcount% people have subscribed                          | Currently 123 people have subscribed                        |
| !shoot TitusDE | %user% shoots %target% in the leg                                    | KATimoms shoots TitusDE in the leg                          |
| !randombttv    | %staticrandombttv% %staticrandombttv%                                | PeepoOnChicken PeepoOnChicken                               |
| !lines zonekks | %target% sent %chatlines% Messages in here, go and get a life Pepega | zonekks sent 187 Messages in here, go and get a life Pepega |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docu.mrbonkbot.com/commands/variables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
