Turbo System

📄 Config file: shared/turbo_config.lua

This file configures the four turbocharger stages available in the script. Each stage offers a different balance of power boost vs. durability — bigger turbos give more power but wear out faster and need more attention.

---

Turbo Stages

Stage 1 — 27mm Turbocharger

Property	Value
Item	turbo_27mm
Boost	+15% power
Durability	3.0 km/miles
Wear Rate	1.0× (standard)
RPM Threshold	0.75 (75% RPM)

A mild street turbo. Good for daily drivers — minimal maintenance required.

---

Stage 2 — 35mm Turbocharger

Property	Value
Item	turbo_35mm
Boost	+30% power
Durability	2.5 km/miles
Wear Rate	1.2× (20% faster)
RPM Threshold	0.70 (70% RPM)

A performance turbo for sports cars. Noticeable power increase with manageable wear.

---

Stage 3 — 42mm Turbocharger

Property	Value
Item	turbo_42mm
Boost	+45% power
Durability	2.0 km/miles
Wear Rate	1.5× (50% faster)
RPM Threshold	0.65 (65% RPM)

A high-performance turbo for track cars. Significant power but requires frequent servicing.

---

Stage 4 — 52mm Racing Turbo

Property	Value
Item	turbo_52mm
Boost	+65% power
Durability	1.2 km/miles
Wear Rate	2.0× (double wear)
RPM Threshold	0.60 (60% RPM)

A full racing turbo. Massive power gains but extremely high maintenance. Expect frequent turbo replacements.

The 52mm Racing Turbo wears twice as fast as a standard turbo. Mechanics should advise customers that this is a high-maintenance upgrade.

---

How Turbo Stats Work

Property	Explanation
boostMult	Multiplier applied to the vehicle's engine power. 1.30 = 30% more powerful.
durability	General durability rating in km/miles. Lower number = needs replacing sooner.
wearRateMult	Multiplier for how fast the turbo wears. 2.0 means it wears twice as fast as baseline.
rpmThreshold	The RPM level (0.0–1.0 scale) above which the turbo's dynamic wear kicks in. Below this RPM, the turbo only takes the slow base wear. Above it, wear accelerates significantly.

---

Turbo Repair Kit

Config.TurboRepairKit    = "turbo_repair_kit"
Config.TurboRepairAmount = 25.0

Setting	What it does
TurboRepairKit	The inventory item used to repair a worn turbo.
TurboRepairAmount	How much condition is restored per kit. 25.0 = restores 25% of the turbo's condition.