Premium commands

Set name usage:
Set name Rage bot (Premium owner command)

With set name you can change the name of your bot.
This needs to be done the first time you set up your Premium Rage, but you can always change it again at a later point.
The name will have to include a first name and a last name.

The command should be typed in PM with your Premium bot.
This command only works for the bot owner.


The set name should be typed in one sentence like in the screenshot above.


You can choose to have multiple names/words in the last name of your bot - but keep in mind that only the first name will be displayed in groups.

It can take a little time for the name to update. You can speed up the process by restarting your Kik.
In groups it takes longer due to Kik's group caching - this is unfortunately not something we can control.

---

Set picture usage:
Set picture (Premium owner command)

With set picture you can set up / change the profile picture of your bot.
This needs to be done the first time you set up your Premium Rage, but you can always change it again at a later point.
The picture should preferably be a perfect square, or the outcome may end up looking messy - if the picture is not a perfect square, we recommend cropping it first.
Important: don't use pictures that are NSFW/adult themed or any pictures that breaks the Community Standard of Kik - or your bot might get banned.

The command should be typed in PM with your Premium bot.
This command only works for the bot owner.


The set picture should be typed like in the screenshot above.

It can take a little time for the profile picture to update. You can speed up the process by restarting your Kik.
In groups it takes longer due to Kik's group caching - this is unfortunately not something we can control.

---

Set background usage:
Set background (Premium owner command)

With set background you can set up / change the background photo of your bot.
This needs to be done the first time you set up your Premium Rage, but you can always change it again at a later point.
Important: don't use pictures that are NSFW/adult themed or any pictures that breaks the Community Standard of Kik - or your bot might get banned.

The command should be typed in PM with your Premium bot.
This command only works for the bot owner.


The set background should be typed like in the screenshot above.


The end result after setting everything up.

It can take a little time for the background photo to update. You can speed up the process by restarting your Kik.
In groups it takes longer due to Kik's group caching - this is unfortunately not something we can control.

Groups usage:
Groups (Premium owner command)
Leave 1 (Premium owner command)

With groups you can view what groups your Premium is in, and from there you can make it leave the groups you no longer want it to occupy.
You can also view how close you are to reaching your group limit.
Every Premium Rage has a limit of how many groups it can occupy - the limit depends on your payment plan.
You can read more about payment plans here.

The commands should be typed in PM with your Premium bot.
This command only works for the bot owner.


When typing "groups" to your bot in PM, it will respond with a numbered list of the groups it occupies.
For private groups, the names of the groups will be displayed, whereas for public groups it will display the hashtags instead.
In the example above, you can see that the bot is at its group limit - 20/20 groups.


This is what will happen if you try to invite it to more groups after it has reached its limit.
The bot will prompty leave the group after being added to it.
If you want it to leave one of the groups it is already in, follow the instructions below.


When having used the "groups" command, it will display a number to the left of the group name/hashtag.
You will need to use that number to make it leave said group.
In the example above, we wanted it to leave the group named "random group 20".
It was the 20th group in our list - so we typed "leave 20".
Rage will respond with a confirmation of which group it left.

We recommend using this feature to make your Premium leave groups, instead of manually removing it or using the "Rage leave" command.
If you use manual removal or the "Rage leave" command, it could take up to a week for the list to update properly.
Also, keep in mind that if you change the name of a private group your Premium Rage is in, it will take a while for the name to update in the "groups" list.

Transfer usage:
Transfer (Premium owner command)
Transfer all from 1 to 2 (Premium owner command)
Transfer substitutions from 1 to 2 (Premium owner command)
Transfer censor from 1 to 2 (Premium owner command)
Transfer settings from 1 to 2 (Premium owner command)

