Max/Main
1
0
Fork 0
Code Pull requests Activity
Main/resources/[jobs]/[mechanic]/jg-mechanic/config/config.tuning.lua
root d84b6e12fd first Commit
2025-06-07 08:51:21 +02:00

325 lines
No EOL
12 KiB
Lua
Raw Blame History

-----------------------------------------------------------------------------------------------------------
-------------------------------------------- VEHICLE TUNING -----------------------------------------------
-----------------------------------------------------------------------------------------------------------
--
-- Here you can create, edit and remove various tuning parts. The changes they make to the handling is all
-- in here, so feel free to modify as you wish. PLEASE bear in mind that if 2 different tuning options
-- modify the same handling values, and are set to overwrite, they could overwrite each other unpredictably
-- Either set the values to NOT overwrite, or make sure that different tuning parts modify unique parts of
-- the handling to prevent undesired results.
--
-- Here is a guide on what different options mean to help you customise your tuning parts.
--
-----------------------------------------------------------------------------------------------------------
-- name The name of the modification that will be shown in the tablet.
-----------------------------------------------------------------------------------------------------------
-- info Optional, but you can provide additional info that will show in the UI when
-- clicking the info icon when they are selecting an upgrade. It could be used
-- to warn mechanics of vehicles an upgrade shouldn't be applied on, or results
-- from your testing of handling values.
-----------------------------------------------------------------------------------------------------------
-- itemName For mechanics set up to use an item for upgrades, this is the name of the
-- required item.
-----------------------------------------------------------------------------------------------------------
-- price For mechanics set up to purchase upgrades, this will be the cost to the
-- mechanic to apply the upgrade.
-----------------------------------------------------------------------------------------------------------
-- audioNameHash Any in-game vehicle name, or addon sound pack name (ENGINE SWAPS ONLY!)
-----------------------------------------------------------------------------------------------------------
-- handling Add/remove handling attributes & values.
-- More help & info on handling values: https://gtamods.com/wiki/Handling.meta
-----------------------------------------------------------------------------------------------------------
-- handlingApplyOrder The order in which this tuning option should be applied. This is useful when
-- tuning options have overlapping handling values! Provide a priority number,
-- and the lowest numbers will be applied first.
-----------------------------------------------------------------------------------------------------------
-- handlingOverwritesValues Whether the handling values provided should overwrite the vehicle's existing
-- values, or whether they should modify the vehicle's existing values. This
-- also works for negative values too.
--
-- For example: a vehicle's current fDriveInertia value is at 1.0
-- true = a value of 0.5 sets fDriveInertia to 0.5
-- false = a value of 0.5 will mean [1.0 + 0.5] and set fDriveInertia to 1.5
-----------------------------------------------------------------------------------------------------------
-- restricted (optional) Can either be false (unrestricted) "electric" or "combustion"
-----------------------------------------------------------------------------------------------------------
-- blacklist List of archetype names (spawn codes) that cannot use this modification
-----------------------------------------------------------------------------------------------------------
-- minGameBuild Functionality restricted to a certain game build, such as manual gearboxes
-----------------------------------------------------------------------------------------------------------
Config.Tuning = {
--
-- ENGINE SWAPS
-- You can customise, or add new engine swap options here.
--
engineSwaps = {
[1] = {
name = "I4 Turbo 2.5L",
icon = "engine.svg",
info = "A twin-turbo charged 2.5L engine. Can reach speeds of up to 100mph!",
itemName = "i4_engine",
price = 30000,
audioNameHash = "sultan2",
handlingOverwritesValues = true,
handlingApplyOrder = 1,
handling = {
fInitialDriveForce = 0.25,
fDriveInertia = 1.0,
fInitialDriveMaxFlatVel = 130.0,
fClutchChangeRateScaleUpShift = 4.0,
fClutchChangeRateScaleDownShift = 3.0
},
restricted = "combustion",
},
[2] = {
name = "V6 3.3L",
icon = "engine.svg",
audioNameHash = "comet4",
info = "Tuned V6 engine - capable of speeds up to 120mph.",
itemName = "v6_engine",
price = 45000,
handlingOverwritesValues = true,
handlingApplyOrder = 1,
handling = {
fInitialDriveForce = 0.35,
fDriveInertia = 1.0,
fInitialDriveMaxFlatVel = 145.0,
fClutchChangeRateScaleUpShift = 5.0,
fClutchChangeRateScaleDownShift = 4.0
},
restricted = "combustion",
},
[3] = {
name = "V8 6.5L",
icon = "engine.svg",
info = "Naturally aspirated 6.5L V8. Has awesome backfires and a crackling sound as you let off the gas. Sure to impress.",
itemName = "v8_engine",
price = 65000,
audioNameHash = "jugular",
handlingOverwritesValues = true,
handlingApplyOrder = 1,
handling = {
fInitialDriveForce = 0.45,
fDriveInertia = 1.0,
fInitialDriveMaxFlatVel = 160.0,
fClutchChangeRateScaleUpShift = 7.0,
fClutchChangeRateScaleDownShift = 6.0
},
restricted = "combustion",
},
[4] = {
name = "V12 6.0L",
icon = "engine.svg",
info = "A huge 6L V12 monster. Can reach speeds of over 130mph, be realistic and only put this in vehicles that could realistically fit a V12.",
itemName = "v12_engine",
price = 80000,
audioNameHash = "schafter3",
handlingOverwritesValues = true,
handlingApplyOrder = 1,
handling = {
fInitialDriveForce = 0.5,
fDriveInertia = 1.0,
fInitialDriveMaxFlatVel = 180.0,
fClutchChangeRateScaleUpShift = 6.0,
fClutchChangeRateScaleDownShift = 5.0
},
restricted = "combustion",
blacklist = {"panto"} -- Example of the blacklist feature - feel free to remove this (it couldn't fit a v12 though man, come on)
}
},
--
-- TYRES
-- You can customise, or add new tyre options here.
--
tyres = {
[1] = {
name = "Slicks",
icon = "wheels/offroad.svg",
info = false,
itemName = "slick_tyres",
price = 25000,
handlingOverwritesValues = true,
handlingApplyOrder = 2,
handling = {
fTractionCurveMin = 2.8,
fTractionCurveMax = 3.0
},
},
[2] = {
name = "Semi-slicks",
icon = "wheels/offroad.svg",
info = false,
itemName = "semi_slick_tyres",
price = 25000,
handlingOverwritesValues = true,
handlingApplyOrder = 2,
handling = {
fTractionCurveMin = 2.4,
fTractionCurveMax = 2.6
},
},
[3] = {
name = "Offroad",
icon = "wheels/offroad.svg",
info = false,
itemName = "offroad_tyres",
price = 25000,
handlingOverwritesValues = true,
handlingApplyOrder = 2,
handling = {
fTractionLossMult = 0.0
},
}
},
--
-- BRAKES
-- You can customise, or add new tyre options here.
--
brakes = {
[1] = {
name = "Ceramic",
icon = "brakes.svg",
info = "Powerful brakes with an immense stopping power",
itemName = "ceramic_brakes",
price = 25000,
handlingOverwritesValues = true,
handlingApplyOrder = 3,
handling = {
fBrakeForce = 1.5
},
}
},
--
-- DRIVETRAINS
-- You can customise, or add new drivetain options here.
--
drivetrains = {
[1] = {
name = "AWD",
icon = "drivetrain.svg",
info = false,
itemName = "awd_drivetrain",
price = 50000,
handlingOverwritesValues = true,
handlingApplyOrder = 4,
handling = {
fDriveBiasFront = 0.5
},
},
[2] = {
name = "RWD",
icon = "drivetrain.svg",
info = false,
itemName = "rwd_drivetrain",
price = 50000,
handlingOverwritesValues = true,
handlingApplyOrder = 4,
handling = {
fDriveBiasFront = 0.0
},
},
[3] = {
name = "FWD",
icon = "drivetrain.svg",
info = false,
itemName = "fwd_drivetrain",
price = 50000,
handlingOverwritesValues = true,
handlingApplyOrder = 4,
handling = {
fDriveBiasFront = 1.0
},
}
},
--
-- TURBOCHARGING
-- Note: This category is unique as it just enables/disables mod 18 (the standard GTA turbocharging option)
-- You can't add additional turbocharging options, you can only adjust/remove the existing one.
-- You can't add any handling changes. Make new items/other categories for that.
--
turbocharging = {
[1] = {
name = "Turbocharging",
icon = "turbo.svg",
info = false,
itemName = "turbocharger",
price = 35000,
restricted = "combustion",
}
},
--
-- DRIFT TUNING
-- You can't add additional drift tuning options, you can only adjust/remove the existing one.
--
driftTuning = {
[1] = {
name = "Drift Tuning",
icon = "wheels/tuner.svg",
info = false,
itemName = "drift_tuning_kit",
price = 25000,
handlingOverwritesValues = true,
handlingApplyOrder = 5,
handling = {
fInitialDragCoeff = 12.22,
fInitialDriveForce = 3.0,
fInitialDriveMaxFlatVel = 155.0,
fSteeringLock = 58.0,
fTractionCurveMax = 0.6,
fTractionCurveMin = 1.3,
fTractionCurveLateral = 21.0,
fLowSpeedTractionLossMult = 0.5,
fTractionBiasFront = 0.49
},
}
},
--
-- GEARBOX (b3095 or newer)
-- This is a unique category that updates flags, via the boolean 'manualGearbox' option.
-- This allows you to toggle manual gearing, where the player must change gears themselves.
-- Learn more: https://docs.jgscripts.com/mechanic/manual-transmissions-and-smooth-first-gear
--
gearboxes = {
[1] = {
name = "Manual Gearbox",
icon = "transmission.svg",
info = false,
itemName = "manual_gearbox",
price = 10000,
manualGearbox = true,
restricted = "combustion",
minGameBuild = 3095
}
}
--
-- EXAMPLE CUSTOM NEW CATEGORY
--
-- ["Transmissions"] = {
-- [1] = {
-- name = "8 speed transmission",
-- icon = "transmission.svg",
-- info = "Testing making a new category",
-- itemName = "transmission",
-- price = 1000,
-- handlingOverwritesValues = true,
-- handling = {
-- nInitialDriveGears = 8
-- },
-- restricted = false,
-- }
-- }
--
-- -- IMPORTANT NOTE --
-- inside of the config.lua, inside of a mechanic location's "tuning" section, you will need to add an
-- additional line in order for it to show & be enabled in the tablet
--
-- ["Transmissions"] = { enabled = true, requiresItem = false },
}
View git blame Copy permalink