BankBotThe server owner's guide
How to set the bot up and how points move through its economy. Every number here comes from the bot's live configuration.
Setup
- Add the bot from the invite link. Every member gets a bank account automatically.
- The dashboard or
/settings view— toggle casino, transfers, loans and rewards; pick the game channel; make rounds public or private. /enable-mining— creates a forum channel with the mining shop; running it again republishes the shop./group-game settings,/group-game mafia-settingsand/group-game xo-settings— trigger words, timings, loss and reward amounts (also in the dashboard)./help— the in-Discord command guide, with a button to the dashboard.
Dashboard
Sign in with Discord to see your stats and manage the bot in your servers. Only two permissions are requested: your identity and your server list.
Open dashboard →Selecting a server with the bot opens its settings:
| Section | What you can set |
|---|---|
| 🧩 Systems | turn casino, transfers, loans and rewards on or off |
| 🎰 Casino | game channel; public or private rounds |
| 👥 Group games | enable them and pick their channel |
| 🎯 Elimination roulette | triggers, loss and prize share, player counts, timings, shield, insufficient-balance rule |
| 🕵️ Mafia | triggers, timings, reward and daily cap, doctor, vote and reveal rules |
| ❌ XO | challenge and tournament on/off, their triggers, move/accept/registration timers, tournament player counts, and rewards |
| ⛏️ Mining | status and shop forum (enabling stays in /enable-mining because it creates the channel) |
Any change shows a bar at the bottom: Save changes or Reset (Ctrl+S works). You cannot leave the server with unsaved changes, and every value is validated by the server. The bot applies changes within a minute, and each save is logged with who made it.
Economy
Points enter only through rewards and leave through transfer fees, the casino edge and mining costs. Track the daily ledger on the statistics page.
| Source | Amount | Rule |
|---|---|---|
| Hourly reward | 3 | automatic for eligible members |
| Activity reward | 1 | message of 5+ chars, once per 1 min |
/daily | 10 + 2/day | streak up to +20; keep it by claiming within 48h |
| Weekly | 50 | claimed with /daily every 7 days |
/transfer | 1–10,000 | 5% fee (1–100), daily limit 5,000 |
Casino
All games live in /play. The bet is escrowed when a round starts and settled once; any error or restart refunds it.
| Game | Win chance | Payout | Note |
|---|---|---|---|
| 🪙 Coin flip | 49% | ×1.95 | |
| 🎲 Dice | 42.1% | ×2.25 | |
| 🎡 Roulette | 48.6% | ×1.95 | Green ×35 |
| 🎰 Slots | — | ×400 | Top prize |
| 🍀 Luck meter | 50% | ×1.9 | |
| 💣 Minefield | — | — | Up to ×1000 ・ max bet 1500 |
Each game returns ≈95% of wagers in the long run. See the real return
Animated visuals
Dice, luck meter, European roulette and the slot machine show an animated GIF, then replace it with a still result image. The outcome is settled and saved before drawing, so the animation is display only and never changes the odds. If drawing takes over a second the text result appears at once. See them move
Group games
Start with /group-game start or a trigger word — just type it in the channel, like روليت (no mention needed).
| Players | Money | Triggers | |
|---|---|---|---|
| 🔫 Elimination roulette | 3–12 | free entry; eliminated lose 10; winner takes 100% of losses | روليت ・ !روليت |
| 🔪 Mafia | 5–15 | free entry; each surviving winner gets 50 (up to 5 reward rounds a day) | مافيا ・ !مافيا |
| ❌ XO | 2 (challenge) ・ 3–16 (tournament) | no bet; challenge winner gets 20 (up to 10 a day), tournament champion gets 100 (up to 3 a day) | اكس او ・ xo ・ إكس أو ・ بطولة اكس او ・ بطولة xo |
Elimination wheel and themes
Each turn a GIF wheel spins through the living players and stops on the decider, who picks a numbered button in the channel, uses «🎲 Random eject», and any player may «👋 Withdraw». In the dashboard you choose the wheel theme (BankBot, classic, royal, ruby, ocean, or custom colours) with a live preview.
In-round abilities shop
Living players buy abilities with round points (not bank money), once per ability per round.
| Ability | Price (points) | Effect |
|---|---|---|
| 👁️ Reveal | 1 | Shows you who currently holds a reflect or a golden shield |
| ↩️ Reflect | 2 | The first player to pick you gets eliminated instead (secret) |
| 🟡 Golden shield | 3 | Cancels the first elimination that hits you, by choice or bomb (secret) |
| 🔄 Swap fate | 3 | You become the decider next turn (lost if you're eliminated before it) |
| 💚 Revive | 4 | Brings an eliminated player back (they can't be charged twice) |
| 💣 Bomb | 5 | Use on your turn (now if it's your turn, or next time) — eliminates random players (needs 4+ alive) |
A bot restart never stops a round: it resumes where it stopped, with no duplicate charges or rewards.
Mining
- Buy a container — no rig runs without one.
- Buy a ready rig, or parts and then
/build-rig. /mining-profile— earnings every 10 minutes minus electricity; efficiency decays and rigs stop below 40% until maintained.
Efficiency decay depends on heat load (rig power versus cooling capacity), then case airflow and the container cooling factor. Better cooling means less maintenance. Watch it live in the dashboard mining hub.
Loans
/loan request ・ /loan repay ・ /loan status — one active loan at a time; late days add a daily penalty.
| Amount | Interest | Term | Daily late fee |
|---|---|---|---|
| 50 | 8% | 7 days | 2 |
| 100 | 10% | 7 days | 5 |
| 200 | 15% | 10 days | 8 |
| 500 | 20% | 14 days | 15 |
Data API
Public read-only JSON endpoints used by the statistics page (dashboard data is private to its owner):
GET /BankBot/api/statsservers, accounts, today's activity
GET /BankBot/api/economy?days=14daily point flows by source (7, 14, 30)
GET /BankBot/api/casino?days=30real return per game (7, 30, 90)
GET /BankBot/api/overviewgroup games, mining, loans
GET /BankBot/api/leaderboard?sort=balanceleaderboard (balance, earned, played)
GET /BankBot/api/highlightsbig wins and group game winners