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 = trueWhen 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 (
SetVehicleModtype 11).