Commands

Friend usage:
Friend

With friend command, you essentially be-friend Rage.
This command has to be typed in a private message with Rage before you can add it to any groups.
Rage should reply with a confirmation.

For more detailed instructions you can read the step-by-step guide here.

Ping usage:
Ping (works in PM too)

Ragebot responds with "pong".
This is the best way to check if Ragebot is still running, or if it's temporarily down.

Usage usage:
Usage (works in PM too)

With usage you can view all available commands for Ragebot and a short explanation of their functions, along with some extra information at the bottom.
Use this feature if you cannot remember a command.

Set rules usage: ✍︎ ⎘
Rules (displays the rules/welcome message)
Set rules Welcome! (sets the rules/welcome message)
Delete rules (deletes the rules/welcome message)

With set rules you can set up rules that essentially also functions as a welcome message.
When new people join the group, they will automatically be greeted by the rules.
Everyone can view the rules by typing "rules" in the group chat, but only admins can set or delete them.


You set up rules by typing "set rules" followed by any text you want as the rules.
Please keep in mind it has to be typed in one sentence, like on the screenshot above - not in two seperate posts.
You can type "rules" to check that it looks like you want it to.
If you want to delete them again, type "delete rules" - only admins can do this.

Substitutions usage: ✍︎ ⎘
Trigger -> Response (creates a normal substitution)
Trigger ~> Response (creates an admin substitution)
Trigger (triggers the substitution)
List (displays a list of all substitutions)
Delete trigger (deletes the substitution - only admins can delete admin substitutions)
Delete all (deletes all normal substitutions - be careful!)
Delete all admin (deletes all admin substitutions - be careful!)
You can replace "trigger" and "response" with any text.

With substitutions you can program Rage to give a text response to what you type by using an arrow.
There are two types of substitutions, and therefore two types of arrows.
Using a straight arrow (->) you create a normal substitution.
This means that anyone can create it, trigger it, overwrite it and delete it.
But the wavy arrow (~>) is an admin-only substitution.
This means only admins can create it, overwrite and/or delete it.
BUT normal users can still trigger admin substitutions.
Note: the "Permissions" command will affect how users can interact with substitutions.


You set up a normal substitution by typing "Trigger -> Response" into the group chat.
So when someone in the group types "Trigger", Ragebot will respond with "Response".
This can be done with (almost) any word and/or sentences.
If you want to set it up as an admin substitution, you simply use ~> instead of ->.

Note: The only cases where you cannot set up a substitution is if the trigger part of the substitution exceeds 100 characters, or if its a word that's already used as a Ragebot command (or you're trying to set up an admin substitution whilst not being an admin...)
You also cannot create a normal substitution if there already exists an admin substitution by the same trigger.
Substitutions are not case-sensitive.
We will provide more examples below.


Here we are setting up multiple substitutions.


Here you see how they work in function.


With the "list" command, you can view the list of substitutions - although it will only list the first part (the trigger) and not the response.
The list will display both normal substitutions and admin substitutions.
If your list is too long to display all substitutions, you can type "list 2", "list 3" and so on to view the remaining ones.


If you want to delete a substitution, you will need to type "delete trigger", with "trigger" being whatever the substitution is called.
Normal substitutions (->) can be deleted by anyone, whereas admin substitutions (~>) can only be deleted by admins


If you decide you want to delete all normal substitutions, you will need to type "delete all".
If you want to delete all admin substitutions, type "delete all admin" instead.
Rage will list all of the substitutions it has deleted - for a very limited time, you can type "undo" and it will undo the deletion.
The "delete all" and "delete all admin" are both admin-only commands - so you don't need to worry about non-admins doing this.
Warning: Only use this command if you're 100% sure you want to delete everything.

Time usage: ⚯
Time shows current time zone, if set
Time NL shows time in Netherlands
Time NA lists time zones in North America
Set Time lists instructions & continents
Set time UK sets time zone to UK
Set Time PT sets time zone to Pacific Time
Set Time GMT+1 sets time to GMT+1
Delete time deletes the set time

