You can either add a command by using the Panel UI, or via chat. Note: only the channel owner can add via chat at this time.
To add a custom command via chat, theres a command you can run!
!cmd <add | remove> ... !cmd add <name> <...message> !cmd remove <name>
Tip: You can run !cmd --help
to see brief usage details like the above, this works
with any built in command, and subcommands of commands too!
!cmd add twitter Follow me on twitter @OatyBot https://twitter.com/OatyBot
!cmd add shoutout Shout out to @{input}, go follow them at https://glimesh.tv/{input}
!cmd remove shoutout
We have built an advanced templating engine for custom commands on Oaty. This allows you to make your commands more interactive and aware of the world around them.
Substitutions start with {
and end with
}
and can be inserted anywhere in your message body, as many times as you like.
They follow the format:
{ <variable> : <key> = <value>, ... }
Name | Description |
---|---|
<variable> |
The name of the variable to substitute in, find a list of them below this section |
<key> |
Key of the metadata that you want to use |
<value> |
Value of the metadata you want to use |
Substitutions can be just the variable part, or can contain a list of metadata after the :
. This metadata can be used by certain variables to tweak their behaviour. For example the
date
variable supports a format
for changing how it displays the date, more on this below.
We'll be adding many more variables to use in the coming weeks but right now here's the complete list.
Name | Metadata | Description |
---|---|---|
input | - | Any and all text entered after the command name |
sender | - | The username of the person who ran the command |
at_user | index=<int> | The username of the person who was tagged (e.g. @Oaty). index allows picking
nth tagged user
|
time | format=<text> | The current time. format allows you to change how it formats the time
output. See
this guide
for the specifiers you can use.
|
date | format=<text> | The current date. format allows you to change how it formats the date
output. See
this guide
for the specifiers you can use.
|
datetime | format=<text> | The current date and time. format
allows you to change how it formats the date time output. See
this guide
for the specifiers you can use.
|
!cmd add now The current time is { time : format = "%H:%M:%S" }
!cmd add shoutout Shout out to @{ at_user }, go follow them at https://glimesh.tv/{ at_user }