Car thief

Documentation

At documentation file you can search for guidelines, error fixes and find answers to your questions.

https://3m-studio.gitbook.io/3m-documentation/

Turn your mafia job into a fully-fledged economic gameplay loop : steal, stash, and sell (or return) vehicles in a realistic, dynamic system.
With NPC drop-offs, a Mafia Garage NUI, and automated database integration, this script transforms simple thefts into an engaging business operation.
Preview


🔥 Highlights

  •  Full Mafia Workflow
     Steal vehicles, store them in your mafia garage, return them, or scrap them for instant cash — all through a structured, immersive system.
  • Configurable Payouts
    Control economy balance with a JSON-based pricebook (data/vehicle_prices.json).
    Payouts are percent-based and fully adjustable without touching SQL.
  • NPC Drop-offs
    Dynamic NPC buyers and drop-off points, locked by default — unlockable via server logic or job rank progression.
  • Mafia Garage (NUI)
    Intuitive interface for managing stolen vehicles: view, withdraw, or liquidate them directly from the garage UI.
  • LB-Tablet Integration
    See all impounded or stored cars within your mafia garage directly on your LB-Tablet for easy management.
  • Automatic Database Setup
    Creates the ukradena_vozila table automatically, cloned from your owned_vehicles(esx)/player_vehicles(qb) schema (1:1 columns + timestamps).
  • Full Localization
    Every label, notification, and Discord log is handled through the Locales system (includes English 🇬🇧 + Croatian 🇭🇷 out of the box).
  • Discord Logging
    Thefts, returns, and scraps are all logged with clean embedded messages, including timestamps and vehicle info.
  • Admin Quality of Life Commands
    /setvehprice, /getvehprice, /reloadvehprices — all ACE-gated for safe and simple price management.
  • Optimized & Asynchronous
    Built with oxmysql async queries, targeted NPC spawns, and minimal network usage for smooth performance.

⚙️ Requirements

Framework: ESX/QBCORE
Dependencies:

  • oxmysql (or MySQL.Async compatible wrapper)

  • ox_target/qb_target

  • ox_inventory/qb_inventory

  • ox_lib (for progress bars)


Recommended:

  • Custom notification bridge (supports Notify:Send wrapper—map it to your preferred notify system).


💼 Why Add This to Your Server?

Bring organized crime to life with a professional, modular, and optimized mafia system.
Offer your players a complete underworld economy, from stealing to smuggling, managing, and selling vehicles.

Build your empire. Run your operation. Own the streets.