CodeM BLVCK Car Service - NPC Car Service Business System for FiveM
A complete NPC car service business system where players buy or rent service locations, hire staff with granular permissions, manage a material supply chain with a supplier NPC and delivery truck, set service prices, upgrade their business across 3 upgrade trees, and watch NPC mechanics repair, wash, and paint customer vehicles with tool props, multi-step animations, and particle effects. 6 service types, multi-bay locations, vault system with transaction history, custom spray gun and pressure washer weapons, a full admin panel with in-game location editor, 9 server-side exports for external sales integration, 4 database tables, and a React NUI.
FEATURES
- 6 service types: Full Repair ($800, 30s), Tyre Repair ($150, 30s), Body Repair ($400, 30s), Engine Repair ($500, 20s), Car Wash ($100, 30s), Random Paint ($750, 40s) - each with configurable price, duration, min/max price range the owner can set, and material consumption per service
- NPC walks to the vehicle, equips a tool prop (wrench, hammer, or blowtorch attached to hand bone 57005), and performs multi-step repair animations - kneeling at wheels, standing at engine bay with hood open, hammering body panels, and welding with torch
- Full repair walks through 4 steps: engine with wrench (weight 2, hood opens), left front wheel kneeling, right rear wheel, right side hammering - duration split between steps by weight
- Body repair cycles 4 sides: left side hammer, rear weld, right side hammer, front weld
- Paint service: NPC equips custom WEAPON_CS_SPRAYGUN with streamed model, walks around the vehicle body edge-by-edge at configurable speed (0.6), weap_extinguisher particle on the gun muzzle bone, margin 1.6m from body, aim height 0.25m
- Wash service: NPC equips custom WEAPON_CS_NOZZLE (codem_washinggun model), walks around at 0.7 speed, water_cannon_jet particle with water color tint attached to the weapon entity with nozzle tip offset, margin 2.2m
- Bay stays busy until the NPC has returned to idle position after the job (configurable buffer 10s)
- Business ownership: buy permanently or rent for a configurable period (default 30 days) - max businesses per player configurable (default 1, 0 = unlimited), owner cut of service income to vault (default 100%), sell-back refund rate (default 50% of purchase price)
- Rent expiry warning 3 days before (configurable), rent extension from the boss tablet, auto-repossession after abandonment (default 7 days without owner or staff activity)
- Owner capabilities: set service prices within admin-defined min/max range, rename the business (optional fixed prefix like "Oto Servis"), hire/fire staff, manage vault (deposit/withdraw), order supplies, buy upgrades
- External sales mode: when externalSales = true, the buy/rent flow is handled by an external script via exports (e.g. tgiann-placesales) - the player menu hides the buy option
- Staff system: hire up to 5 employees per location (configurable) with 5 granular permission levels - Boss (full access), Withdraw (vault access), Prices (set service rates), Supply (order materials from supplier), Free (perform services without charging the customer)
- Employee roster with names, permissions, and hire dates - edit permissions or fire from the boss tablet
- Supply chain: owned businesses with stockEnabled consume materials per service (1 unit per service default) - 3 material types: repair parts (for all 4 repair services, $45/unit), wash soap ($15/unit), paint ($90/unit)
- Restock at a supplier NPC (configurable location with blip): select materials and quantities, pay from business vault, delivery truck spawns (default speedo) loaded with the order, drive to the business, park within 12m of the bay, unload to depot
- Depot capacity 100 units per material (default), truck load cap 60 total units per trip (default) - both increased by upgrades
- 3 upgrade trees with 5 levels each, bought from the boss tablet (paid from bank), reset on business sale, kept on ownership transfer:
Stock: depot capacity +50/+100/+150/+200/+300 units ($8K/$14K/$22K/$32K/$45K)
Truck: load capacity +25%/+50%/+100%/+200%/+300% ($12K/$18K/$26K/$38K/$55K)
Relations: supplier purchase discount 5%/10%/15%/25%/40% ($11K/$16K/$24K/$35K/$50K)
- Admin panel via /carservice command: create, edit, disable, delete service locations - place NPC and vehicle bay positions by walking to the spot and clicking "Place Here" in-game - full blip picker with all GTA blip sprites and colors, marker picker with all 44 marker types
- Per-location controls: label, NPC model, NPC scenario, interaction distance, vehicle radius, per-service toggles and pricing, stock levels, sale/rent price, sale mode (buy/rent), disabled toggle, unlock price for extra bays
- Multi-bay locations: each location can have multiple service bays with independent NPC positions, vehicle positions, and unlock pricing (players buy extra bays from the boss tablet)
- Supplier settings configurable from the panel: NPC model, location, scenario, delivery vehicle model, blip
- UI customization: title, subtitle, and accent color (hex) - editable from the admin panel
- 2 custom streamed weapons with full weapon meta files (archetypes, animations, ped personality): WEAPON_CS_SPRAYGUN for paint and WEAPON_CS_NOZZLE for wash - NPC equips/unequips automatically during service
- Editable hooks in editable/client.lua: applyService() runs the actual GTA natives on service completion (SetVehicleFixed, SetVehicleDirtLevel, SetVehicleColours, etc.) - fully editable without touching core files - also onMenuOpened, onServiceStarted, onServiceDone hooks
- Editable server hooks in editable/server.lua: CanBuyLocation(src, loc, price, account) returns false to block purchase (VIP check, job requirement), OnLocationBought() and OnLocationSold() for post-purchase logic
- 9 server-side exports for external integration: IsReady, GetLocations, GetLocation, GetForSale, SetOwner, RemoveOwner, ExtendRent, GetOwnedBy, SetForSale - used when externalSales = true for third-party sales scripts
- Client event codem-carservice:setBlips and export SetBlipsVisible(bool) toggle all blip visibility at runtime
- Server event codem-carservice:ownerChanged fires on ownership changes
- Blip grouping: all car service blips grouped under one map legend category (configurable slot, default 26)
- 2 default seed locations included (Burton Servis, La Mesa Servis) - everything managed from the admin panel after first start
- Walk speed, repair margin, NPC return buffer all configurable
COMPATIBILITY
- Frameworks: QBCore, QBox, ESX (auto-detected via codem-lib)
- Database: oxmysql - 4 tables (AutoSQL creates and migrates on start)
- Dependencies: ox_lib, codem-lib
- Escrow-ignored: config.lua, editable/*.lua, locales/*.json