Leveling & Economy

Guardexa's XP system rewards members for being active in your server. Members earn XP by sending messages in text channels. The amount of XP per message, the cooldown between XP gains, and which channels award XP are all configurable from the dashboard.

By default, members earn between 15 and 25 XP per eligible message with a 60-second cooldown. This means spamming messages does not award additional XP — the system encourages consistent, meaningful participation. Certain channels can be excluded from XP calculations, such as bot commands channels or administrative areas.

Members can check their own progress using /xp (shows current XP and level) and /level (shows a detailed progress bar toward the next level). The /leaderboard command displays the server's top members by level and XP, with optional filtering by time period (weekly, monthly, all-time).

XP rates can be boosted for specific channels or roles. For example, you might award double XP in a discussion channel or give your supporter role a permanent XP multiplier. These boosters stack multiplicatively, so a supporter posting in a boosted channel receives 4x normal XP.

Level rewards incentivize members to stay active by granting roles when they reach specific milestones. Configure rewards from the dashboard under Leveling > Rewards. Click 'Add Reward', select a level threshold, and choose the role to assign. For example, you might grant a 'Chatty' role at level 5, a 'Regular' role at level 10, and an 'Elite' role at level 25.

When a member levels up and qualifies for a reward, the role is assigned automatically. The bot posts a level-up message in the designated channel that can be customized with the member's name, new level, and the reward they received. You can configure the level-up message template from the dashboard with support for placeholder variables like {user}, {level}, and {reward}.

Multiple rewards can be assigned at the same level. You can also configure rewards to be stackable (members keep all previous roles) or non-stackable (higher-level roles replace lower-level ones). For role-limited servers, non-stackable rewards help manage role count.

Use /rewardroles to view all configured rewards and their current status. You can temporarily disable rewards without deleting them, which is useful for testing or seasonal events.

The economy system gives members a currency they can earn and spend. Members earn currency through /daily (a once-per-day bonus that increases with streaks), /weekly (a larger weekly bonus), and by chatting in eligible channels. The daily streak system resets after 24 hours — missing a day resets your streak multiplier.

Server admins can create a shop from the dashboard under Leveling > Shop. Each shop item has a name, description, price, and an optional role to assign on purchase. Items can be one-time purchases or unlimited. For example, you might offer a 'Change Nickname' item that allows the buyer to request a nickname change, or a 'Rainbow Role' that changes color periodically.

Members browse the shop using /shop, see item details with /shop view <item>, and make purchases with /buy <item>. Purchases are logged and, where applicable, the associated role is assigned immediately. Role removal on item expiration is handled automatically.

Use /balance to check your own balance and /give @user <amount> to transfer currency to another member. Transfers are logged for anti-abuse purposes. You can configure minimum and maximum transfer amounts from the dashboard to prevent economy manipulation.

Achievements are special milestones that members can unlock by completing specific objectives. Unlike levels which are purely XP-based, achievements reward specific behaviors and accomplishments, adding another layer of engagement to your server.

Built-in achievements include 'First Message' (send your first message), 'Conversation Starter' (start a thread that reaches 10 replies), 'Helper' (have your message marked as a solution 5 times), 'Marathon' (maintain a 30-day daily streak), and 'Well Rounded' (participate in at least 5 different channels). Each achievement has a unique icon and is displayed on the member's profile card.

From the dashboard, you can create custom achievements with your own criteria. For example, 'Event Veteran' could be awarded for attending 3 server events, or 'Early Adopter' could be manually awarded to founding members. Custom achievements can use Discord emoji as their icon.

Members can view their achievements using /achievements. The command displays a grid of all achievements with locked/unlocked states and progress bars for in-progress achievements. Completed achievements show the date they were earned. An achievement leaderboard is available from the dashboard showing who has the most achievements.