Skip to content

alden-bot/ChatLevels

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChatLevels Plugin

A per-group leveling and experience system for Alden Bot.

Features

  • Isolated Progression: Experience and levels are tracked per-group. Direct messages are ignored.
  • Dynamic EXP: Configurable min/max EXP bounds gained per message.
  • Cooldowns: Prevents spam-leveling via message cooldowns.
  • Economy Integration: Soft-depends on EconomyAPI. If available, users receive coin rewards upon leveling up.
  • Image Generation: Generates a visually appealing rank card using @napi-rs/canvas.

Commands

Command Aliases Permission Description
/rank /level chatlevels.use Displays the user's current level, EXP progress, and rank within the group.

Configuration

Settings are automatically generated in data/ChatLevels/config.json on first run:

{
  "expMin": 15,
  "expMax": 25,
  "cooldownMs": 15000
}
  • expMin / expMax: The randomized amount of EXP awarded per valid message.
  • cooldownMs: Time required between messages to gain EXP (in milliseconds).

Permissions

  • chatlevels.use - Granted to users by default (level 0). Controls access to the /rank command.

About

Group-based experience and leveling system

Resources

Stars

Watchers

Forks

Contributors