Parts Config

Detailed explanations of configuration settings for vehicle parts and mechanics

Parts - 1

Parts - 2

Danger

Config.UseParts = true

Toggles the vehicle parts system. Keep in mind disabling them only removes effects and loops for it. We will soon be adding more code to remove unnecessary loops and if statements being sent over.

Note

Config.Parts.MetricSystem = "KM"

Toggle between “KM” (kilometers) and “MP” (miles) to set the measurement system for vehicle distances. This setting determines how distances like oil change intervals or damage calculations are displayed and calculated.

---

Engine Maintenance and Damage

Note

Config.Parts.OilChange = 1000

Defines the distance interval (in KM or miles, based on MetricSystem)after which an oil change is needed for the vehicle. For example, setting this to 1000 means the vehicle requires an oil change every 1000 units of distance traveled.

Note

Config.Parts.EarlyOilProblems = 200

Distance before the recommended oil change interval at which minor engine problems may start occurring. For instance, if set to 200 and OilChange is 1000, problems may start at 800.

$$800 < DrivenDistance < 1000$$

Note

Config.Parts.LateOilProblems = 200

Distance after the oil change interval when severe engine issues can occur, such as oil spillage, overheating, or even vehicle explosion due to extreme conditions. For instance, if set to 200 and OilChange is 1000, problems may start at 1200.

$$1200 < DrivenDistance$$

Note

Config.Parts.OilProblemsOilSpillageChance = 5

Probability (in %) of oil spillage occurring after the LateOilProblems threshold is crossed.

Note

Config.Parts.OilProblemsFireChance = 200

Probability (in %) of the vehicle catching fire under the same conditions as above.

---

Engine Operation and Degradation

Note

Config.Parts.NotWarmedUpEngineDamageChance = 5

Chance of severe engine damage if the vehicle is driven hard without proper warm-up. Applies to high RPM scenarios.

Caution

Config.Parts.EngineDegradation1stPhaseRPM = 0.50
Config.Parts.EngineDegradation1stPhaseValue = 0.005

Config.Parts.EngineDegradation2ndPhaseRPM = 0.65
Config.PartsEngineDegradation2ndPhaseValue = 0.025

Config.Parts.EngineDegradation1stPhaseRPM = 0.80
Config.Parts.EngineDegradation1stPhaseValue = 0.050

This setting includes the RPM phases. We include 3 different phases. For each phase we the damage rate.

For instance the second phase is triggered when the RPM’s are between $$0.65 < rpm < 0.80$$.

The damage rate for the second phase is currently 0.025 per second.

Keep in mind RPM phases can be adjusted between $$0.00 < rpm < 0.99$$.

Note

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.010

Additional engine damage per unit time if oil change is overdue, during the early stage.

Note

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.010

Additional engine damage per unit time if oil change is overdue, during the early stage.

$$800 < DrivenDistance < 1000$$

Note

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.050

Additional engine damage per unit time during the medium stage of oil change delay.

$$1000 < DrivenDistance < 1200$$

Note

Config.Parts.LateOilProblemsExtraEngineDegradation = 0.500

Severe extra engine damage per unit time when oil change is significantly overdue.

$$1200 < DrivenDistance$$

---

Other Parts Degradation and Effects

Fuel Tank

Note

Config.Parts.FuelRemovalSmall = { [1] = 1.8, [2] = 2.7 },
Config.Parts.FuelRemovalLarge = { [1] = 2.2, [2] = 4.4 },

These settings are responsible for the fuel leaking rates, these are deducted per second. The value is a randomized float between [1] and [2].

FuelRemovalSmall: $$400 > FuelTankHealth > 150$$

FuelRemovalLarge: $$150 > FuelTankHealth$$

Gearbox

Note

Config.Parts.EarlyGearboxProblemsChance = 5

Chance of gearbox issues, like getting stuck, especially when the gearbox reaches at the early problems phase.

$$400 > GearboxHealth > 150$$

Battery

Note

Config.Parts.BatteryWearEvery10XYZDistance = 0.015

Battery wear rate based on 10 units of distance travel.

Note

Config.Parts.BatteryMalfunctionChance = 5

Probability of battery-related issues after the battery reaches the malfunction phase.

$$150 > BatteryHealth$$

Tyres

Note

Config.Parts.TyreWearEvery10XYZDistance = 0.005

Rate at which tyres wear down over 10 units of distance travel.

Note

Config.Parts.TyreBurstChance = 5

Probability of a tyre burst under certain conditions, especially when wear is extensive.

$$150 >TyreHealth$$

Brakes

Note

Config.Parts.BrakeWearEvery10XYZDistance = 0.003

Rate at which brakes wear down over 10 units of distance travel.

Catalyst

Note

Config.Parts.CatalystWearEvery10XYZDistance = 0.001,

Rate at which the catalyst wears down over 10 units of distance travel.

Radiator

Note

Config.Parts.RadiatorWearEvery10XYZDistance = 0.003,

Rate at which the radiator wears down over 10 units of distance travel.

---

Crash System

Note

Config.Parts.BodyHealthLostToBeConsideredAsSmallCrash = 10

Threshold of body health loss to classify an impact as a small crash.

$$if(oldBodyHealth - 10 > newBodyHealth) and(oldBodyHealth - 20 < newBodyHealth)$$

Note

Config.Parts.BodyHealthLostToBeConsideredAsBigCrash = 20,

Threshold of body health loss to classify an impact as a big crash.

$$if(oldBodyHealth - 20 > newBodyHealth)$$

Parts Crash Multipliers

Example

Caution

Config.Parts.RadiatorCrashChance = 30

Probability of the radiator taking damage in a SMALL crash. Big crashes will always cause damage to the part!

Caution

Config.Parts.RadiatorCrashMultiplier = { [1] = 100, [2] = 200 }

Damage multiplier for radiator in a SMALL crash. The value is a randomized float between [1] and [2].

Caution

Config.Parts.RadiatorBigCrashMultiplier = {[1] = 300, [2] = 500}

Damage multiplier for radiator in a BIG crash. The value is a randomized float between [1] and [2].