chore(classes): add CTransmission

- Add CTransmission class to CVehicle.
- Add more stuff to `ManualGearbox`.

Author: xesdoog

SSV2/includes/classes/Set.lua

@@ -73,7 +73,7 @@ function Set:Clear()
 	self.m_data = {}
 end
 
----@param element T
+---@param element any
 ---@return boolean
 function Set:Contains(element)
 	return self.m_data[element] == true

SSV2/includes/classes/gta/CTransmission.lua

@@ -0,0 +1,94 @@
+-- Copyright (C) 2026 SAMURAI (xesdoog) & Contributors.
+-- This file is part of Samurai's Scripts.
+--
+-- Permission is hereby granted to copy, modify, and redistribute
+-- this code as long as you respect these conditions:
+--	* Credit the owner and contributors.
+--	* Provide a copy of or a link to the original license (GPL-3.0 or later); see LICENSE.md or <https://www.gnu.org/licenses/>.
+
+
+local CStructView = require("includes.classes.gta.CStructView")
+
+
+--------------------------------------
+-- Class: CTransmission
+--------------------------------------
+---@class CTransmission
+---@field public m_current_gear pointer<uint8_t>
+---@field public m_previous_gear pointer<uint8_t>
+---@field public m_top_gear pointer<uint8_t>
+---@field public m_gear_ratios array<pointer<float>>
+---@field public m_drive_force pointer<float>
+---@field public m_drive_max_flat_velocity pointer<float>
+---@field public m_drive_max_velocity pointer<float>
+---@field public m_throttle_unk pointer<float> -- not sure what this does but I managed to force revs using only this offset. it worked once then stopped doing anything
+---@field public m_rpm pointer<float>
+---@field public m_rpm_2 pointer<float>
+---@field public m_clutch pointer<float> cvehicle + 0x08D4
+---@field public m_throttle pointer<float> these two might be flipped
+---@field public m_throttle_input pointer<float> //
+---@field public m_boost_pressure pointer<float> m_throttle_input + 16 ? TODO: fix this it's wrong. this keeps incrementing when throttle is held and resets to 0 when released. pressure does not infinitely accumulate but this does
+---@overload fun(ptr: pointer): CTransmission
+local CTransmission = CStructView("CTransmission")
+
+---@param ptr pointer
+---@return CTransmission
+function CTransmission.new(ptr)
+	---@diagnostic disable-next-line
+	local instance                     = setmetatable({ m_ptr = ptr, }, CTransmission)
+	instance.m_current_gear            = ptr:add(0x0000)
+	instance.m_previous_gear           = ptr:add(0x0002)
+	instance.m_top_gear                = ptr:add(0x0006)
+	instance.m_drive_force             = ptr:add(0x0038)
+	instance.m_drive_max_flat_velocity = ptr:add(0x003C)
+	instance.m_drive_max_velocity      = ptr:add(0x0040)
+	instance.m_throttle_unk            = ptr:add(0x0044)
+	instance.m_rpm                     = ptr:add(0x0048)
+	instance.m_rpm_2                   = ptr:add(0x004C)
+	instance.m_clutch                  = ptr:add(0x0054)
+	instance.m_throttle                = ptr:add(0x0058)
+	instance.m_throttle_input          = ptr:add(0x0060)
+	instance.m_boost_pressure          = ptr:add(0x0070)
+
+
+	local gearRatios  = {} ---@type array<pointer<float>>
+	local pArrayStart = ptr:add(0x000C)
+	for i = 0, 10 do -- reverse + 10 fwd gears
+		gearRatios[i + 1] = pArrayStart:add(i * 0x4)
+	end
+	instance.m_gear_ratios = gearRatios
+
+	return instance
+end
+
+---@param gear uint8_t
+---@return float
+function CTransmission:GetRatioForGear(gear)
+	local ptr = self.m_gear_ratios[gear + 1]
+	if (not ptr or ptr:is_null()) then
+		return 0.0
+	end
+
+	return ptr:get_float()
+end
+
+---@param gear uint8_t
+---@param ratio float
+function CTransmission:SetRatioForGear(gear, ratio)
+	local ptr = self.m_gear_ratios[gear + 1]
+	if (not ptr or ptr:is_null()) then return end
+	ptr:set_float(ratio)
+end
+
+---@param gear uint8_t
+---@return float
+function CTransmission:GetMaxSpeedForGear(gear)
+	local max_drive_vel = self.m_drive_max_velocity:get_float()
+	local gear_ratio    = math.abs(self:GetRatioForGear(gear))
+	if (gear_ratio == 0) then
+		return 0.0
+	end
+	return max_drive_vel / gear_ratio
+end
+
+return CTransmission

