Documentation Index
Fetch the complete documentation index at: https://mintlify.com/developer51709/Niko/llms.txt
Use this file to discover all available pages before exploring further.
Niko includes a full café-themed economy with PIL-rendered wallet cards, a job progression ladder, tiered bank vaults, a weekly lottery, and 9 unlockable achievements. Every user starts with 100 🥐 and a default Barista job, and works their way up through career levels, bank tiers, and shop upgrades.
Wallet & Balance
| Command | Aliases | Description |
|---|
/balance [member] | bal, wallet | Display your or another member’s PIL-rendered wallet card showing coin balance, bank balance, current job, and career level. |
/profile [member] | prof, stats | Full café profile card including your earned achievement badges and the last 5 transactions. |
/daily | — | Claim your daily treats with a streak bonus. Missing a day resets your streak; maintaining it builds a multiplier up to 2.4× at day 7. 24-hour cooldown. |
/work | — | Earn coins based on your current job’s pay range. Cooldown is 1 hour by default (varies by job). Grants job XP toward career level-ups. |
/pay <member> <amount> | give | Transfer coins from your wallet to another user. Amount must be a positive integer. |
/transactions | tx, history | View your full credit/debit transaction log (up to 25 most recent entries, timestamped). |
/networth [member] | nw | Shows total net worth (wallet + bank), vault name, and your server rank. |
Daily Streak Multipliers
Your /daily reward scales with your consecutive-day streak. The base reward is 1,000 🥐.
| Streak Day | Multiplier | Reward |
|---|
| Day 1 | 1.2× | 1,200 🥐 |
| Day 2 | 1.4× | 1,400 🥐 |
| Day 3 | 1.6× | 1,600 🥐 |
| Day 4 | 1.8× | 1,800 🥐 |
| Day 5 | 2.0× | 2,000 🥐 |
| Day 6 | 2.2× | 2,200 🥐 |
| Day 7+ | 2.4× | 2,400 🥐 |
Jobs
The job ladder controls how much you earn per /work shift and how much XP you gain per shift. Use /job apply <id> once you meet the career level requirement.
| Command | Description |
|---|
/job | Browse the job board and see your current job highlighted. |
/job list | Same as /job — shows all available jobs with pay ranges, XP, and level locks. |
/job info <id> | Detailed stats for a specific job: pay range, XP per shift, cooldown, and description. |
/job apply <id> | Apply for a job if you meet the minimum career level. |
/job quit | Resign from your current job and return to Barista. |
Available Job Tiers
| Job ID | Title | Level Req | Pay per Shift | XP per Shift | Cooldown |
|---|
barista | ☕ Barista | 0 | 80–220 🥐 | 12 | 1h |
baker | 🥐 Baker | 5 | 180–380 🥐 | 18 | 1h |
manager | 📋 Shift Manager | 15 | 320–620 🥐 | 28 | 1h |
trader | 📈 Café Trader | 30 | 450–1,100 🥐 | 42 | 1h |
owner | 👑 Café Owner | 50 | 800–2,200 🥐 | 60 | 1h |
Career XP & Levels
Each /work shift awards XP based on your job. The XP needed to advance from level N to N+1 is 100 + (50 × N). Leveling up unlocks higher-tier jobs and level-gated shop items. You can spend a Career Brew (🧪) consumable from the shop to instantly gain 75 XP.
Bank
Your bank vault protects coins from /rob and earns daily compound interest credited automatically every 24 hours.
| Command | Description |
|---|
/bank | View your vault tier, stored balance vs. cap, and daily interest rate. |
/bank deposit <amount> | Move coins from your wallet into the vault. Use all to deposit everything up to the vault cap. |
/bank withdraw <amount> | Move coins from your vault back to your wallet. Use all to withdraw everything. |
/bank upgrade | Pay to upgrade your vault to the next tier. Cost is half the next tier’s cap, drawn from wallet first then vault. |
Bank Vault Tiers
| Tier | Name | Cap | Daily Interest |
|---|
| 1 | 🪙 Tin Jar | 10,000 🥐 | 0.50% |
| 2 | 🪵 Wooden Chest | 50,000 🥐 | 0.75% |
| 3 | 🔩 Steel Vault | 250,000 🥐 | 1.00% |
| 4 | 💎 Crystal Safe | 1,000,000 🥐 | 1.25% |
| 5 | 🏆 Diamond Vault | 10,000,000 🥐 | 1.50% |
Shop
The café boutique sells consumables, upgrades, and collectibles. Items may require a minimum career level to purchase.
| Command | Aliases | Description |
|---|
/shop [category] | — | Browse all shop items. Optional category filter: consumable, upgrade, or collectible. |
/buy <item_id> [count] | — | Purchase one or more items. Cost is deducted from your wallet. |
/sell <item_id> [count] | — | Sell items back from your inventory (at a reduced sell price). |
/inventory [member] | inv, bag | View your owned items grouped by category. |
/use <item_id> | — | Use a consumable or upgrade item from your bag. Collectibles cannot be used — they’re cosmetic. |
Shop Catalogue
Consumables — one-shot effects, consumed on use
| Item ID | Name | Price | Level Req | Effect |
|---|
espresso_shot | ☕ Espresso Shot | 250 🥐 | 0 | Halves your next /work cooldown |
lockpick | 🔓 Lockpick | 800 🥐 | 3 | +25% success chance on your next /crime |
rob_shield | 🛡️ Tip Jar Lock | 1,200 🥐 | 5 | Blocks the next /rob attempt against you |
lucky_charm | 🍀 Lucky Charm | 1,500 🥐 | 8 | Doubles tickets on your next /lottery buy |
xp_potion | 🧪 Career Brew | 2,000 🥐 | 2 | Instantly grants +75 career XP |
| Item ID | Name | Price | Level Req | Effect |
|---|
vault_upgrade | 🏦 Vault Upgrade | 7,500 🥐 | 4 | Advances your bank vault to the next tier |
/profile
| Item ID | Name | Price | Level Req |
|---|
regular_badge | 🎖️ Café Regular Badge | 5,000 🥐 | 0 |
golden_mug | 🏆 Golden Mug | 25,000 🥐 | 10 |
diamond_croissant | 💎 Diamond Croissant | 100,000 🥐 | 25 |
Lottery
A rolling weekly jackpot seeded at 5,000 🥐. Each ticket purchase adds to the pot. One winner is drawn automatically every 7 days.
| Command | Aliases | Description |
|---|
/lottery | lotto | View the current jackpot, time until the next draw, your ticket count, and the last winner. |
/lottery info | — | Same as /lottery — explicit info subcommand. |
/lottery buy [count] | — | Purchase lottery tickets at 200 🥐 each. More tickets = higher win chance. Active Lucky Charm doubles the tickets added. |
Crime & Rob
High-risk, high-reward commands for extra income. Both have a 1-hour cooldown and can fire achievements.
| Command | Description |
|---|
/crime | Attempt a risky side-income action. 50% base success rate (+25% with an active Lockpick). Success: earn 200–500 🥐. Failure: pay a fine of 100–300 🥐. |
/rob <member> | Attempt to steal from another user’s wallet. Target needs at least 100 🥐 and you need at least 100 🥐 to attempt. Success rate: 40%. If the target has an active Tip Jar Lock the robbery is blocked entirely. Success: steal 10–500 🥐. Failure: pay 150 🥐 to the target. |
Use a Lockpick (🔓) from the shop before /crime to boost your success chance to 75%. Use a Tip Jar Lock (🛡️) on yourself to auto-block the next incoming /rob.
Leaderboards
| Command | Aliases | Description |
|---|
/leaderboard | lb, top | View the server’s top earners by total net worth (wallet + bank). Displays a PIL-rendered leaderboard card with avatars, paginated at 10 entries per page. |
Achievements
Niko tracks 9 milestone achievements that unlock automatically when conditions are met. Newly unlocked achievements are announced inline with command responses (e.g. after /work). All earned badges display on your /profile card.
| Badge | Emoji | Unlock Condition |
|---|
| First Paycheck | 💼 | Work your first shift |
| Café Regular | ☕ | Work 25 shifts |
| Shift Lead | 📋 | Work 100 shifts |
| Tin-Jar Saver | 🪙 | Deposit 10,000 🥐 in the bank |
| Vault Keeper | 🏦 | Accumulate 100,000 🥐 in the bank |
| Millionaire | 💰 | Reach a net worth of 1,000,000 🥐 |
| Week-long Habit | 🔥 | Maintain a 7-day daily streak |
| Café Devotee | 🌟 | Maintain a 30-day daily streak |
| Café Owner | 👑 | Become a Café Owner (job level) |
Economy data is stored in data/economy_data/{user_id}.json, one file per user. The lottery state is stored separately in data/economy_data/_lottery.json. Make sure the data/economy_data/ directory is writable by the bot process.