⚙️Parts Config

Detailed explanations of configuration settings for vehicle parts and mechanics

Parts - 1

Parts - 2

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.

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

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.

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$

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$

Config.Parts.OilProblemsOilSpillageChance = 5

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

Config.Parts.OilProblemsFireChance = 200

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

---

Engine Operation and Degradation

Config.Parts.NotWarmedUpEngineDamageChance = 5

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

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$.

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.010

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

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.010

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

$800 < DrivenDistance < 1000$

Config.Parts.EarlyOilProblemsExtraEngineDegradation = 0.050

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

$1000 < DrivenDistance < 1200$

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

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

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

Config.Parts.BatteryWearEvery10XYZDistance = 0.015

Battery wear rate based on 10 units of distance travel.

Config.Parts.BatteryMalfunctionChance = 5

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

$150 > BatteryHealth$

Tyres

Config.Parts.TyreWearEvery10XYZDistance = 0.005

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

Config.Parts.TyreBurstChance = 5

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

$150 >TyreHealth$

Brakes

Config.Parts.BrakeWearEvery10XYZDistance = 0.003

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

Catalyst

Config.Parts.CatalystWearEvery10XYZDistance = 0.001,

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

Radiator

Config.Parts.RadiatorWearEvery10XYZDistance = 0.003,

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

---

Crash System

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)$

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

Config.Parts.RadiatorCrashChance = 30

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

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].

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].