Skip to content

Leveling

✨ Introduced in Frogge v1.0

Leveling gives members XP for chatting and spending time in voice channels, with level-ups, an optional announcement, and Discord roles granted automatically at levels you choose. The public surface is /rank; admin configuration lives under Settings rather than its own top-level /admin menu button.

Quick Start

  1. Run /admin menu → Settings → Leveling → Toggle next to Enabled. It's off by default.
  2. Adjust Message XP Range, Message Cooldown, and Voice XP Rate if the defaults don't fit your venue.
  3. Optionally set a Level-Up Announcement channel, and add Role Rewards for any levels that should auto-grant a role.
  4. Members check their own progress with /rank.

Screenshot needed

The Leveling settings screen and the /rank response.

Full reference

How XP works

  • Messages: cooldown-gated (default configurable, see Settings below), a random amount within Message XP Range per eligible message. Bot messages never earn XP, and neither does a message in an excluded channel or from someone with an excluded role.
  • Voice: awarded when a member leaves or switches voice channels, based on how many full minutes they spent there times Voice XP Rate. If Require Others in Voice is on, XP is only granted if someone else (not a bot) was still in that channel at the moment they left.
  • Levels: a fixed curve that gets steeper each level (not admin-configurable in this version). If a member jumps multiple levels at once, most likely from a single large voice-XP award, every Role Reward in that range is granted, not just the highest one.

Settings

Settings (from /admin menu → Settings → Leveling) has:

  • Enabled: master on/off toggle.
  • Message XP Range: minimum/maximum XP per eligible message.
  • Message Cooldown: seconds between XP-earning messages.
  • Voice XP Rate: XP per minute spent in a voice channel.
  • Require Others in Voice: whether voice XP needs another (non-bot) member present.
  • Level-Up Announcement: a channel to post "🎉 {member} reached Level X!" to, or off.

Two sub-screens branch off from here:

  • Exclusions: channels and roles that never earn XP, each with its own Add/Remove. Excluding something only stops future XP; it doesn't remove XP already earned.
  • Role Rewards: up to 25 level → role pairs, granted automatically the moment a member reaches that level, with the usual Add/Remove.

Checking your own status

/rank opens My Rank (current level, total XP, and progress toward the next level) and Leaderboard (the top 10 members by total XP).

  • Standalone: doesn't connect to any other module.