Aetheria Documentation

Economy & Leveling

Aetheria features a full-featured economy system with XP-based leveling, coin rewards, a purchasable shop, and automatic role unlocks at configurable level thresholds.

XP & Leveling System

Every message a user sends earns them XP. The system is designed to reward consistent participation:

  • XP per message: 15–25 XP (random), scaled by the server's XP multiplier
  • Cooldown: 60 seconds between XP-eligible messages (prevents spam farming)
  • Coins per message: 5–10 coins earned alongside XP
  • XP multiplier: Configurable from 0.1× to 10× on the dashboard Economy page
Level-Up Formula: XP required = 100 × level². For example, Level 5 requires 2,500 XP, Level 10 requires 10,000 XP. When a user levels up, an announcement embed is sent in the channel where the triggering message was posted.

Level Role Rewards

Automatically assign Discord roles when users reach specific levels. This is a powerful way to grant perks, channel access, or status recognition to active members.

  • Navigate to Economy → Level Rewards on the dashboard
  • Set a trigger level (e.g., Level 5) and select a Discord role to award
  • When a user reaches that level, the role is automatically added to their profile
  • The level-up notification embed will mention the unlocked role
  • Users keep all previously earned reward roles (rewards stack)

Coins & Shop

Coins are a secondary currency earned through chatting and daily claims. They can be spent in the in-server shop.

  • /daily — Claim a configurable daily coin reward (default: 100 coins, 24h cooldown)
  • /pay <user> <amount> — Transfer coins to another member
  • /shop list — View purchasable items
  • /shop buy <item> — Purchase an item

Built-in Shop Items

👑 V.I.P Role
500 coins
⭐ Supporter Role
1,000 coins
🍀 Lucky Charm Badge
250 coins

Leaderboard & Rank Cards

Track member rankings with the built-in leaderboard system:

  • /rank [user] — Displays a detailed rank card showing level, XP progress bar, coin balance, and inventory badges
  • /leaderboard — Shows the top 20 members sorted by XP in a formatted embed
  • Public Web Leaderboard — Available at /leaderboard/<guildId> on the dashboard site (no login required)