# Config Settings

#### **🔧 FRKN-Tuning | Ultimate Vehicle Customization System 🚗**

With **FRKN-Tuning**, you have complete control over your vehicle’s performance! Adjust **50+ handling settings** and fine-tune every detail, from suspension to acceleration. Whether you're a racer, drifter, or just looking for a smoother ride, this system gives you the ultimate tuning experience.

***

#### **⚙️ Key Bindings**

🎛 **Tablet Key:** `F3` – Open the tuning tablet instantly.\
🔄 **Mode Switch Key:** `F4` – Quickly toggle between tuning modes.

```lua
TabletKey = "F3",
ModeKey = "F4",
```

***

#### **📦 Essential Items**

🛠️ **Tuning Tablet:** `tuning_tablet` – Your gateway to advanced handling customization.\
🚓 **Police Tablet:** `police_tablet` – Used by officers to inspect vehicle modifications.\
💾 **Tuning USB:** `usb_tuning` – Save your custom settings and apply them to other vehicles.\
🔧 **Suspension Controller:** `suspension_controller` – Modify suspension height for off-road or performance tuning.

***

#### **🔐 Job Restrictions (Optional)**

Want only mechanics and police to access certain features? Enable **JobController** to limit access!

🔹 **Police Access:** `police` – Only officers can use the police tablet.\
🔹 **Mechanic Access:** `mechanic` – Only mechanics can access the tuning tablet.

```lua
JobController = true, -- Enable job restriction (true/false)

Job = {
    ["police"] = {'police'}, -- Jobs that can access the police tablet.
    ["tablet"] = {'mechanic'} -- Jobs that can access the tuning tablet.
}
```

***

#### **⚙️ Handling Categories & Settings**

**🔹 Base Adjustments *****(General Performance Settings)***

* **Acceleration:** Adjusts how quickly the car picks up speed.
* **Braking:** Modifies braking strength for improved stopping power.
* **Suspension:** Changes vehicle ride height (lower or higher).
* **Traction:** Increases or decreases wheel grip on the road.

```lua
base = {
	acceleration = { min = 0.1, max = 5.0, default = 1.0, step = 0.1, name = "fInitialDriveForce",
		description = "Determines how quickly the car accelerates. Higher values provide more power to the wheels." },
	braking = { min = 0.1, max = 5.0, default = 1.2, step = 0.1, name = "fBrakeForce",
		description = "Determines how quickly the vehicle slows down when braking." },
	suspension = { min = -0.5, max = 0.5, default = 0.0, step = 0.1, name = "fSuspensionRaiseFront",
		description = "Adjusts the height of the vehicle. Negative values lift the car, positive values lower it." },
	traction = { min = 0.0, max = 0.5, default = 0.3, step = 0.1, name = "fTractionCurveMax",
		description = "Determines the grip level of the vehicle. Higher values increase traction." }
}
```

***

**⚡ Engine Adjustments**

* **Drive Force:** Adjusts acceleration force.
* **Drive Inertia:** Controls vehicle response to speed changes.
* **Clutch Change Rate:** Affects how quickly the car shifts gears.
* **Oil Volume:** Determines the oil capacity for the engine.
* **Air Resistance:** Impacts the vehicle’s top speed.

```lua
engine = {
	initialDriveForce = { min = 0.1, max = 3.0, default = 0.35, step = 0.1, name = "fInitialDriveForce",
		description = "Determines the engine's acceleration force. Higher values result in faster acceleration." },
	driveInertia = { min = 0.1, max = 10.0, default = 1.0, step = 0.1, name = "fDriveInertia",
		description = "Controls the vehicle's response to speed changes. Higher values slow down gear shifts." },
	clutchChangeRateUp = { min = 0.1, max = 10.0, default = 1.5, step = 0.1, name = "fClutchChangeRateScaleUpShift",
		description = "Controls the speed of upshifting gears. Higher values allow faster gear changes." },
	clutchChangeRateDown = { min = 0.1, max = 10.0, default = 1.5, step = 0.1, name = "fClutchChangeRateScaleDownShift",
		description = "Controls the speed of downshifting gears. Higher values allow faster downshifts." },
	oilVolume = { min = 1.0, max = 10.0, default = 7.0, step = 0.1, name = "fOilVolume",
		description = "Determines the engine's oil capacity. No direct impact on driving physics." },
	airResistance = { min = 0.1, max = 10.0, default = 2.5, step = 0.1, name = "fAirResistance",
		description = "Determines air resistance. Lower values result in higher top speeds." }
}
```

