Customizing XP Gain

Kiai lets you customize exactly how members earn XP in your server. You can adjust message XP, the leveling formula, level caps, and reset behavior.

Message XP

Message XP is awarded for chat activity. Kiai calculates it randomly within your configured range, and it does not depend on message length.

Settings can be found in /settings > Message XP.

Message XP: Turns the feature on or off.
XP Cooldown: The time a member must wait between earning XP from messages.
Minimum XP per Message: The smallest amount of XP a message can award. Set between 1 and 100,000,000.
Maximum XP per Message: The largest amount of XP a message can award. Set between 1 and 100,000,000.
Level Cap: The highest level a member can reach. Once a member's XP reaches the amount needed for the cap, Kiai stops awarding them further XP from any source until you raise or remove the cap. Turn this setting off to remove the limit.
Reset Member XP on Leave/Kick: If enabled, a member's XP resets when they leave the server or are kicked.
Reset Member XP on Ban: If enabled, a member's XP resets when they are banned from the server.

Example: If Minimum XP is 5, Maximum XP is 15, and Cooldown is 60 seconds:

Kiai can also read proxy messages sent through Tupperbox or PluralKit and award XP for them. Configure it in /settings > Proxy Messages.

The XP Formula determines how much XP a member needs to reach each level.

12 * ({level} * {level}) + {level} * 12

Visualize this formula with the XP Visualizer.

{level} represents the member's next level and is required in every custom formula.
Kiai does not support restarting XP at 0 for each level. To get a very similar effect, add + {xp} to your formula.

Example: Custom formula:

15 * ({level} * {level}) + {level} * 10 + {xp}