Commands

From xat wiki

xat has support for special "/" (slash) commands, which allow for advanced actions that are not available in the graphical user interface. Some commands are available for everyone on the chat, while other commands require a specific rank or power.

Default "/" commands

These commands can be used by everyone in any chat, though sometimes you need a certain rank.

/o - Smiley effects

You can make the chat box automatically add smiley effects to all the smilies you send. To do this, type /o followed by the code of the effect without the # sign.

For example, if you want all of your smilies to be mirrored and you have the Mirror power, type /om into the chat box and send it like a message. You can also combine effects. For example, /omis will make all the smilies mirrored, inverted and made square, as long as you have all the required powers. You can also combine color effects. For example, /oFFFFFF will make all of your smilies white.

If you want to remove the smiley effect you made, simply type /o into the chat.

/f - Add as friend by ID

To add any user to your friends list when you only have their ID, type /f followed by their ID. Optionally, you can add a name that you want to appear on your friends list.

For example, /f999999999 Abcd will add the user with the ID 999999999 to your friends list with the name "Abcd".

/t - Ignore a user

Type /t in a private chat to ignore a user. If you have the TTTH power, you can also send a full-screen smiley and message along with ignoring.

You can also use the same command in PC to un-ignore a user.

/- or /+ - Disable or enable powers

Type /+powername to enable a power or /-powername to disable a power.

For example, if you type /-nopc on the chat, it will disable the NoPC power.

/go - Moving from a chat to another

On any chat you can use the /go command to move on another chat. All you need to have is the name of the group or its identification number.

For example, if you type /go xat5, you will be redirected to xat_test. Typing /go xat_test will do the same.

/s - Scroll message

Example 1. Setting a scroll message.

If you are an owner or a main owner, you can set a scroll message to show at the bottom of the typing box by typing it in the chat. (See Example 1.)

You can, for example, type:

  • /sWelcome to my chat. Please behave well or you will be banned.

You can change the color by adding a color code. For example, add #FF0000 to the end of the message for red:

  • /sWelcome to my chat. Please behave well or you will be banned.#FF0000

You can also use tags in the scroll.

  • Available tags include: {id} {regname} {nickname} {userscount} {latestpower} {rank} {chatversion}.

For example, add {regname} for a personalized greeting:

  • /sWelcome {regname}!

/p - Protect your group from raids

If your chat is being raided, an owner can enter protect mode by typing /p in the main chat. For 1 hour, new unregistered users will have to solve a CAPTCHA to join the chat. You can turn off protect mode by typing /p again.

Note: There is a 15-second delay after you toggle protect mode on or off and when you may toggle it on or off again.

If /p does not work, you can use these alternative modes to increase the protection:

  • /pg or /p2 CAPTCHA unregistered users and gag new guests for 3 minutes
  • /pc or /p3 CAPTCHA all guests
  • /pR or /p4 Make the chat registered users only. CAPTCHA all guests
  • /pr or /p5 Make the chat registered users only without a CAPTCHA
  • /pm or /p6 Make the chat members only

The main owner of the chat can use GControl power to change the default duration of hours and the default rank of who can turn on protect mode.

Note:

  • Members and above do not need to complete a CAPTCHA when protect mode is on.
  • Do not use /pr while your chat group is promoted unless absolutely necessary. Use /p instead (the chat must be open to all). You could lose promotion for using /pr.

/i - Information

If you are an owner, you can find out who last changed the scroll or who entered protect mode by typing /i in the main chat. You will then receive an automated message along the lines of /s 1345634 /p 2365342, which shows you the IDs of the last users to use the /s and /p commands.

/m - Make a user a moderator

Owners and main owners can type /m in a user's private chat to make them a moderator.

Power "/" commands

Some powers allow you to use more "/" commands. See their articles for more detail.

/away - Away from chat

Add a timer to your pawn to show other users you are away from the chat. See more: Away.

/f - Change your friend's name

Change a friend's display name. See more: Nick.

/g - Make yourself a guest

See more: Guestself.

/h - Temporarily stop users from chatting

Gag all users of a certain rank at once, for a maximum of 60 seconds. This command has a number of customization options.

The default rank to use this command is owner or above. See more: Hush.

/hug - Send a hug

Some powers may come with the ability to send hug animations. Although sending a hug in a private chat is free and has unlimited usage, sending a hug in the main chat costs 10 xats per hug, and a total of 20 hugs can be sent in 24 hours. For more information, see Hugs.

Note:

  • All hugs may include an optional message after the hug name.
  • These messages can be colored, for example: /hug ny Happy New Year!#ff0000 would use red text.
  • /hug can be interchanged with /hugall, and /jinx with /jinxall for the same animations. But always be aware of costs!

/jinx - Send a jinx

This command is used to send jinxes, which change the target's chatting experience. For example, Jumblejinx will jumble the target's messages.

Jinx commands can only be sent in a private chat, and not the main chat. While /jinx is free (jinxing the user in a private chat only), /jinxall (jinxing the user in the main chat) costs 10 xats per use. For more information, see Jinxes.

Note:

  • /jinx may be replaced with /jinxall, but, again, be aware of rising costs!
  • You cannot jinx a higher rank.

/ka - Kick all guests

Kick all guests in the chat, with a number of customization options.