***

**🛑 Braking Adjustments**

* **Brake Force:** Controls how fast the car slows down.
* **Handbrake Force:** Adjusts handbrake strength.
* **Brake Bias:** Defines front/rear brake balance.

```lua
brakes = {
	brakeForce = { min = 0.1, max = 10.0, default = 1.2, step = 0.1, name = "fBrakeForce",
		description = "Determines braking force. Higher values allow the car to stop faster." },
	handBrakeForce = { min = 0.1, max = 10.0, default = 1.5, step = 0.1, name = "fHandBrakeForce",
		description = "Determines the strength of the handbrake. Higher values make it more effective." },
	brakeBiasFront = { min = 0.0, max = 1.0, default = 0.5, step = 0.05, name = "fBrakeBiasFront",
		description = "Determines front/rear brake force distribution. 0.0 is full rear brakes, 1.0 is full front brakes." }
}
```

***

**🛞 Suspension & Wheel Adjustments**

* **Camber:** Adjusts wheel angle for improved handling.
* **Toe:** Controls wheel alignment.
* **Suspension Height:** Lifts or lowers the vehicle.

```lua
suspension = {
	suspensionValue = { min = -0.5, max = 0.5, default = 0.0, step = 0.1, name = "fSuspensionRaiseFront",
		description = "Controls front suspension height. Negative values raise the vehicle." },
	camberFront = { min = -25.0, max = -10.50, default = 0.0, step = 0.1, name = "fCamberFront",
		description = "Controls the inward or outward angle of front wheels. Negative values tilt them inward." },
	camberRear = { min = -25.0, max = -10.50, default = 0.0, step = 0.1, name = "fCamberRear",
		description = "Controls the inward or outward angle of rear wheels. Negative values tilt them inward." },
	toeFront = { min = -2.0, max = 2.0, default = 0.0, step = 0.05, name = "fToeFront",
		description = "Controls the front wheel angle. Positive values point them outward." },
	toeRear = { min = -2.0, max = 2.0, default = 0.0, step = 0.05, name = "fToeRear",
		description = "Controls the rear wheel angle. Positive values point them outward." }
}
```

***

#### **🚗 Preset Tuning Modes**

Quickly switch between **Sport, Drift, Normal, and Drag** tuning modes for optimized performance!

```lua
handlingPresets = {
	["sport"] = { fInitialDragCoeff = 8.0, fInitialDriveForce = 0.35, fBrakeForce = 1.2, fSteeringLock = 40.0 },
	["drift"] = { fInitialDragCoeff = 0.5, fInitialDriveForce = 0.25, fBrakeForce = 0.3, fSteeringLock = 65.0 },
	["normal"] = { fInitialDragCoeff = 10.0, fInitialDriveForce = 0.32, fBrakeForce = 1.0, fSteeringLock = 35.0 },
	["drag"] = { fInitialDragCoeff = 1.0, fInitialDriveForce = 0.5, fBrakeForce = 0.8, fSteeringLock = 20.0 }
}
```

***

#### **🔥 What You Can Do With FRKN-Tuning?**

✅ Adjust **over 50 handling settings** for **ultimate performance**.\
✅ Save and apply tuning setups **instantly** with a **USB**.\
✅ Customize **engine power, braking force, suspension, wheels, and more**.\
✅ **Switch between performance modes** with **one click**.\
✅ **Avoid police detection** by keeping your modifications in check!

***

🚀 **Take full control of your vehicle and fine-tune it to perfection!** 🔧🔥