Repair & Replace Parts

📄 Config file: shared/repair_config.lua

This file defines all the repair and replacement actions a mechanic can perform on each vehicle part. Every part entry specifies the item required, duration, animation, and whether it's a partial repair or a full replacement.

Repair = partially restores the part's condition using a repair kit (cheaper, faster, but doesn't fully fix it). Replace = fully restores the part to brand new using a replacement part (more expensive, takes longer, but resets wear to 0).

---

Minigames & Failure Handling

📄 Config file: shared/repair_config.lua

All repair and installation actions are protected by a centralized minigame system. This ensures that while everyone can use repair tools, professional mechanics have a clear advantage.

Config.Minigames = {
    enabled = true,
    mechanicNeedsMinigame = false, -- Mechanics skip the minigame if false
    damageOnFail = true,
    failDamageAmount = 150.0, -- Amount of engine damage to apply on failure
}

Configuration Options

Option	What it does
enabled	Globally enable or disable minigames for all repairs/installs.
mechanicNeedsMinigame	If false, players with a registered mechanic job will skip the minigame.
damageOnFail	If true, failing a minigame damages the vehicle.
failDamageAmount	The amount of health to remove from the engine and body on failure.

---

Body Repair

Config.BodyRepair = {
    item     = 'body_repair_kit',
    duration = 5000,
    label    = 'Repairing Body...'
}

Setting	What it does
item	Inventory item required to perform the body repair.
duration	How long the repair takes in milliseconds. 5000 = 5 seconds.
label	The text shown on the progress bar during the repair.

This repairs the vehicle's exterior body damage (dents, scratches, deformation) — not individual parts.

---

Cleaning Kit (Wash)

📄 Config file: shared/animations.lua (for animations)

Config.CleaningKit = {
    Animation       = "base",
    AnimationDict   = "amb@world_human_maid_clean@",
    Duration        = 10000,
    Prop            = "prop_sponge_01",
    Bone            = 28422,
    Pos             = { x = 0.0, y = 0.0, z = -0.01 },
    Rot             = { x = 90.0, y = 0.0, z = 0.0 },
}

The cleaning kit uses a sponge prop and particle effects to wash the vehicle. A vehicle must have a dirt level of 0.0 before wax can be applied.

---

Tiered Repair Kits

📄 Config file: shared/repair_config.lua

Tiered repair kits (Standard, Advanced, Helicopter) provide a more flexible way to manage multi-part repairs.

Config.RepairKits = {
    ['repair_kit'] = {
        label = "Standard Repair Kit",
        duration = 10000,
        repaints = true, -- Repairs body damage
        repairs = { 'engine', 'oil', 'spark_plug' }, -- Repairable categories
        classes = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 } -- Allowed vehicle classes
    },
    -- ...
}

Configuration Options

Option	What it does
label	Name shown on the progress bar.
duration	Time in milliseconds to complete the repair.
repaints	If true, the kit will fix visual body damage.
repairs	List of part categories this kit can fix. Valid categories: engine, oil, spark_plug, air_filter, tires, brakes, suspension, clutch, gearbox, piston, radiator, fuel_pump, alternator, turbo.
classes	List of vehicle class IDs this kit is compatible with.

---

Part-by-Part Configuration

Each part listed in Config.RepairParts has the following structure:

Property	What it does
label	Display name of the part.
maxMileage	Maximum mileage this part supports before it needs replacement. Used as a reference value.
repair.item	The repair kit item needed for a partial repair.
repair.amount	How much condition is restored (out of 100). 25 = restores 25% condition.
repair.duration	Time in milliseconds for the repair action.
replace.item	The full replacement part item.
replace.count	How many of the item are consumed.
replace.duration	Time in milliseconds for the replacement action.

---

Spark Plugs

Action	Item	Count/Amount	Duration
Replace	spark_plugs	1	5 seconds

Spark plugs only support replacement (no partial repair).

---

Engine Oil

Action	Item	Count/Amount	Duration
Replace	engine_oil	1	10 seconds

Oil changes are full replacements — you always use a fresh bottle.

---

Oil Filter

Action	Item	Count/Amount	Duration
Replace	oil_filter	1	3 seconds

---

Air Filter

Action	Item	Count/Amount	Duration
Replace	air_filter	1	3 seconds

---

Tires

Action	Item	Count/Amount	Duration
Replace	tires	4 (full set)	5 seconds

Tire replacement always uses 4 items (one per wheel).

---

Brakes

Action	Item	Count/Amount	Duration
Repair (pad change)	brake_pads_repair	Restores 25%	6 seconds
Replace (full service)	brakeparts	1	10 seconds

---

Suspension

Action	Item	Count/Amount	Duration
Repair (service)	suspension_repair	Restores 25%	8 seconds
Replace	suspension_parts	1	12 seconds

---

Clutch

Action	Item	Count/Amount	Duration
Repair (adjust)	clutch_repair	Restores 20%	8 seconds
Replace	clutch	1	12 seconds

---

Gearbox

Action	Item	Count/Amount	Duration
Repair (service)	gearbox_repair_kit	Restores 20%	10 seconds
Replace	gearbox_parts	1	15 seconds

---

Radiator

Action	Item	Count/Amount	Duration
Repair (seal)	radiator_repair_kit	Restores 35%	6 seconds
Replace	radiator	1	10 seconds

---

Fuel Pump

Action	Item	Count/Amount	Duration
Repair (service)	fuel_pump_repair_kit	Restores 35%	6 seconds
Replace	fuel_pump	1	8 seconds

---

Alternator

Action	Item	Count/Amount	Duration
Repair (service)	alternator_repair_kit	Restores 35%	6 seconds
Replace	alternator_battery	1	8 seconds

---

Pistons

Action	Item	Count/Amount	Duration
Repair (service)	piston_repair_kit	Restores 15%	12 seconds
Replace	engine_pistons	1	20 seconds

Pistons are the most time-consuming parts to replace.

---

Turbo

Action	Item	Count/Amount	Duration
Repair (service)	turbo_repair_kit	Restores 50%	7 seconds
Replace	turbo_s2	1	10 seconds

All animation dictionaries and animations are also defined per-part in this config. You can change the animation played during any repair/replace action by editing the animation block in each entry.