With time you can set a dedicated time zone for your group.
This can be used in many ways - besides setting a time zone for your group, it can also be used as an insert in substitutions, rules and other features that support custom text ✍︎.
If a time zone has been set, everyone can check the time by typing "Time" into the group.

If no time zone has been set, it will show an error instead.

There are multiple ways this can be set up.
You can use country name, two-letter abbreviation or country flag - however, it will only work if the entire country is in one time zone.
For countries with multiple time zones, a list with the time zones will be displayed instead.

Below we will demonstrate the easiest way to set a time for your group.

---

For countries/areas with 1 time zone:

You can set the time by typing "Set time", followed by your country's name, abbreviation or flag - for example, "Set Time Denmark", "Set Time NL", or "Set time .
Note: If the sun icon is displayed, it means the time zone follows Daylight Saving Time (DST). If the icon is not displayed, and your time zone does follow DST, it means the time will be inaccurate half of the year. 

For countries/areas with multiple time zones:

1. Type "Time", followed by the continent abbreviation, e.g. "Time EU" for Europe, "Time OC" for Oceania, and so on.
2. Locate the time zone that matches your region, and type "Set Time", followed by the time zone abbreviation - e.g., "Set time EET" or "Set Time Eastern Europe" to set it to Eastern European Time.
You can view the list of continents by typing "Set Time".

For the following countries: US/CA/AU/NZ/MX/ID:

1. For USA, Canada, Australia, New Zealand, Mexico and Indonesia, you can type "Time", followed by your country code, e.g., "Time USA" to see a list of time zones in your country.
2. Locate the time zone that matches your region and type "Set Time", followed by the time zone abbreviation - e.g., "Set time PT" or "Set Pacific" to set it to US Pacific Time.
Note: the "MST", "PST" and other Standard Time abbreviations will not work due to Daylight Saving Time.

---

Using GMT or UTC

You can also set your group's time zone using GMT or UTC offset, e.g. "Set time GMT+5" or "Set time UTC-2".

We do not recommend using this method because GMT and UTC does not follow Daylight Saving Time.
If you use this method and you're in a DST time zone, you will have to change the set time every time your location sets the clock forward or backwards.

---

Time Inserts

In features that supports customizable text ✍︎ (such as substitutions, Set goodbye, Disallow joining and more), you can make Ragebot insert the current time of a specific location.

There are different ways people write the time depending on where they’re from, so to accommodate that, we have added several formats:

Here we highlight the difference between how a specific time and date would be typed in Europe, vs US:

For Europe, that would be [Time], [Day], [Date] [Month] [Date##]/[Month##]/[Year]
For US, you would use [Time#], [Day], [Month] [Date#] [Month##]/[Date##]/[Year]

If you have a group with members from two different time zones, you can choose to create a substitution that will show those specific time zones.
This can easily be done by adding [Time] followed by the location into the substitution, e.g. [Time London], or [Time PT].
If you want the time to be shown in AM/PM instead of military time, you replace Time with Time#, like done below:

Time zones can be confusing to keep track of, but this should make it easier.

---

Time-based Inserts

Not to be confused with Time inserts, this feature will only show specific texts within a certain time frame, based on the time zone set.
This can be used in any feature that supports custom text ✍︎.

Currently, the following is supported:
Within a certain time frame, e.g. [15:00-18:00]. It uses military time.
On a certain day of the week, e.g. [Monday], or within specific days, like [Monday-Friday].

For example, if you want to set up a substitution with specific responses based on the day of the week, you can type:
"Todays activities -> [Friday] Twitch Movie Night at 8 PM! DM Rachel for link!

[Saturday] Sharing Saturday - share one of your happy memories with the group.

[Sunday-Thursday] No activities today!"

When the substitution is triggered, Rage will respond with the message matching the day of the week as shown.

If you are in a situation where you want to add some text after the scheduled portion of the message, and you want it to be shown at all times, you can "break up" the time with [/].
This means that any text after [/] will be shown.

---

Time-based Disallow Joining ★

Similarly, this can be used to only allow new members to join at certain times of the day, e.g. To “disallow joining” during the night.
You would type the command Disallow joining followed by the time format and finally the message you want to display.

For example "disallow joining [00:00-06:00] Sorry, the group is currently closed because it's in the middle of the night. Please rejoin in the morning!"
Make sure the time is written before the message section, otherwise it will work as a time-based insert instead.

He will have to join again later!

You can also choose to only temporarily disallow joining - by typing "Disallow Joining [05:00]", the group will be closed until 5 AM.

If you want to check what time you set for disallow joining, you can do this by typing "display disallow joining".
You can read more about the Display feature here.

---

More time-related features will be added in the future - if you have any good suggestions, reach out to us in support!

[Inserts] usage: ⚯
[User] names whoever triggered the substitution/feature
[Random User] names a random group member
[Joiner] names last joiner
[Leaver] names last person who left
[Kicked] names who was last kicked
[Banned] names who was last banned
[Group] inserts group name & hashtag
[Group Name] inserts group name
[Group Hashtag] inserts group hashtag
[Group Description] inserts group description
[Owner] names the group owner
[Admins] names the admins
[Time] inserts group time
[Insert Trigger] inserts the substitution reply
Display substitution shows original text, works for all features with customizable text

With Dynamic [Inserts], you can insert data from a feature or action into any Ragebot features that support custom text ✍︎ - they are basically like mini-features that can be used inside of other features.
This allows you to more easily customize your features to fit different needs, thus requiring less work for your admins.

These are some of the features that support inserts: Set rules, Substitutions, Set goodbye, Disallow joining & Set captcha reply and more.
You can also spot them by this icon: ✍︎

Keep in mind that Ragebot will not reply to any inserts outside of the custom text features - e.g. saying "[User]" in the group will not work!
Below, we will explain each of the inserts in sections.

---

[User] & [Joiner] Insert

Including [User] in any of your custom text features will display the screen name of whoever triggered the feature.
This trigger can be direct (when the user types "Rules"), or indirect (a user joins the group and the rules are automatically displayed)

In this example, let's pretend your screen name is Rachel.
If you want to set up a substitution that says the name of whoever triggers it, this is how you do it:

By inserting [User], it will mention the screen name of whoever triggers it - Rachel in this case.
This will make customizing messages much easier!


On the other hand, if you want Ragebot to specifically mention the latest joiner, rather than whoever triggered the command, you can use [Joiner].

In this example, we want it to greet the person who joins the group, inside the rules that are automatically posted when someone joins.
We can also choose to include the owner's screen name, and the group's local time as well.

As you can see, the rules now mention both the joiners' name, the group name, the local time and name of the group owner.
Make sure you've picked a timezone for your group, otherwise this will not work! You can read more about that feature here.

---

Using [Kicked] for stating removal reason

Most group admins will agree that the majority of the time someone is kicked, it's due to common issues like refusing to verify, or DM'ing without permission.

There are situations where it might be beneficial to share with your group why they were removed.
Below, we will explore a way to simplify this step using Ragebot.

We set up a substitution that is only intended for admins to use, after kicking someone for refusing to verify.
When manually triggered after a kick, Ragebot will state the name of the last user who was removed, along with the reason for their removal - this saves the admin the trouble of having to manually explain it in the group.

---

Using [Random User] in substitution games

Some groups may have set up various games in substitutions, such as rock-paper-scissors, war and various guessing/dice games.

Let's create our own version of a "spin the bottle" game that will spark conversations between group members.

We start off by creating a substitution called "Spin".
In that substitution, we use [User] to refer to whoever triggers the substitution, and use [Random user] to have Ragebot pick a random person in the group - lastly, we explain in a short sentence what that person has to do.

As a result, people get to play this little interactive game and get to know their fellow group members better!

---

Separating group rules from "Set rules"

With the new [Insert trigger] feature, you can now insert a substitution into any features that support customizable text ✍︎

This can be useful if you want to split things up - for example, you may want to have the primary "Set rules" message only contain the welcome message, along with some group info.
Then you can have a separate substitution with the group rules.
This means no more distracting welcome & group info "fluff", if you need to remind group members of your rules.

Here we specifically create a separate substitution called "group rules", that contains our list of rules.
In "Set rules", we only put our welcome message, followed by [Insert trigger] - specifically, "[Insert group rules]", since that is what we named our substitution.

As a result, you can now trigger the list of rules separately by typing "group rules".

---

Using all inserts in one substitution

We can also create a "group stats" substitution, to reveal various information about the group.

Here's what that can look like:

Maybe not super useful, but it's fun to see.

---

Using [Time] inserts

There are a number of time-related inserts that you can use.
You can read more about them here.

---

"Display" to see the original [insert] text

If you need to make any changes to your rules, substitutions, or other features where you've used inserts, you will need to use the Display feature.

Simply type "Display" in front of any features that support custom text ✍︎ - e.g. "Display substitution", "Display rules", "Display goodbye" ★, and so on.
Ragebot will reply with the original, bracketed [insert] text - making it easy to copy-paste.

You can read more about the Display feature here.

Font usage: ⚯
Test -> *Your text* becomes 𝗬𝗼𝘂𝗿 𝘁𝗲𝘅𝘁
Test -> ~Your text~ becomes 𝒴ℴ𝓊𝓇 𝓉ℯ𝓍𝓉
Test -> /Your text/ becomes 𝘠𝘰𝘶𝘳 𝘵𝘦𝘹𝘵
Test -> [Ignore] /Your text/ prevents stylizing
Display test shows original text

With fonts you can stylize any text by converting it into a font. Fonts can be used in any features that support custom text ✍︎, such as set rules, substitutions, set goodbye, set captcha reply and disallow joining message.
This allows for better expression and emphasizing of certain parts of the text - for example, by making the important parts bold.

Type of font	What to type into the group	Result
Bold	*Your text*	𝗬𝗼𝘂𝗿 𝘁𝗲𝘅𝘁
Bold italic	*/Your text/*	𝙔𝙤𝙪𝙧 𝙩𝙚𝙭𝙩
Bold underline	*_Your text_*	Your text
Bold strikethrough	*-Your text-*	Your text
Italic	/Your text/	𝘠𝘰𝘶𝘳 𝘵𝘦𝘹𝘵
Italic underline	/_Your text_/	Your text
Italic strikethrough	/-Your text-/	Your text
Underline	_Your text_	Your text
Strikethrough	-Your text-	Your text
Outlined	=Your text=	𝕐𝕠𝕦𝕣 𝕥𝕖𝕩𝕥
Cursive	~Your text~	𝒴ℴ𝓊𝓇 𝓉ℯ𝓍𝓉
Bold cursive	*~Your text~*	𝓨𝓸𝓾𝓻 𝓽𝓮𝔁𝓽
Monospaced	`Your text`	𝚈𝚘𝚞𝚛 𝚝𝚎𝚡𝚝
Full width	+Your text+	Ｙｏｕｒ　ｔｅｘｔ
Boldify	++Your text++	🇾​🇴​🇺​🇷​　🇹​🇪​🇽​🇹​
Circled	°Your text°	Ⓨⓞⓤⓡ ⓣⓔⓧⓣ
Circled solid	%Your text%	🅨🅞🅤🅡 🅣🅔🅧🅣
Germanic	&Your text&	𝔜𝔬𝔲𝔯 𝔱𝔢𝔵𝔱
Germanic bold	*&Your text&*	𝖄𝖔𝖚𝖗 𝖙𝖊𝖝𝖙

---

Using fonts in Set Rules

In the example above, we added *~bold italic~* to the welcome part of the message, *bold* for Rules, %circled solid% for the 1, 2, 3, ending it off with /italic/ for the bottom text.

Initial text	Result
~*Welcome to our group*~ *Rules*: %1% Don’t be rude! %2% Have common sense. %3% Don’t advertise. /We hope you enjoy your stay!/	𝓦𝓮𝓵𝓬𝓸𝓶𝓮 𝓽𝓸 𝓸𝓾𝓻 𝓰𝓻𝓸𝓾𝓹 𝗥𝘂𝗹𝗲𝘀: ❶ Don’t be rude! ❷ Have common sense. ❸ Don’t advertise. 𝘞𝘦 𝘩𝘰𝘱𝘦 𝘺𝘰𝘶 𝘦𝘯𝘫𝘰𝘺 𝘺𝘰𝘶𝘳 𝘴𝘵𝘢𝘺!

---

Fonts in substitutions

In the example above, by using *bold*, we are emphasizing that it is forbidden to send a direct message to another group member without their prior consent.
This will make the substitution stand out from other messages when triggered.

---

Our examples have been pretty basic thus far, but there aren't really limits to what you can do.
If you want to be an absolute menace, you can craft some beautiful "live, laugh, love" substitutions, like shown below.

Your group will love these!

---

"Display" to see the original text

If you need to make changes to your stylized texts, you will need to use the Display feature.

Simply type "Display" in front of any features that support custom text ✍︎ - e.g. "display trigger", "display rules", "display goodbye" ★, and so on.
Ragebot will reply with the original, unstylized text - making it easy to copy-paste.

You can read more about the Display feature here.

---

Prevent fonts with [Ignore]

We've added some preventive measures in order to prevent most false positives, but it can still happen that some text unintentionally gets converted to a font - this is especially a risk with any ASCII art.

However, by adding [ignore] [/ignore] on either side of the text, Ragebot will disregard the font instructions and instead send the text as-is.
Note: if you want the entire message to not be stylized, you can just put [ignore] as the very first thing. No need to write it for every new line, or at the end of the message.

Remember, you can use Display to get Ragebot to post the unstylized text, making it easier to fix.

Display usage: ⚯
Display shows instructions
Display Substitution shows trigger reply
Display Rules 
★ Display Captcha 
★ Display Captcha Reply 
★ Display Disallow Joining 
★ Display Goodbye 

With display, you can get Ragebot to show the text response from any feature that supports custom text ✍︎, as you originally set it.
This means you can see how a “Roll” command was set up, reveal the symbols that were used to stylize a text (Fonts), Inserts will be displayed in their respective [brackets], and you can check what message & time dependency you set for "Disallow joining", "Set goodbye" and other features.
This makes it easy to copy-paste the response if you want to make any changes.

---

Display Substitutions

In order to check a substitution, you type Display, followed by the trigger name of the substitution.
For example, if you set up a substitution triggered by "Your favorite pet, Ragebot?", you would have to type "display your favorite pet, Ragebot?".

This is how you check the original roll settings that was set up for this substitution.

The same goes for any feature that supports custom text ✍︎ - inserts, fonts and more will be shown as they were originally written, which makes it much easier to copy-paste the text if you need to make any changes.

---

Display Rules

Similarly, it can be used to see any inserts that are used.
In the example below, various inserts, such as [joiner], [group name] and more are used in the group rules.

---

Display time-dependency for Disallow Joining ★

Sometimes it's hard to remember the settings that have been set up for the group - this can be especially confusing with the new time-dependency setting for disallow joining.
Fortunately, it is now much easier to check!

Simply type "display disallow joining", in order to check for time dependencies, along with any formatting or inserts used in the message itself.

Roll usage: ⚯
Roll d7 (7 sided die, Rage will pick a number between 1 to 7)
Roll 2d7 (2 dice with 7 sides, Rage will pick two numbers between 1 to 7)
Roll d7 + 10 (7 sided die, Rage will pick a number between 1 to 7 and add 10 to it)
Roll d7 - 5 (7 sided die, Rage will pick a number between 1 to 7 and subtract 5 from it)
Roll who is awesome? (Rage will pick the name of someone in the group)
Roll dog or cat or bird (Rage will pick one of the options, they are separated by "or")
You can use these in substitutions/set rules/set goodbye (Premium). You can use any die numbers & any words between "or".

With roll you can use Ragebot to make RNG (random) selections or to roll dice 🎲.
This introduces a whole new way of using Ragebot, and works more or less the same way as the @roll bot - it was created as an alternative for when @roll was down.
All aspects of roll can be used in substitutions, set rules and set goodbye.
Because this feature can be a little confusing, we are going to be mainly demonstrating the use through screenshots.

---

Rolling a die / selecting a number:

You can use the basic die roll by typing "roll d7". D stands for die/dice 🎲 and 7 is the number of sides. It can be any number between 1-1000.
As can be seen in the screenshot above, this can be used in a substitution as well.

Here you are rolling 2 dice with 7 sides each. Ragebot will tell you what each die resulted in, along with the total sum when combined.

---

Adding & subtracting

By typing "roll d7 + 10" you are rolling a die with 7 sides, and adding 10 to the total sum. The + 10 can be replaced with any number.
This can also be done with multiple dice.

Just like previous example, you can type "roll d7 - 5" to roll a die with 7 sides, and substracting 5 from the total sum. The - 5 can be replaced with any number.

---

Roll who

By typing "roll who is awesome?" you are asking Ragebot a question, and Ragebot will pick the name of someone from the group.
Any question can be asked this way, such as "roll who should do the laundry?" or "roll who is more likely to get in trouble?"

---

Roll multiple options

By typing "roll dog or cat or bird", you are asking Ragebot to pick between the options provided.
You separate the options by typing "or" between them.

This does present a whole new way of utilizing Ragebot, as you can now set up one substitution to provide multiple (different) responses.
We might provide some more advanced examples of how this can be used in the future.

Note: you cannot use a new line anywhere when setting up multiple options for Ragebot to pick between. Everything has to be written in one paragraph.

GIF usage: ⚯
Gif kitty (Rage posts a kitty GIF from Tenor)
You can replace "kitty" with any word, and it can be used in substitutions/set rules/set goodbye (Premium).

With gif you can get Ragebot to post a gif from one of the top 50 results of your search term from Tenor gifs, which is similar to how Kik gifs work.
It works the same way that the @gif bot worked before the developer shut it down.
This allows for new entertaining ways for Rage to interact with members through media.

If you type "gif kitty" Ragebot will post a random gif from the top 50 results of the "kitty" search term on Tenor.
Any search term can be used, but we are using "kitty" and "cat" as examples here.

In the example above, we are setting up an admin substitution (~>) for "cat".
Every time someone types "cat", Rage will post a gif of a cat.

Note: Ragebot has to be out of Kik Jail in order to post gifs, and it's not possible to set it to post a specific gif.

AI usage:
Rage what is the meaning of life? (Rage will tell you the meaning of life)
Allow AI (enables AI, enabled by default)
Disallow AI (disables AI)

Set AI Name Jack (sets name to Jack) ★ ⎘
Set AI Personality Jack Sparrow (sets personality to Jack Sparrow) ★ ⎘
Delete AI Name (resets name) ★ ⎘
Delete AI Personality (resets personality) ★ ⎘

With AI you communicate with, or ask any questions to Ragebot in any language.
This allows you and your fellow group members to have more fun with Rage!

You can use it by typing "Rage what is the meaning of life?", or any other message or question you can think of. Think of this feature as an AI text generator; you can ask it questions, or tell it to write things for you.
It cannot brew your coffee or set your alarm clock, regardless of what it tells you :-)

The feature only works in public groups on basic Rage, and there is a limit to the amount of inquiries you can make - however with a Premium Ragebot, you're able to use it in private groups and the daily limit is set much higher.

Note: The AI feature runs on an older dataset, so certain information it provides may be slightly outdated!

---

For Premium users, you can use two additional commands.

You can set a custom name for your Ragebot AI by typing "Set AI Name", followed by a one-worded name.
When an AI name has been set, your bot will respond to any sentence starting with that name.

If you want to set a custom personality, type "Set AI Personality", followed by the personality trait(s).
You can instruct it to act like a famous character/person such as Jack Sparrow, Barack Obama, or give it specific personality traits such as Gen Z or kind and helpful.

In the example above, we're setting Rage AI's name to Jack, and personality to Jack Sparrow.
When prompted, Rage will now speak like the worst captain you've ever heard of!

If you want to delete the AI name and personality, you can do so by typing "delete AI name" and "delete AI personality".
This will set them back to default.

48 mode usage: ⎘
48 mode (displays description)
48 mode on (enables 48 mode)
48 mode off (disables 48 mode - default)
48 mode cap 98 (sets the cap - 48 by default)

With 48 mode Ragebot will automatically kick the people from the bottom of the "talkers" list when the group is almost full, in order to keep a spot open for new people.
48 mode is off by default, but once enabled it will automatically set the group cap to 48 - so if you have a 100 slot group, remember to change the cap to a higher number before enabling it.

Important: if you only just added Ragebot into your group, we recommend you wait a day or two before enabling this feature so Ragebot has time to accumulate a correct list of who is talking and who isn't.
Otherwise it might kick people who were talking shortly before it was added to the group.


You can change the max group member capacity by typing "48 mode cap 47", or any other number.
By default, this number is set to 48, so for most groups this step is unnecessary.
Setting the cap does not automatically enable 48 mode.

To enable 48 mode, simply type "48 mode on".
When enabled, it will go into effect once a new person joins the group while it is near the cap.


Note: keep in mind that this cannot increase your actual group member limit.

Talkers & Activity usage:
Talkers (displays when users last talked)
Activity (displays when users last looked)

Ragebot cannot detect talkers and activity while it is stuck on captcha or down.
It begins accumulating the talkers and activity data to the lists from the moment it has been added to the group - it cannot view talkers and activity data from before it was added.
Also keep in mind that when you use the "Import all" command, it will pull the data for talkers and activity from the last backup and thus overwrite any current data.
This can result in seemingly inaccurate times.
Additionally, in some cases Rage will still display the names of users who've left the group - they'll show up in the bottom of the lists with --:--:-- as the time. This is a known glitch and it should disappear eventually as new people join the group.

---

With talkers you can get Rage to display a list of when people last talked.
It'll display the list in days, hours:minutes:seconds format, with the top of the list being those who talked the most recently.
This is the information that is used for the "48 mode" command.
If you have a 100 slot group, you can type "talkers more" to see the rest of the list.
When someone joins the group, they will be placed at top of talkers so they don't get booted before they have a chance to speak.

---

With activity you can get Rage to display a list of when people were last active (reading the group).
It'll display the list in days, hours:minutes:seconds format, with the top of the list being those who viewed the group most recently.

Please note that activity sometimes misses users reading the group if you don't use substitutions and/or commands frequently enough.
Rage relies on read reciepts for it to detect users reading - so if you don't use Rage often enough then it doesn't have a way of detecting whether or not people are reading along.
We recommend getting your group chat to use substitutions frequently in order to maintain an accurate activity list.
If you have a 100 slot group, you can type "activity more" to see the rest of the list.

---

How to use Talkers & Activity to find lurkers:
With the talkers and activity commands, you can easily figure out who's lurking (someone who reads the chat but fails to contribute) in your group by viewing and comparing a users time on the two lists.
If a users talkers and activity time matches (or is roughly around the same time) it means that they participate in talking when they read the group.
But if there is a large time gap between a users talkers and activity time - especially if they are listed far down on the talkers list - then they could be a lurker.

Import & Backup usage:
Import (lists backup data)
Import all (imports backup data)
Backup (creates backup)

With import & backup you can import and backup your group data.
Every day around noon CET, Ragebot will automatically create a backup of all active groups it is in.
The backup will contain the following information:
All substitutions, activity list, talkers list, settings (for Rules & 48 Mode) and everything else you have set up with Ragebot.
There are three commands associated with this:

"Import"
This command will list the details of the most recent backup available for the group.

"Import all"
Using this command will restore all the data from the most recent backup to your group without the need of manually re-entering all substitutions and settings.
This is especially useful if your bot has been banned.

"Backup"
Although an automated backup of settings and substitutions occurs daily, this command can be used to force a manual backup should you wish to swap bot.
If you want to swap your Ragebot, type "backup" in the group chat.
Wait for a confirmation that it has backed up - then use the "Rage leave" command, invite in another Rage and type "Import all".
Remember to re-admin your Ragebot.

Keep in mind that when a new Ragebot has been added to the group (due to permanent ban or bot-swap), it usually skips saving during the first backup cycle and doesn't automatically backup until the next one (~36h).
Because of this, it is recommended that completely new groups do a manual backup after setting everything up.

Note: the automated daily backup doesn't occur if there is no activity in the group.

Disallow silent usage: ⎘
Disallow silent
Disallow silent 2
Allow silent (Default)

With disallow silent, Ragebot will remove users that join and don't say anything within an x amount of minutes.
This feature is useful in setting a time-limit for when a greeting or response to the rules is expected, whilst also combatting the type of "thot" (spam) bots that join without saying anything for hours.
You can either use the "disallow silent" command without any number at the end (default time is 5 minutes), or you can insert a number between 1-15. Example below:


Here we set it to "disallow silent 10" - the new-joining user didn't say anything within 10 minutes and was therefore removed.
Users joining without speaking is very common - these so-called "lurkers" usually stay inactive, or proceed to break the rules of the group.

Note: the feature doesn't affect users who are added to the group or join through invite links / QR codes.

Permissions usage: ⎘
Permissions (displays description)
Permissions 1 (default)
Permissions 2
Permissions 3
Permissions 4

With permissions you can limit Rage's response to users in your group.
It only limits users, admins are not restricted in any way
There are 4 levels.

Level 1 - "Permissions 1"
This is the default setting.
Rage will respond to all users.

Level 2 - "Permissions 2"
Non-admins can't create/edit or delete substitutions.
This means that users are prevented from creating or modifying substitutions, but they can still trigger already-existing substitutions.
Nothing else is affected.

Level 3 - "Permissions 3"
Non-admins can't create/edit or delete substitutions, and they cannot use any commands.
This is similar to Permissions 2, but with the additional limitation that users also cannot use any commands ("ping", "wisdom", "settings" etc.).

Level 4 - "Permissions 4"
Non-admins can't create/edit/delete substitutions or trigger admin-only substitutions, and they cannot use any commands.
This is similar to Permissions 3, but with the additional limitation that users cannot trigger admin-only substitutions (~>), although they can still trigger already-existing normal substitutions (->).
This allows for more flexibility - if you have a group where you want to allow the users to trigger substitutions, but want to reserve some substitutions for admins only, you can use this setting.
Or perhaps you don't want your members to use any substitutions at all - in which case you can make all substitutions into admin-only (~>) substitutions.

Rage leave usage:
Rage leave

With Rage leave you can make Ragebot leave the group if you are admin.
This is quite useful if either the owner of the group isn't around to remove Ragebot, or Ragebot has become the owner of the group.

Announcements usage:
Announcements
Disallow announcements
Allow announcements

With announcements, your group will receive the latest news & updates broadcasted by Ragebot.
The feature is enabled by default, but can be switched off by typing "disallow announcements", or switched back on by typing "allow announcements".

Wisdom usage:
Wisdom (works in PM too)

The wisdom command makes Ragebot post a piece of wisdom.
Become enlightened.

---

Admins usage:
Admins

With admins you can view the list of admins currently detected by Ragebot inside of the group chat.

If Ragebot doesn't detect you as admin, invite someone to the group chat and try again - that should fix the issue.

---

Donate usage:
Donate (works in PM too)
Donators (works in PM too)

With donate you can view the information about how to donate and such.
The same information can be viewed here.
Use "donators" command in a group chat with Ragebot to view our current donators.

---

My jid usage:
My jid (works in PM too)

With My jid you can get Rage to list your jid.

---

Group jid usage:
Group jid

With Group jid you can get Rage to list your groups jid.

Settings usage:
Settings

With settings you can view all of the current settings in Ragebot, along with the number of substitutions your group has.
This is useful for troubleshooting or if you'd like to know Rage's current configuration for the group.