SSV2/includes/classes/gta/CVehicle.lua

@@ -14,10 +14,10 @@ local CHandlingData     = require("includes.classes.gta.CHandlingData")
 local CEntity           = require("includes.classes.gta.CEntity")
 local CVehicleDrawData  = require("includes.classes.gta.CVehicleDrawData")
 local CVehicleModelInfo = require("includes.classes.gta.CVehicleModelInfo")
+local CTransmission     = require("includes.classes.gta.CTransmission")
 local CWheel            = require("includes.classes.gta.CWheel")
 local fMatrix44         = require("includes.classes.gta.fMatrix44")
 local phFragInst        = require("includes.classes.gta.phFragInst")
-local CCarHandlingData  = require("includes.classes.gta.CCarHandlingData")
 
 
 ---@class CAdvancedData
@@ -30,26 +30,22 @@ local CCarHandlingData  = require("includes.classes.gta.CCarHandlingData")
 ---@ignore
 ---@class CVehicle : CEntity
 ---@field protected m_ptr pointer
----@field public m_physics_fragments phFragInst //0x0030 `struct rage::phFragInst`
 ---@field public m_draw_data CVehicleDrawData
 ---@field public m_handling_data CHandlingData
 ---@field public m_model_info CVehicleModelInfo
 ---@field public m_vehicle_damage pointer<CVehicleDamage>
 ---@field public m_can_boost_jump pointer<byte> `bool`
 ---@field public m_velocity pointer<vec3>
+---@field public m_transmission CTransmission
 ---@field public m_deform_god pointer<uint8_t>
+---@field public m_frag_inst phFragInst //0x09C0 `fragInstGTA`
+---@field public m_turbo pointer<float>
 ---@field public m_water_damage pointer<uint32_t>
----@field public m_next_gear pointer<uint8_t>
----@field public m_current_gear pointer<uint8_t>
----@field public m_top_gear pointer<uint8_t>
----@field public m_rpm pointer<float>
----@field public m_rpm_2 pointer<float>
----@field public m_clutch pointer<float> // 0x08D4
----@field public m_throttle pointer<float> -- these two might be flipped
----@field public m_throttle_input pointer<float> //
 ---@field public m_engine_health pointer<float>
----@field public m_steering_input pointer<float> // 0x00D4 name might not correctly reflect what this actually is but this seems to store controller input (value is between 0.99 (left) .. -0.99 (right))
----@field public m_current_steering pointer<float> 0x00DC // actual wheel steer. Wr'll use it to rewrite last known wheel steer after exiting a vehicle in IV-Style Exit so we'll no longer need to teleport outside or patch CTaskVehicleExit
+---@field public m_steering_input pointer<float> // 0x00D4 name might not correctly reflect what this actually is but this seems to store controller input (value is between 1.0 (left) .. -1.0 (right))
+---@field public m_steering_angle pointer<float> 0x00DC // steering angle?. We'll use it to rewrite last known steering value after exiting a vehicle in IV-Style Exit so we'll no longer have to teleport outside or patch CTaskVehicleExit
+---@field public m_throttle_power pointer<float> m_steering_angle + 0x8
+---@field public m_brake_power pointer<float>
 ---@field public m_is_targetable pointer<byte> `bool`
 ---@field public m_door_lock_status pointer<uint32_t>
 ---@field public m_wheels atArray<CWheel> -- 0x0C30
@@ -71,35 +67,32 @@ function CVehicle:init(vehicle)
 	local instance = setmetatable({}, CVehicle)
 	instance:super().init(instance, vehicle)
 
