Economy (Leveling) Module

Members earn XP on a cooldown per message. Optional voice XP while connected to voice channels.

Level thresholds grant roles automatically. Level-up can post to a channel or stay silent.

XP shop panel lets members spend XP on roles via buttons (if configured).

Mutually exclusive with Lioconomy — only one economy mode per server.

1. Enable Economy module.
2. Set XP per message, cooldown seconds, and optional voice XP rate.
3. Add level → role mappings (level number + Discord role).
4. Optional: level-up channel, shop channel, shop items.

• Cooldown — prevents spam grinding; typical values 60–120 seconds.
• Level roles — bot role must be above reward roles in hierarchy.
• Announce level-up — toggle channel announcements vs DM (if enabled in config).
• Shop — define items with XP cost and target role; panel uses buttons.

XP accrues automatically — no user command required for basic leveling.

/rank shows the rank card; /shop opens purchase buttons when the shop is enabled.

Members use shop panel buttons to purchase configured roles.

• No XP gained → module enabled? bot can read and send messages in that channel?
• Roles not granted → bot role above reward roles.
• Level-up spam → increase cooldown or disable announcements.
• Shop button fails → user needs enough XP; role hierarchy.