Contents
Levlix Module Connections Guide
Module Connections links the Levlix modules on your server. A level-up can pay points, a counting milestone can pay XP or gold, a correct quiz answer can pay gold, and members can exchange server points and RPG gold with /exchange.
Everything is off until you switch it on. Each reward and each exchange direction is a separate switch with its own amount and daily limit.
Turn it on
- Open the Levlix Dashboard, pick your server and enable Module Connections on the Modules page (in the Server section of the sidebar).
- Open Module Connections in the Economy group of the sidebar to set up rewards and the exchange.
- The exchange can also be set up in Discord: run
/setupand open Engagement → Module Connections.
When you switch the module off again, rewards and exchanges stop and /exchange disappears from your server. Your matrix and exchange settings are kept for the next time.
Reward matrix
The Reward matrix card lists every moment a module reports in rows and the three currencies in columns. Switch a cell on, set its numbers and click Save matrix:
| Setting | Description |
|---|---|
| amount | What one moment pays to the member, up to 1,000 XP, 10,000 points or 100,000 gold |
| per day | How often one member can receive this reward per UTC day, up to 100 (0 = no limit, except for counting milestones) |
| every N numbers | Only for counting milestones: which numbers pay, from 10 to 100,000 (default 100) |
These moments are available:
| Moment | Comes from | Can pay |
|---|---|---|
| Level-up | XP | Points, gold |
| Counting milestone | Counting, every N numbers (you set N, at least 10) | XP, points, gold |
| Quiz: correct answer | Quizzes | XP, gold |
| RPG boss defeated | RPG | XP, points |
A moment never pays its own currency: a level-up cannot pay XP, a boss fight cannot pay gold. That keeps reward chains short, so one reward can never trigger an endless loop of further rewards.
Quiz rewards work per quiz. The values in the matrix are the defaults a new quiz starts with, and each quiz can change them or run without any reward at all.
When a member receives a connection reward, the card of the moment (for example the level-up or the quiz result) shows it in a line starting with 🔗. A counting milestone that pays something gets its own short card in the counting channel, as a reply to the number that reached it.
The Recent grants card at the bottom of the page lists the last 50 payouts and exchanges with the time, the member, the moment, the currency and the amount.
Exchange
Members swap server points and RPG gold with /exchange. You set both directions separately and save them with Save exchange:
| Setting | Description |
|---|---|
| Enabled | Whether members can exchange in this direction |
| Gold per point | The exchange rate, from 1 to 1,000 |
| Fee percent | Only for gold to points: the share of the gold that is kept, from 1 to 50 percent |
| Daily cap in points | Points a member can exchange per UTC day, counted as points paid (points to gold) or points received (gold to points), up to 100,000; 0 = no limit |
| Minimum amount | The smallest amount a member can exchange in one go, from 1 to 100,000 |
Gold to points first keeps the fee and then divides by the rate, rounded down. At 10 gold per point and a 10 percent fee, 1,000 gold pays 90 points.
/setup.New servers start with both directions off, a rate of 10 gold per point, a 10 percent fee, a daily limit of 500 points and a minimum of 1.
Commands
| Command | Function | Required Permissions |
|---|---|---|
/exchange |
Opens your private exchange card with the server's rates, your points and your gold; a button per direction asks for the amount | Everyone |
/exchange direction amount |
Exchanges right away, for example /exchange direction: Points to Gold amount: 100; the amount is 1 to 100,000 of the currency you pay |
Everyone |
/setup → Module Connections |
Sets up both exchange directions; the reward matrix stays on the dashboard, Reward rules opens it | Manage Server |
How it works
- Members need an RPG character to exchange, in both directions. Without one, the card points them to
/rpg start. - An exchange takes the source currency first and then pays the target currency. When the payment does not confirm, Levlix checks whether it arrived anyway and refunds the source currency only when the payment verifiably failed, so a member is never paid twice.
- Two exchanges of the same member never run at the same time, so the daily limit cannot be overshot by clicking twice.
- Members who turned off Activity Tracking in
/privacy, or who had Levlix delete their data, receive no connection rewards. - Rewards and exchanges are written to a ledger with the member, the moment, the currency and the amount. Entries older than 90 days are deleted, except exchanges that are still waiting for a review.
- Changes made on the dashboard reach the bot within a second.
FAQ
A member did not receive a reward.
Check that the cell is switched on, that the target module (XP or RPG) is enabled, that the member has an RPG character for gold, that the member has not reached the daily limit of that cell, and that the member has not turned off Activity Tracking in /privacy.
Why can members not exchange XP? XP is earned only. It is never taken away or exchanged, so levels always reflect real activity.
Can I see who exchanged what? Exchanges show up in the member's point history and in the Recent grants card. Every change to the matrix or the exchange made on the dashboard is recorded in the dashboard's audit log.