This project has a complementary web interface that you can use to control or configure your experience

Web Interface

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

**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.

GTA Bot

GTA-style Discord bot. Run jobs, own businesses & warehouses. Earn, level up, get wanted. Your criminal empire awaits. 🏙️

Voting for GTA Bot

Do you want to support us?