-	local ptr                    = memory.handle_to_ptr(vehicle)
-	instance.m_ptr               = ptr
-	instance.m_model_info        = CVehicleModelInfo(ptr:add(0x0020):deref())
-	instance.m_water_damage      = ptr:add(0x00D8)
-	instance.m_physics_fragments = phFragInst(ptr:add(0x0030):deref())
-	instance.m_draw_data         = CVehicleDrawData(ptr:add(0x0048):deref())
-	instance.m_can_boost_jump    = ptr:add(0x03A4)
-	instance.m_vehicle_damage    = ptr:add(0x0420)
-	instance.m_velocity          = ptr:add(0x07D0)
-	instance.m_is_targetable     = ptr:add(0x0AEE)
-	instance.m_next_gear         = ptr:add(0x0880)
-	instance.m_current_gear      = ptr:add(0x0882)
-	instance.m_top_gear          = ptr:add(0x0886)
-	instance.m_rpm               = ptr:add(0x08C8)
-	instance.m_rpm_2             = ptr:add(0x08CC)
-	instance.m_clutch            = ptr:add(0x08D4)
-	instance.m_throttle          = ptr:add(0x08D8)
-	instance.m_throttle_input    = ptr:add(0x08E0)
-	instance.m_engine_health     = ptr:add(0x0910)
-	instance.m_handling_data     = CHandlingData(ptr:add(0x0960):deref(), instance.m_model_info:GetVehicleType())
-	instance.m_deform_god        = ptr:add(0x096C)
-	instance.m_steering_input    = ptr:add(0x09D4)
-	instance.m_current_steering  = ptr:add(0x09DC)
-	instance.m_door_lock_status  = ptr:add(0x13D0)
-
-	local array_ptr              = ptr:add(0x0C30)
-	instance.m_wheels            = atArray(array_ptr, CWheel)
-	instance.m_num_wheels        = array_ptr:add(0x8):get_int()
-	instance.m_ride_height       = array_ptr:deref():add(0x007C)
+	local ptr                   = memory.handle_to_ptr(vehicle)
+	instance.m_ptr              = ptr
+	instance.m_model_info       = CVehicleModelInfo(ptr:add(0x0020):deref())
+	instance.m_draw_data        = CVehicleDrawData(ptr:add(0x0048):deref())
+	instance.m_turbo            = ptr:add(0x007C)
+	instance.m_water_damage     = ptr:add(0x00D8)
+	instance.m_can_boost_jump   = ptr:add(0x03A4)
+	instance.m_vehicle_damage   = ptr:add(0x0420)
+	instance.m_velocity         = ptr:add(0x07D0)
+	instance.m_transmission     = CTransmission(ptr:add(0x0880))
+	instance.m_engine_health    = ptr:add(0x0910)
+	instance.m_handling_data    = CHandlingData(ptr:add(0x0960):deref(), instance.m_model_info:GetVehicleType())
+	instance.m_deform_god       = ptr:add(0x096C)
+	instance.m_frag_inst        = phFragInst(ptr:add(0x09C0):deref())
+	instance.m_steering_input   = ptr:add(0x09D4)
+	instance.m_steering_angle   = ptr:add(0x09DC)
+	instance.m_throttle_power   = ptr:add(0x09E4)
+	instance.m_brake_power      = ptr:add(0x09E8)
+	instance.m_is_targetable    = ptr:add(0x0AEE)
+
+	local array_ptr             = ptr:add(0x0C30)
+	instance.m_wheels           = atArray(array_ptr, CWheel)
+	instance.m_num_wheels       = array_ptr:add(0x8):get_int()
+	instance.m_ride_height      = array_ptr:deref():add(0x007C)
+
+	instance.m_door_lock_status = ptr:add(0x13D0)
 
 	return instance
 end
@@ -125,14 +118,6 @@ function CVehicle:GetDeformMultiplier()
 	end)
 end
 
--- ---@param handlingType eHandlingType
--- ---@return CCarHandlingData|CBikeHandlingData|CFlyingHandlingData|any
--- function CVehicle:GetSubHandlingData(handlingType)
--- 	return self:__safecall(nil, function()
--- 		return self.m_handling_data:GetSubHandlingData(handlingType)
--- 	end)
--- end
-
 ---@return pointer<(CCarHandlingData|CBikeHandlingData|CFlyingHandlingData)?>
 function CVehicle:GetSubHandlingData()
 	return self.m_handling_data:GetSubHandlingData()
