Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/devjhoan/absolet/llms.txt

Use this file to discover all available pages before exploring further.

Absolet includes a fully self-contained per-guild economy. Every member starts with a cash wallet and a bank account, both starting at zero. Money circulates through earning commands (work, daily, weekly), risky plays (rob, blackjack), peer-to-peer transfers (pay), and a role-gating shop. Server owners control the coin emoji, earning rates, and casino multipliers — all without touching a config file.

​
How the Economy Works

Each user’s economic data lives in the EconomyModel document, scoped to both their Discord ID and the guild ID so economies are fully independent across servers: 
interface EconomyUser {
  guildId: string;
  userId: string;
  balance: {
    money: number; // cash — used for spending and transfers
    bank: number;  // bank — safe from being robbed
  };
  dailyReward: number; // Unix timestamp: next time daily can be claimed
  weeklyReward: number; // Unix timestamp: next time weekly can be claimed
}
The coin emoji (default 🪙) is shown in every economy embed and can be changed per-guild. All amounts are integers stored in MongoDB.

​
Earning Money

/work

Earn a random amount of cash between minMoney and maxMoney (defaults: 100–250). Subject to a 1-hour cooldown enforced by the bot’s command cooldown system.

/daily

Claim a fixed daily reward deposited directly to the bank. Cooldown resets every 24 hours. Default reward: 1,000 coins.

/weekly

Claim a fixed weekly reward deposited to the bank. Cooldown resets every 7 days. Default reward: 2,500 coins.

/rob [user]

Attempt to steal between 50 % and 100 % of another user’s cash balance. 50 % chance of success — on failure, the same random amount is deducted from your cash instead. The victim must have at least 1 coin in cash for a rob attempt to proceed.

​
Managing Money

/balance [user]

Displays a user’s cash balance, bank balance, and combined total. Defaults to the command author if no user is specified.

/deposit [amount]

Move cash into the bank. If amount is omitted, deposits the entire cash balance. Bank funds are protected from /rob.

/withdraw [amount]

Move funds from the bank back to cash. If amount is omitted, withdraws the entire bank balance.

/pay [user] [amount]

Transfer a specific amount of cash to another user. The amount lands in the recipient’s bank. Bots and self-payments are rejected.

​
Shop

The /shop command lets members browse and purchase items that grant Discord roles.

​
Browsing

/shop
Displays all shop items as paginated embeds (10 items per page). Each listing shows the item name, price, and description using the configured coin emoji.

​
Buying an Item

/shop name:<item name>
Pass the item’s exact name to enter the purchase flow directly. The bot checks:
  1. The user has enough cash (not bank).
  2. The user does not already own the item’s role.
  3. If the item has a requiredRole, the user holds that role.
On success, the item price is deducted from cash and the linked Discord role is granted immediately.

​
Shop Item Schema

interface EconomyShopItem {
  id: string;           // Internal identifier
  name: string;         // Name shown in /shop and used for purchase lookup
  price: number;        // Cost in coins (paid from cash balance)
  description: string;  // Shown in the shop embed
  role: string;         // Discord role ID granted on purchase
  stock: number;        // Available quantity (-1 = unlimited)
  requiredRole: string; // Optional prerequisite role ID (empty = no requirement)
}
Items are managed by admins via /shop-manage (add/remove items).

​
Casino

​
Blackjack — /blackjack [amount]

Bet any whole-number amount from your cash balance on a game of blackjack against the bot.
  • A standard 52-card deck (4 suits × 13 ranks) is shuffled at game start.
  • Face cards (Jack, Queen, King) are worth 10; Aces count as 1 or 11 (whichever keeps the hand ≤ 21).
  • The dealer draws until it reaches 17 or higher.
  • Use the Hit and Stand buttons to play.
OutcomeEffect
Player wins (or dealer busts)amount × blackjackReward added to cash (default 2×)
Player losesamount deducted from cash
Bust (player > 21)amount deducted immediately
TieNo change
The game board is rendered as a live image showing both hands and updates on every action. The session times out after 60 seconds of inactivity.

​
Leaderboard

/leaderboard economy
Displays a paginated ranking of all members in the server sorted by total wealth (cash + bank).

​
Configuration

All economy settings live under economyConfig in the guild document. Change them at any time via /setup → Economy Settings.
SettingDefault/setup optionDescription
coin🪙CoinEmoji used as the currency symbol in all embeds
dailyReward1000Daily RewardCoins awarded per /daily claim
weeklyReward2500Weekly RewardCoins awarded per /weekly claim
maxMoney250Max MoneyUpper bound for /work earnings
minMoney100Min MoneyLower bound for /work earnings
blackjackReward2Blackjack RewardWin multiplier for /blackjack

​
Admin Commands

Administrators have access to direct balance manipulation commands:
CommandDescription
/givemoney [user] [amount]Add coins to a user’s cash balance
/take-money [user] [amount]Remove coins from a user’s cash balance
/setmoney [user] [amount]Set a user’s cash balance to an exact value
/shop-manageAdd or remove items from the server shop
Configure the coin emoji and reward amounts in /setup → Economy Settings before launching the economy to your members. Setting a custom emoji (e.g. a server-specific emote) makes the currency feel native to your community without any code changes.

Build docs developers (and LLMs) love

Get started for freeTalk to us