The default rank to use this command is moderator or above. See more: Kickall.

/m - Make a temporary moderator

Promote guests and members to moderator for any duration of time, up to 24 hours.

The default rank to use this command is owner or above. See more: Tempmod.

/mb - Make a temporary member

Promote guests to member for any duration of time, up to 24 hours.

The default rank to use this command is moderator or above. See more: Tempmem.

/mo - Make a temporary owner

Promote guests, members and moderators to owner for any duration of time, up to 24 hours.

The default rank to use this command is main owner. See more: Tempown.

/n - Sinbin a moderator

Type this command in a permanent moderator's private chat to strip their moderator abilities, from 36 seconds to 24 hours. This command will not work on temporary moderators.

The default rank to use this command is owner or above. See more: Sinbin.

/nb - Give a user a badge

Type this command in a user's private chat to give them a badge. The same command can be used to remove it.

The default rank to use this command is owner or above. See more: Badge.

/r - Lock a user to a certain rank

Lock a user's rank, and prevent it from being changed by others until the lock is removed.

The default rank to use this command is owner or above. See more: Ranklock.

/t - Talk to the hand

Type this command in a user's private chat to ignore them, with the option of a giant smiley appearing in their chat if they PC you. To add a smiley and message, type /tMessage#smiley.

You can also test this by typing /t in the main chat to perfect your message and code. See more: TTTH.

Debug "/" commands

On debug chats (chats that have a blue 8ball instead of the classic black one), there are some special commands you can use. You can also use the following commands on your own chat if you add "?test" to the end of your group's URL.

These commands seem (and are) generally useless. However, they were once used by admins to create and test features.

Note that any messages sent are seen by you only.

/debug - See debug information

The default /debug command will display some technical details about the chat; the memory usage; how many frames per second (FPS); the average frames per second (aFPS).

/debug clearlists - Clear some cached chat data

When you use this command, some of the cached chat data will be cleared. The main chat and user list will be cleared, you will be added back to the top of the list with no cached rank and relationship. The data will begin to cache from that point on, adding users back to the user list when they sign in and begin to chat again.

/debug avs - Control avatar effects

This command is used to control avatar effects, much like the "$glitter" macro. However, unlike the macro this effect is not persistent.

Use /debug avs or /debug avs 0 to disable avatar effects, and /debug avs 1 to enable them again.

/debug cacheback - See SWFs loaded into cache

This command puts a "back" on any swfs (pawns, smilies, etc.) that are loaded into cache. Use /debug cacheback 1 to turn it on.

/debug zappri/primary/shadow - Change the chat's connection details

These three commands all change the IP addresses that the chat connects on, but seem to have no effect.

/debug gctrick - Send a "gctrick" Help message

Using /debug gctrick 1 or any integer will cause the chat to send a Help message back with the same command that you sent.

/debug smilietest - Test different types of smilies

Test different types of smilies using /debug smilietest 1 where "1" can be one of the following numbers:

  • 1 - Test random smilies
  • 2 - Test random smiley combinations
  • 3 - Test free smilies.

/debug fakemessage - Send a number of dummy messages

Use /debug fakemessage 1 where "1" can be any number up to 200, and that number of lorem ipsum extracts will be posted on to the chat.

/debug avtest - Test two random avatars

Use /debug avtest 1 and you will start sending messages with two random avatars.

/debug graph - See graphs based on debug information

For this command to work, you must first type /debug. In itself, the graph command has 4 options:

  • 0 - Off.
  • 1 - A horizontal line graph representing your memory usage.
  • 2 - A vertical line graph representing your memory usage.
  • 3 - Both of the above.
  • 4 - A vertical line graph representing your frames per second (FPS).

/debug msgcount - Count your messages

Type /debug msgcount 1 for the chat to automatically start counting your messages from 1. Use /debug msgcount off to stop counting.

You can also use any other number instead of 1 to select an alternative starting point.

/debug fps - Change the frames per second (FPS) of the chat

The higher the FPS, the faster the animations in the chat. Use /debug fps 24 to make the chat twice as fast.

Use /debug fps 0 or /debug fps 12 to go back to normal.

/debug cache - Load an array of smilies into your cache

Type /debug cache and a bunch of smilies (12x12 by default) will overlay the chat. You can use /debug cache 1 2, where 1 is the speed, and 2 is the number of rows. Repeating the command does not clear the previous smilies.

You must refresh to make it disappear.

/debug nocache - Load smilies on to the chat

You use this command by typing /debug nocache 12 pty where 12 is the number of rows, and pty is the smiley. Repeating the command does not clear the previous smilies.

You must refresh to make it disappear.

/debug dp - Testing assigning group powers

Use /debug dp power 1 where power is the power name. If you own the power, it will return a "Power unassigned ok" message. Otherwise, it will return "Power system error (db down)" message.

This does not actually assign the power.

/debug bump - Test the bump noise

This command simply plays the bump sound and animation.

/debug stest - Smiley testing mechanism

The chat has a built in smiley testing mechanism that is turned on using this command. You must run the chat swf locally, put smiley swfs in "C:\smilies\test\" and set the names in the macro $stest like so: "$stest=placeholder,smiley1,smiley2,smiley3", then use the /debug stest command and sign out and in.

You should now be able to use your custom smilies.