Level/XP System

Squint's leveling system rewards active members with experience points (XP) for sending messages. As users gain XP, they level up, which can be used to assign roles or simply track engagement.

Setup

1. Enable the leveling system: ;level enable

2. (Optional) Set a channel for level-up announcements: ;level channel #level-ups

3. (Optional) Configure level-up messages and embeds: ;level message Congrats {mention}!

4. (Optional) Set roles to be assigned at specific levels: ;level addrole 5 @Level5Role

Configuration

• enabled: Toggles the entire leveling system on or off.

• sameChannel: If true, level-up messages are sent in the channel where the user leveled up. If false, they are sent to the designated channel.

• channel: The ID of the channel where level-up messages are sent (if sameChannel is false).

• autoDelete: Automatically deletes level-up messages after a specified number of seconds (0 to disable).

• title: The title of the level-up embed. Supports variables.

• message: The description/message content of the level-up embed. Supports variables.

• color: The color of the level-up embed.

• baseXP: The base amount of XP awarded per message.

• characterMultiplier: Multiplier for bonus XP based on message length.

• maxXP: Maximum XP a user can gain from a single message.

• baseRequiredXP: The base XP required to reach Level 1.

• levelMultiplier: A multiplier that increases the XP required for each subsequent level.

• roles: A map of level numbers to role IDs. When a user reaches a specific level, they are assigned the corresponding role.

Available Variables for Messages:

• {mention} - Mentions the user.

• {name} - User's username.

• {server} - Server name.

• {level} - User's new level.

• {tag} - User's tag.

• {avatar} - User's avatar URL.

• {servericon} - Server's icon URL.

• {membercount} - The total number of members in the server.

Usage

Users gain XP by sending messages in any channel (subject to a 1-minute cooldown per user). When they accumulate enough XP, they automatically level up, and a customizable message is sent to announce their new level.

Related Commands

• ;level - Main command for managing the level system and viewing user levels.

• ;level top - View the server's level leaderboard.