Bot variables & free-bot mode
Variables / placeholder codes
Usable in welcome messages, questions/answers, status, commands, and via the ARCbot panel. The bot
substitutes them at send time. (Several have aliases, shown with /.)
| Code | Expands to |
|---|---|
{id} |
User's Xat ID |
{uname} / {regname} |
User's registered name |
{name} |
User's display name |
{avatar} |
User's avatar |
{rank} |
User's rank |
{home} / {homepage} |
User's homepage |
{online} |
Total users online in the chatroom |
{cc} / {command} |
Command symbol on the bot |
{chat} / {group} |
Group/chat name the bot is in |
{randomname} |
A random display name from the chatroom |
{randomuser} |
A random registered name from the chatroom |
{randomnameid} |
A random Xat ID from the chatroom |
{randomnumber} |
A random number 0–1000 |
{latestpower} / {lpname} |
Latest power name |
{latestpowerid} / {lpid} |
Latest power ID |
{latestpowerlimit} / {lplimit} |
Latest power: displays unlimited / limited |
The FAQ's
!addqentry lists a few extra forms:{ucount},{randomiserID}. Casing varies ({randomnameID}vs{randomnameid}); the bot is generally case-insensitive on these.
For the complete command list, see /info/commands.html.
Free bot time eligibility
From Free bot/en. Categories that receive free bot time:
- Official/Tribute chats — infinite time.
- Promoted chats — 24 hours free (regardless of whether it was a 30-minute promotion).
- Official chat staff — infinite (MOD+ only, and an ARCbot must be in the chat).
- ARCbot staff — infinite.
- Volunteers — infinite.
- New chats — 5 days (if the chat had no ARCbot in 4 months OR staff stayed the same for 4 months).
How to claim it
Official/Tribute chats: set up the bot on the chat → restart the bot.
Official/Tribute chat staff, Volunteers, ARCbot staff: set up the bot → !myaccount [ARCbots username] on an ARCbot → restart. Requirement: official/tribute staff must have been moderator+ for
24+ hours. Recommended: lock your assigned xatID (via !myaccount) in the panel so it can't be
changed by others.
New chats: first verify eligibility — go to http://xat.com/ARCbot, run !ccf ChatNameHere; the
bot reports whether the chat qualifies. If eligible: make sure the bot has no bot time (don't add
any), set it up, and start it — it auto-adds the free time on connect. Once started, free bot time
cannot be stopped or paused.
Expired / free-bot mode (free server)
Applies when a user meets none of the above and hasn't paid (or never paid). The bot becomes a [Free bot] with these restrictions:
- Cannot change: Status, Homepage, Tickle Message.
- Powers disabled except: Mint, Animate, Nameglow, Namecolor, Namewave, Namegrad, Nameflag, Status, Statusglow, Statuscolor, Hat, Light, Blue, Green, Red.
- Disabled commands: any command requiring a power the bot lacks, plus
!youtube,!translate,!enablepowers,!disablepowers,!google.