@@ -332,7 +317,7 @@ end
 ---@param boneIndex integer
 ---@return fMatrix44
 function CVehicle:GetBoneMatrix(boneIndex)
-	local ph_frag_inst = self.m_physics_fragments
+	local ph_frag_inst = self.m_frag_inst
 	if not ph_frag_inst then
 		return fMatrix44:zero()
 	end
@@ -348,7 +333,7 @@ end
 ---@param boneIndex integer
 ---@param matrix fMatrix44
 function CVehicle:SetBoneMatrix(boneIndex, matrix)
-	local ph_frag_inst = self.m_physics_fragments
+	local ph_frag_inst = self.m_frag_inst
 	if not ph_frag_inst then
 		return
 	end

SSV2/includes/data/config.lua

@@ -42,76 +42,81 @@ local Config <const> = {
 		auto_close = false,
 	},
 	keyboard_keybinds = {
-		gui_toggle       = "F5",
-		kill_all_enemies = "F7",
-		enemies_flee     = "F8",
+		gui_toggle        = "F5",
+		kill_all_enemies  = "F7",
+		enemies_flee      = "F8",
 		-- missile_defence  = "F9",
-		cobra_maneuver   = "X",
-		flatbed          = "X",
-		laser_sights     = "L",
-		nos              = "MOUSE5",
-		rolling_launch   = "N",
-		panik            = "F12",
-		nos_purge        = "X",
-		rod              = "X",
-		drift_mode       = "SHIFT",
+		cobra_maneuver    = "X",
+		flatbed           = "X",
+		laser_sights      = "L",
+		nos               = "MOUSE5",
+		rolling_launch    = "N",
+		panik             = "F12",
+		nos_purge         = "X",
+		rod               = "X",
+		drift_mode        = "SHIFT",
 		-- trigger_bot      = "SHIFT",
-		veh_mine         = "NUMPAD0",
-		stop_anim        = "G",
-		shift_up         = "NUMPAD9",
-		shift_down       = "NUMPAD3",
-		clutch           = "NUMPAD5",
+		veh_mine          = "NUMPAD0",
+		stop_anim         = "G",
+		shift_up          = "NUMPAD9",
+		shift_down        = "NUMPAD3",
+		clutch            = "NUMPAD5",
+		engine_start_stop = "NUMPAD1",
 	},
 	gamepad_keybinds = {
-		flatbed        = {
+		flatbed           = {
 			code = 288,
 			name = "A"
 		},
-		laser_sights   = {
+		laser_sights      = {
 			code = 303,
 			name = "DPAD UP"
 		},
-		nos            = {
+		nos               = {
 			code = 289,
 			name = "X"
 		},
-		nos_purge      = {
+		nos_purge         = {
 			code = 288,
 			name = "A"
 		},
-		rod            = {
+		rod               = {
 			code = 288,
 			name = "A"
 		},
-		drift_mode     = {
+		drift_mode        = {
 			code = 288,
 			name = "A"
 		},
 		-- trigger_bot = {
 		-- 	code = 0,
 		-- 	name = "Unbound"
 		-- },
-		veh_mine       = {
+		veh_mine          = {
 			code = 0,
 			name = "Unbound"
 		},
-		stop_anim      = {
+		stop_anim         = {
 			code = 0,
 			name = "Unbound"
 		},
-		rolling_launch = {
+		rolling_launch    = {
 			code = 0,
 			name = "Unbound"
 		},
-		shift_up       = {
+		shift_up          = {
 			code = 0,
 			name = "Unbound"
 		},
-		shift_down     = {
+		shift_down        = {
 			code = 0,
 			name = "Unbound"
 		},
-		clutch         = {
+		clutch            = {
+			code = 0,
+			name = "Unbound"
+		},
+		engine_start_stop = {
 			code = 0,
 			name = "Unbound"
 		},
@@ -167,7 +172,8 @@ local Config <const> = {
 			},
 			manual_gearbox = {
 				enabled = false,
-				mode = 0,
+				disable_stalling = false,
+				mode = 0, ---@type eManualGearboxType
 			},
 			bangs_rpm_max = 9000.0,
 			bangs_rpm_min = 4000.0,

SSV2/includes/data/custom_paints.lua

@@ -82,14 +82,14 @@ return {
 	{ name = "Rosso Corsa",                              hex = "#D40000", p = 28,  m = false, manufacturer = "Ferrari",           shade = "Red" },
 	{ name = "Millennium Jade",                          hex = "#3B3F31", p = 102, m = false, manufacturer = "Nissan",            shade = "Green" },
 	{ name = "Copper Gold",                              hex = "#5A4441", p = 136, m = false, manufacturer = "None",              shade = "Gold" },
-	{ name = "Taipei Gold",                              hex = "#49231F", p = 99,  m = false, manufacturer = "Koeniggsegg",       shade = "Gold" },
+	{ name = "Taipei Gold",                              hex = "#49231F", p = 99,  m = false, manufacturer = "Koenigsegg",        shade = "Gold" },
 	{ name = "Olympic Gold",                             hex = "#706546", p = 104, m = false, manufacturer = "None",              shade = "Gold" },
 	{ name = "Sandy Gold",                               hex = "#504942", p = 105, m = false, manufacturer = "None",              shade = "Gold" },
 	{ name = "Mulberry",                                 hex = "#240719", p = 137, m = false, manufacturer = "None",              shade = "Purple" },
 	{ name = "Onyx",                                     hex = "#353839", p = 103, m = false, manufacturer = "None",              shade = "Grey" },
 	{ name = "Amethyst",                                 hex = "#27253C", p = 65,  m = false, manufacturer = "Porsche",           shade = "Grey" },
-	{ name = "AAden Purple",                             hex = "#0C080C", p = 96,  m = false, manufacturer = "Koeniggsegg",       shade = "Purple" },
-	{ name = "Zjin Purple",                              hex = "#120119", p = 145, m = false, manufacturer = "Koeniggsegg",       shade = "Purple" },
+	{ name = "AAden Purple",                             hex = "#0C080C", p = 96,  m = false, manufacturer = "Koenigsegg",        shade = "Purple" },
+	{ name = "Zjin Purple",                              hex = "#120119", p = 145, m = false, manufacturer = "Koenigsegg",        shade = "Purple" },
 	{ name = "Viola Ophelia",                            hex = "#1A000F", p = 7,   m = false, manufacturer = "Lamborghini",       shade = "Purple" },
 	{ name = "Nismo Grey",                               hex = "#191919", p = 4,   m = false, manufacturer = "Nissan",            shade = "Grey" },
 	{ name = "Pagani Brown",                             hex = "#201913", p = 94,  m = false, manufacturer = "Pagani",            shade = "Brown" },
@@ -232,7 +232,7 @@ return {
 	{ name = "Sunset Gold",                              hex = "#262425", p = 99,  m = false, manufacturer = "Land Rover",        shade = "Gold" },
 	{ name = "Rio Gold",                                 hex = "#666162", p = 4,   m = false, manufacturer = "Land Rover",        shade = "Gold" },
 	{ name = "Rose Gold I",                              hex = "#B76E6E", p = 66,  m = false, manufacturer = "None",              shade = "Gold" },
-	{ name = "Rose Gold II",                             hex = "#322121", p = 66,  m = false, manufacturer = "Koeniggsegg",       shade = "Gold" },
+	{ name = "Rose Gold II",                             hex = "#322121", p = 66,  m = false, manufacturer = "Koenigsegg",        shade = "Gold" },
 	{ name = "Metallic Gold",                            hex = "#5C4C36", p = 37,  m = false, manufacturer = "None",              shade = "Gold" },
 	{ name = "Champagne Gold I",                         hex = "#4B443D", p = 97,  m = false, manufacturer = "Ford",              shade = "Gold" },
 	{ name = "Champagne Gold II",                        hex = "#644606", p = 37,  m = false, manufacturer = "Lotus",             shade = "Gold" },