Skip to content

Configuration

Ali Baba edited this page Jan 6, 2026 · 2 revisions

βš™οΈ Full Configuration Guide

This page provides an exhaustive breakdown of every variable within config.lua. Use this to fine-tune the balance between realism and gameplay.


πŸ’Ž 1. Core & Framework

Variable Type Description
Framework String Set to "ESX" for standard installations.
ProgressBar String "ox_lib" for modern UI or "none" for default.
Debug Boolean Set to true to see coordinate logs and logic traces in F8.

πŸ’° 2. Economy & Pricing Logic

The script uses a dynamic scaling system for repairs.

  • pricePerHP: Every 1.0 engine health lost costs this amount. (Formula: $Damage \times Price$).
  • minRepairPrice: Prevents players from repairing for $1.
  • accounts: Define where the money is pulled from (money or bank).

πŸ‘₯ 3. Professional Mechanic Check

This feature prevents the "AFK Mechanic" issue.

  • checkOnline: Enables the job check.
  • maxMechanics: The threshold. If 2 mechanics are on duty, the automated system shuts down.
  • jobName: The database name of your mechanic job (e.g., mechanic or repairman).

🎭 4. Immersive Visuals & SFX

Option Default Effect
openHood true Physically opens the bonnet/hood of the car.
exitVehicle true Forces player out of the seat before interaction.
repairSound "WELDING_LOOP" Uses GTA V native 3D spatialized audio.
particleEffects Enabled Syncs welding sparks and steam for all nearby players.

πŸ›‘οΈ 5. Whitelisted Jobs (The Power System)

You can define special rules for specific jobs (Police, EMS, etc.):

Config.WhitelistedJobs = {
    ['police'] = { 
        ignoreMechanics = true, -- Can repair even if 10 mechanics are on duty
        free = true,           -- No charge
        fastRepair = true,     -- Sprints through the timer
        discount = 0.0         -- 100% off
    }
}

πŸ“ 6. Location Management

Each location is treated as a unique object. This allows you to create specialized spots, such as a "Wash Only" station or a "Mega Center" that provides all services.

  • Timer: Define the duration in milliseconds (e.g., 10000 = 10 seconds).
  • Blip: Fully customize the map icon, color, and scale for each shop individually to help players find them easily.

Caution

Performance Note This script is optimized to run at 0.00ms while idle. To maintain this level of performance, avoid adding Wait(0) or heavy logic inside loops if you decide to modify the client-side code.

πŸ“– Documentation

πŸ†˜ Help & Support


Version: 1.0.0 Status: Stable

Clone this wiki locally