Leveling, instances, streaks and rebirths

Catita gives XP for server activity and turns it into levels, reward roles and announcements. Configure it in /settings > Leveling.

/level shows the level card with the leaderboard rank.

Instances

An instance is a complete, separate leveling system. A server can have up to 5. Each one has:

• its own XP and leaderboard (/leaderboard);
• its own formula and XP sources;
• its own filters: which channels and roles it counts for;
• its own rewards, rebirth, streaks and announcements.

So a server can have, for example, chat levels and roleplay levels that never mix. With more than one instance, /level and /leaderboard ask which one to show.

Where XP comes from

Source	How it works
Messages	XP between a minimum and a maximum, with a cooldown in seconds
Voice	XP for time in voice channels, with a minimum time
Reactions	Earned by whoever reacts, the message author, or both
Slash commands	Using commands, including other bots’ commands

Each source has a minimum, maximum, cooldown and multiplier. The level formula can be balanced (each level costs a bit more), linear (every level costs the same) or exponential (high levels cost a lot).

Rewards

Roles and XP boosts given on reaching a level, a rebirth or a number of streak days. If someone leaves and rejoins the server, they get back the roles they had. With Showcase, each member chooses which ones they display.

Caution

Catita’s role has to be above the reward roles to give them.

Rebirth

On reaching the required level, /rebirth resets the level in exchange for the next rebirth rank, which can give roles and boosts. It can be limited so that only staff grant it.

Streaks

A streak counts the consecutive days with activity in the instance (writing, being in voice or using commands). If you miss a day, a freeze is spent; with no freezes left, the streak starts over.

• The server’s own time zone.
• Freezes: how many days to earn one and how many are kept (up to 10).
• Icons by streak days and a reaction to the first message of the day.
• Roles by streak days, removed if the streak drops.
• /streak shows someone’s streak.

Announcements

Catita announces level-ups, rebirths and streaks in a fixed channel, where it happened or by DM (according to each person’s /notifications).

• When to announce: always, every N levels or only when a role is earned.
• Levels with a special message (their own title, text and image).
• Text, color, image, mention, card or text-only style, with variables like {level}, {user} or {rewards}.

Control panel

From /settings, staff can add or remove XP and rebirths, reset a person or their streak, and reset the whole instance.

Commands: leveling reference.