With transfer Premium owners can effectively transfer the group data from one group to another.
This is quite useful if you need to move groups or wish to use the same substitutions/settings in all of your groups but don't want the hassle of manually having to copy-pasting everything.
Most settings will be overwritten but some lists (substitutions, blacklist and censored list) will simply merge with the already-existing ones.
Please note that you need to have your Premium bot in both groups that you want to transfer from and to.
Be careful when using the transfer command - if you overwrite the data of the wrong group, you can use the "import all" command for a limited amount of time to import old backup data - but there is a chance this may not recover all of your previous data and settings.

There's different commands, depending on what you want to transfer.
The commands work by typing "Transfer all/Substitutions/Censor/Blacklist/Settings from (x) to (x)" - replacing (x) with the group number according to the "transfer" group list, however there are more detailed instructions below.

---

If you're looking to move your group and want to transfer all data and settings, you should use the "transfer all" command.
All settings and data in the group you are transferring to will be overwritten, with the exception of substitutions and censor lists - those two lists will merge instead.
If you want to wipe the already-existing lists in the group you are transferring to, then use the "delete all", "delete all admin" and "uncensor all" commands first.

Tap here for instructions.

For transferring the substitutions list, you should use the "transfer substitutions" command - it will merge with the already-existing substitutions.
If you want to wipe all substitutions in the group you are transferring to, then use the "delete all" and "delete all admin" commands first.

Tap here for instructions.

For transferring the censor list, you should use the "transfer censor" command.- it will merge with the already-existing censor list.
If you want to wipe all censored words in the group you are transferring to, then use the "uncensor all" command first.

Tap here for instructions.

For transferring the group settings and data (settings for 48 mode, permissions, noobs, joining, crash codes and spam), you should use the "transfer settings" command.
All settings and data in the group you are transferring to will be overwritten

Tap here for detailed instructions.

Blacklist usage:
Blacklist shows the command description
Blacklist list shows list of blacklisted users
Blacklist username self explanatory
Unblacklist username self explanatory
Blacklist last blacklists the last removed/left/banned/unbanned user
Unblacklist last unblacklists the last blacklisted/removed/banned/unbanned user
Unblacklist xx unblacklists a user by their identifier
Unblacklist all unnblacklists everyone

With blacklist, you can prevent unwanted people from joining your group, similar to banning.
If a blacklisted user attempts to join through group # (search), invite links or by being added by another user, Rage will remove them immediately after posting a default removal message - though keep in mind that Rage will not remove people who are already in the group.
With the ordinary ban feature of Kik you are only able to ban up to 100 users. Also you cannot ban someone until after they've already joined your group, and you cannot transfer the ban list to other groups.
This is why the blacklist feature is a useful substitute for ordinary banning.
Just like with other commands, you can transfer it across your groups and there's no limit for how many users you can blacklist.

Because this feature is more complicated than most of our commands, we will be very elaborate with our demonstrations below.

---

Blacklisting by username:

In order to blacklist someone by their username, we type "Blacklist" followed by their username.
In this case, we're typing "Blacklist generictroublemaker", as that is the username of the person in this example.
Next time they try to join the group, they will be met with the default removal message and get removed by Ragebot.

Type "Blacklist list" to see a list of blacklisted users.
They'll be sorted into "Usernames" and "Screen names" category.
If you're looking to unblacklist someone, simply type "Unblacklist" followed by their username.

---

Blacklisting without username:

There'll be situations where you will be unable to blacklist by username - if someone joined, left a nasty message and left, or if they've got their DM's turned off.
For these situations, we will be using the "Blacklist last" command.

So here we have a classic troll joining to cause trouble, they got their DM's off, making it difficult to identify them and prevent them from joining your other groups.
Below we will demonstrate how to deal with this.

First you remove him/her (as blacklist does not remove existing members), and then you type "Blacklist last".
"Blacklist last" basically blacklists the last person who left the group/was removed, banned or unbanned - even if they change their screen name.

Note: Ragebot doesn't store this data for very long, so if it's been a while since they were in your group, you may need to ban/unban them before using the "Blacklist last" command.

