Updated 2026-11-14 • 6 views

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

  1. Open the Levlix Dashboard, pick your server and enable Module Connections on the Modules page (in the Server section of the sidebar).
  2. Open Module Connections in the Economy group of the sidebar to set up rewards and the exchange.
  3. The exchange can also be set up in Discord: run /setup and open Engagement → Module Connections.
Note
A reward in gold needs the RPG module, a reward in XP needs the XP module, and the exchange needs the RPG module. When one of them is switched off on your server, the matching cells show that and pay nothing.

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
Note
Counting milestones need a per day limit of at least 1 and an interval of at least 10. A milestone pays once per count round, and a new round starts every time the count is reset, so the daily limit is what stops members from breaking the count on purpose to earn the same milestone again. Setting the count to another number by hand does not start a new round. A counting cell saved earlier with 0 is treated as the default of 5 per day, and a smaller interval is raised to 10.

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.

Important
The way back must never be cheaper than the way in. Gold to points needs a rate at least as high as points to gold and a fee of at least one percent, so exchanging points to gold and back always ends with fewer points. Levlix refuses to save settings that break this rule, both on the dashboard and in /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.
Warning
When Levlix cannot tell whether the payment arrived, or the refund itself fails, it refunds nothing and keeps the exchange on record for review instead. The member is told to contact the server staff. Check their point history on the Points page and their RPG gold, and correct the balance by hand if needed. Such an exchange counts fully against the member's daily limit.

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.

Was this article helpful?

Thanks for your feedback! Your vote helps us improve the documentation.

Your vote could not be saved. Please reload the page and try again.

Share this guide

Your Privacy

We use essential cookies to operate this site and optionally Google Analytics to improve our services. You can accept all, reject all, or choose which categories you allow.

Privacy Policy

Cookie Preferences

Choose which categories of cookies you want to allow. You can change this at any time.

Essential Cookies

Required

Session, CSRF protection, login state.

Analytics Cookies

Optional

Google Analytics 4 with anonymized IP, used to understand aggregate usage.