Engine Stages

📄 Config file: shared/engine_config.lua

This file controls the engine upgrade system — from opening loot boxes to crafting performance engines. There are three tiers of engines, each providing more power but wearing out faster.

---

Additional Performance Toggle

Config.EnableAdditionalPerformance = true

When true, installing a performance engine applies extra multipliers beyond just changing the native GTA engine mod level. This means Stage 2 and Stage 3 engines genuinely make the car faster, not just change the mod index. Set to false if you only want the native mod level change.

---

Engine Boxes (Loot Crates)

Engine Boxes are items that mechanics can open to receive random crafting components. Each tier of box drops different quality parts.

Stage 1 Engine Box (engine_box_tier1)

Possible Drop	Chance	Amount
Piston (S1)	40%	1–2
Crankshaft (S1)	20%	1
Valves (S1)	40%	1–2

Stage 2 Engine Box (engine_box_tier2)

Possible Drop	Chance	Amount
Piston (S2)	30%	1–2
Crankshaft (S2)	20%	1
Valves (S2)	30%	1–2
Turbo (S2)	20%	1

Stage 3 Engine Box (engine_box_tier3)

Possible Drop	Chance	Amount
Piston (S3)	25%	1–2
Crankshaft (S3)	15%	1
Valves (S3)	25%	1–2
Supercharger (S3)	35%	1

The chance values are relative weights, not absolute percentages. When opening a box, one item is rolled from the loot table using these weights.

---

Engine Stages (Crafted Engines)

Once a mechanic collects enough components from engine boxes, they can craft a complete performance engine. Each stage has a recipe, stat bonuses, and a native mod level.

Stage 1 — Performance Engine

Property	Value
Item	engine_stage1
Recipe	4× Piston S1, 1× Crankshaft S1, 1× Valves S1
Power Multiplier	1.1× (10% more power)
Wear Rate Multiplier	1.1× (10% faster wear)
Durability	2.0 km/miles
Native Mod Level	0 (Engine Level 1)

Stage 2 — Performance Engine

Property	Value
Item	engine_stage2
Recipe	4× Piston S2, 1× Crankshaft S2, 1× Valves S2, 1× Turbo S2
Power Multiplier	1.25× (25% more power)
Wear Rate Multiplier	1.3× (30% faster wear)
Durability	1.0 km/miles
Native Mod Level	1 (Engine Level 2)

Stage 3 — Performance Engine

Property	Value
Item	engine_stage3
Recipe	4× Piston S3, 1× Crankshaft S3, 1× Valves S3, 1× Supercharger S3
Power Multiplier	1.5× (50% more power)
Wear Rate Multiplier	1.6× (60% faster wear)
Durability	2.0 km/miles
Native Mod Level	3 (Engine Level 4)

Higher stage engines are significantly more powerful but wear out much faster. Mechanics will need to service these vehicles more frequently — this creates ongoing business for mechanic shops.

Key terms:

• Power Multiplier — How much extra engine power is applied. 1.5 = 50% more powerful than stock.

• Wear Rate Multiplier — How much faster all engine-related parts wear. 1.6 = parts wear 60% faster.

• Durability — A general durability rating in km/miles.

• Native Mod Level — The GTA V mod index applied when the engine is installed (SetVehicleMod type 11).