Using "Blacklist last" will place them under the "Screen Names" section, as you can see above - because we do not have their username.
You will see an identifier (usually two characters) in front of their screen name - "gt" in this instance - the purpose of this identifier is to be able to unblacklist them later, as people might use special characters in their name.
Note: This identifier is not related to the user's jid.

If you're looking to unblacklist them, simply type "Unblacklist" followed by the identifier (usually two characters) in front of their name - in this example, you'd type "Unblacklist gt".
This removes them from your blacklist, and Ragebot will no longer remove them when they try to join the group.

Alternatively, if they recently tried to join your group, you can use the "Unblacklist last" command - this unblacklists the last person who was blacklisted, removed, banned or unbanned.
If you're looking to completely clear your blacklist, you can type "Unblacklist all".

Note: If you blacklisted someone with the "Blacklist last" command, you cannot unblacklist them by their username (and vice versa).

Whitelist usage:
Whitelist
Whitelist user
Unwhitelist user
Unwhitelist all

With whitelist, you can make any user of your group chat exempt from any type of removal by Rage - whether that be through 48 mode, or any of the Premium features (disallow spam, disallow crash codes, censored words and so on).
It means you no longer have to admin people out of concern that they'll be kicked by Rage.

Type "whitelist" to see the list.
To the left there'll an empty box - if you whitelist a user, the box will be ticked.
There will be a crown next to the admins in the list.
There is also a user tag which is a unique couple of characters (they're the first couple of characters of the users jid).
After that, their name is displayed.

You can use either the user tag, or their first name to whitelist them (first and last name, along with username does not work - it has to be first name alone, or the user tag).
Example and how to whitelist a user is listed below:


We want to whitelist pg: Test Dummy
We use the "whitelist" command to view the whitelist, and then proceed to whitelist "pg" (which is the user tag) - Rage gives a confirmation that we have whitelisted Test Dummy.
You could also have whitelisted this user by typing "whitelist Test".
The reason we have included the user tags in the whitelist is because there could be cases where people use the same first name in one group, or that people use special characters in their name (as you can see an example of in the screenshot above).
Without a user tag, it'd be impossible to whitelist people in these cases.


Here you see there is now a ticked box next to pg: Test Dummy. That means that Test Dummy is whitelisted.


To remove Test Dummy from whitelist, simply type "unwhitelist pg", or "unwhitelist Test".
If you want to clear the entire whitelist, you can simply type "unwhitelist all".
You can also whitelist them by simply using their first name (Test) as demonstrated above.

Note: If Rage says that the name or tag is not found, simply use the tag provided by "whitelist" instead of their first name when whitelisting.
Extra note: You don't have to whitelist admins as they cannot be removed by Rage anyways.

Censor usage:
Censor
Censor word
Uncensor word
Uncensor all

With censor, you can add any word(s) or sentences to the list of censored words - if a user says the word or phrase that is censored, they will be removed by Rage.
If a user says the word as a part of a sentence, they will also be removed.
If a user says the word inside of another word (eg., you censor the word "fuck", and someone says "fuckersberg"), they will not be removed.
Examples given below:


Here you see how to view the censor list and how to add a word to it.
In this example, we've added "fuck" to censor.


When someone says "fuck" in a stand-alone sentence, Rage will remove them.


When someone says "fuck" as a part of a sentence, Rage will also remove them.


When someone says "fuck" as a part of a longer word (in this example, fuckersberg), Rage will not remove them.

We've implemented it this way to narrow down the amount of unintentional removals - though this also means that if you want to completely censor a swear word such as "fuck", you will have to censor all of the derived forms of the word as well, such as "fucking" "fucker", and so on.
Furthermore, censor does not support multiple inputs - every word/sentence you want censored has to be put in one at a time.
You can also censor entire sentences by typing censor in front, such as "censor I love pineapples on pizza".


If you want to uncensor the word "fuck", type "uncensor fuck" as in the screenshot above.
If you want to completely wipe the censored list, type "uncensor all".

Warning: please think through how a word can be used in various ways and sentences before you decide to add it to the list - you could unintentionally remove users whom you don't intend to remove.
For example, if you censor the word "PM" in a group where private messages are not allowed, you may unintentionally remove a user who's complaining that someone from the group chat has sent a PM to him/her.

Set goodbye usage:
Set goodbye byebye
Delete goodbye

With set goodbye you can set a goodbye message that Rage will post in the group chat when someone leaves.
It works in a similar way as "set rules", but just functions as a goodbye message instead.
It cannot be seen by the person who left, but it can be entertaining to the rest of the group chat.


Here we set the goodbye message up with "set goodbye Another one bites the dust" - so when someone leaves, Rage says "Another one bites the dust".

Note: the goodbye message does not display if people are removed from the group chat - only if they leave by themselves. It would become too spammy otherwise.

Disallow noobs usage:
Disallow noobs
Disallow noobs 10
Allow noobs (Default)

With disallow noobs, you can prevent accounts that are x amount of days old or less from joining the group.
This is especially useful for keeping out bots that Rage normally doesn't detect and keeping out fake or alt accounts.
You can either use the "disallow noobs" command without any number at the end (then it'll automatically remove accounts that are 5 days old or less), or you can insert a number at the end. Example below:


Here we set it to "disallow noobs 175" - the account that attempted to join is "only" 172 days old and was therefore removed.
You can adjust the number to any amount of days.

Disallow joining usage:
Disallow joining
Disallow joining Message
Allow joining (Default)

With disallow joining, you can effectively lock down a group chat so that new users cannot join.
If new users attempt to join through group # (search) or invite links, Rage will remove them immediately after posting a default removal message - though Rage will not remove people who are added to the group by existing group members.
This can be useful for many things, for example - if you are doing some type of maintenance work on your group (changing rules/substitutions/etc.) and don't want new users to join in the middle of it - or if you're just looking to close down your group for the time being.


This is the default removal message when using "disallow joining".


Here is how you set up a custom removal message for disallow joining.
This can be especially useful if you're running a group with verification rules - you can "disallow joining" while the admins are asleep and then do "allow joining" again in the morning.
Or you could even set it up permanently with a redirect to a verfication group that new users should join first.
The custom removal message will be saved, even after doing "allow joining" again - so you won't have to set it again the next time you lock the group.

Disallow spam usage:
Disallow spam
Allow spam (Default)

With disallow spam, Rage will remove users who mass-spam from the group chat.
Though most groups will fortunately never be affected by this, some groups face a lot of issues due to trolls mass-spamming the chat.
It can be very disruptive and annoying for a group chat, so we implemented this as one of our security features.
By default, the setting will be on "allow spam" which means Rage will not offer any protection if the group is getting spammed.
But the setting is toggable and you can enable it by typing "disallow spam" in your group chat.

The feature is based on a point system - only an excessive amount of text posts within a short amount of time will be counted as spam. Gifs, stickers, images, videos and other medias will not count as spam.


Disallowing spam and seeing it in function. Here a lot of A's were posted within just ten seconds, which triggered the spam detection and removed the user posting it.

Note: if you are admin, Rage will not react to spam posted by you.

Disallow crash codes usage:
Disallow crash codes (Recommended)
Allow crash codes (Default - not recommended)

With disallow crash codes, Rage will remove users who post crash or lag codes from the group chat.
Though most groups will fortunately never be affected by this, some groups face a lot of issues due to trolls using crash codes to harass the chat.
Crash and lag codes can be incredibly disruptive for a group chat, so we implemented this as one of our security features.
By default, the setting will be on "allow crash codes" which means Rage will not offer any protection if crash codes are posted.
But the setting is toggable, and we recommend enabling it - do this by typing "disallow crash codes" in your group chat.


Disallowing crash codes and seeing it in function. The empty space in the screenshot was a lag code, intended to make peoples Kik lag, or maybe even crash.

Note: if you are admin, Rage will not react to crash codes posted by you.