GTA Bot

GTA Bot is a full GTA-style economy and crime simulation that runs entirely inside Discord. You play in a text-based Los Santos: earn cash, level up with RP, run businesses and warehouses, pull heists, hit the casino, and climb leaderboards—all through slash commands and button-driven menus.

---

Getting started 🚦

• New players use /start to accept the Terms of Service, then /menu to open the main hub.
• The hub shows wallet, bank, chips, net worth, and level, with quick access to Jobs, Shop, Profile, Leaderboards, Casino, Bank, Steal, Business, and Warehouse.
• Every screen includes [↩️ Previous] and [🏠 Main] so you never hit a dead end.

---

Economy and progression 💰

• Cash lives in your wallet (at risk from steals) and your bank (protected; 2% fee on deposits, optional interest).
• Casino chips are earned or bought at the Cashier’s Cage and used for blackjack, slots, roulette, poker, dice, coin flip, lucky numbers, rock-paper-scissors, Connect 4, and Tic-Tac-Toe.
• Progression uses RP (Reputation) and levels based on GTA Online–style curves (levels 1–8000), with ranks like Thug → Gangster → Lieutenant → Boss → Kingpin → Criminal Mastermind.
• Level-up messages can be sent to a dedicated channel (e.g. /setlevelingchannel).
• Passive income runs on a timer from owned properties (apartments, garages, offices, nightclubs, auto shops, agencies, facilities, vehicle warehouses); passive RP rewards active players on an interval when they’ve been active recently.

---

Jobs 🔫

From the Jobs menu you can run:

• Robbery (easy/medium/hard tiers, cooldowns, success chance, wanted stars)
• Hitman contracts
• Racing (entry fee, win payout, rep)
• Car Theft (cooldown, success rate, wanted increase, sell multiplier)

Each has configurable payouts, penalties, and cooldowns in game_config.json.

---

Heists 🏦

Heist Central offers two paths:

• Interactive Dynamic Heists — multi-step jobs (e.g. Fleeca vault hack, Prison Break phases, Humane Labs circuit maze, Series A convoy, Pacific Standard vault) with unique mechanics, scouting, and time pressure.
• Classic Quick Heists — one-shot jobs: Corner Store, Liquor Store, Gas Station, Jewelry Store, Armored Truck, plus major targets (Bank Vault, Casino Vault, Art Gallery, Drug Lab) with equipment cost, rep/level unlocks, crew size bonuses, and approach modifiers (Stealth, Smart, Loud) affecting success, payout, and heat.

Wanted level affects risk and cooldowns.

---

Stealing and wanted 🚓

• Steal and Mug target other players’ wallets (success rate, max percentage, cooldown, reputation loss, failure penalty; bank is protected).
• Car theft ties into the vehicle warehouse flow.
• Wanted level (up to 5 stars) increases from crimes and decays over time; a background task can process decay and arrest risk.
• /wanted shows current status and cooldowns.

---

Businesses and warehouses 🏭

The Business Center lets you buy and run MC businesses (e.g. Document Forgery, Weed, Counterfeit, Meth, Cocaine, Nightclub) and specialty businesses. Each business has:

• Supplies (visual bars)
• Restock (instant for some, guessing game for cargo warehouses, or vehicle-stealing for vehicle warehouses)
• Sell to turn product into cash

Cargo Warehouses (e.g. 111 crates) use a “source cargo” minigame and selling for profit. Vehicle Warehouses (Import/Export) store vehicles by class; you source via lockpick-style minigames and sell for profit. Without a vehicle warehouse you can still steal and sell single cars with a cooldown.

---

Shop and property 🛒

The Black Market shop (dropdown: Vehicles, Properties, Collectables, Boosters) sells:

• Vehicles — GTA-named from Panto to high-end supers and open-wheel
• Properties — apartments, garages, offices, nightclubs, auto shops, agencies, facilities, vehicle warehouses (garage slots + passive income)
• Collectables — e.g. Rare Mask, Gold Chain, Designer Watch
• Boosters — e.g. RP×2, Cash×1.5, Luck+ for 30 minutes

---

Daily, trivia, and mini-games 🎲

• Daily reward — 24-hour cooldown, streak (e.g. up to 7 days) that increases payout; base payout scales with how many businesses you own.
• Fame or Shame trivia — GTA V questions with cash/rep rewards.
• Minesweeper — full minigame with configurable board size and mine count.
• Casino and arcade-style games — Connect 4, Tic-Tac-Toe, and more.

---

Profile and leaderboards 🏆

• Profile shows level, RP, rank title, wallet, bank, chips, net worth, achievements (properties, vehicles, businesses), and a business/warehouse summary (cargo crates, vehicle slots, MC count).
• Leaderboards rank players by wealth, notoriety (rep), wanted level, and level.
• Rank card and server-level leveling channel support give a clear sense of progression.

---

Technical and safety ⚙️

• Neon (PostgreSQL) backend for users, businesses, warehouses, transactions, cooldowns, and wanted state.
• Slash commands are gated by TOS acceptance (except /start, /tos, /help, /menu, /profile).
• Global and per-command cooldowns, balance checks, and idempotent-friendly design keep the economy and progression consistent.
• All gameplay is text and UI only—no 3D or real-time physics—so it fits Discord and stays maintainable.