Economy

Create multiple currencies with different properties. Each currency has flags: • casino — usable in casino games • duels — usable as duel stakes • giftable — can be sent to other members • convertible — can be exchanged for other currencies • destroyable — balance can be self-destroyed • shop — usable in the shop • jobs — usable as job payment • corpDues — usable for corporation dues One currency is marked as Default and used across all modules by default. Symbol and emoji are configurable for display. Setup: Dashboard → Economy → Currencies → Create Currency.

Each member has a balance for every currency. Balance operations: • Credit — from admin or automatic (salary, bonus) • Debit — purchase, fine, commission • Transfer — member to member • Gift — if the currency has the giftable flag • Freeze — admin can lock part of a balance All operations are atomic — protected against duplication and race conditions. Usage: /economy → Balance, Transfer, Gift buttons.

Members earn a bonus for daily check-ins. Streak multipliers increase rewards: • 7 consecutive days — x1.2 • 14 days — x1.5 • 30 days — x2.0 • 60 days — x2.5 • 100 days — x3.0 Streak resets if more than 24 hours pass between claims. Streak protection (bought from the shop) prevents one missed day from resetting. Setup: /admin → Economy. Usage: /economy → Daily Bonus.

Set exchange rates between currencies. Both currencies must have the convertible flag enabled. You can restrict which currencies a given currency can convert to (convertibleTo whitelist). Commission percentage is configurable separately. Rates are updated via Dashboard → Economy → Exchange Rates. Usage: /economy → Exchange.

The server treasury is the global currency pool. • Emit (Mint) — create new currency, increasing supply • Burn — reduce supply by destroying currency • Mass operations — grant or deduct currency from all server members at once All treasury operations are logged in the audit. The casino also has its own separate treasury balance. Setup: Dashboard → Economy → Treasury.

Create purchasable items for members. Item types: • ROLE — grants a Discord role on purchase • INTERNAL — internal item (badge, status) • EXTERNAL — requires manual delivery by seller • STREAK_PROTECTION — protects daily bonus streak from reset Purchase actions (actions on purchase): • ADD_ROLE — automatically grant a role • ADD_BALANCE — credit currency • SEND_MESSAGE — send a message Configurable: price, stock limit, per-user purchase limit, discounts, P2P commission for sellers. Setup: Dashboard → Shop. Purchase: /shop.

Admins create deposit types with settings: • Name and term (1–365 days) • Interest rate (annual) • Minimum and maximum deposit amount • Linked to a specific currency Members open deposits and earn interest at maturity. Early withdrawal is possible but always incurs a penalty. Setup: Dashboard → Bank. Usage: /economy → Bank.

P2P lending between members: • Borrower requests a loan specifying amount, interest rate, and term • Lender accepts or rejects the request • Collateral: type (role or badge) and value • Late payments incur penalty interest • Borrower reputation affects loan access All loan operations are lock-protected against race conditions. Setup: Dashboard → Loans. Usage: /economy.

Savings account with daily interest accrual. Unlike the bank, savings have no fixed term — members deposit and withdraw at any time. Interest accrues daily automatically. Settings: • dailyRate — daily rate (e.g., 0.005 = 0.5%) • maxAmount — maximum account balance • Linked to a specific currency Setup: /admin → Economy. Usage: /economy → Savings.

Stock exchange for corporation shares: • Corporations issue stocks (IPO) — set quantity, public float, and initial price • Orders: market (instant buy) and limit (at specified price) • Portfolio: track positions, average buy price, profit/loss • Price alerts — notifications when target price is reached • Quotes: current price, change, 24h volume, all-time high/low Setup: Dashboard → Stock Market. Usage: /corporation → Stock Market.

Automatic payments to members based on Discord roles. Admins configure which role receives how much in which currency. Payments are processed automatically via the job scheduler (BullMQ). Frequency and amounts are configurable per role. Setup: Dashboard → Salaries or /admin → Salaries.