miscellaneous

### YimactionsV3:

- Add the ability to dynamically register CommandExecutor commands for all animations and scenarios.

### Aircraft/Machine Guns

- The feature previously did not work for all aircraft machine guns because it used to iterate through an array of machine gun hashes and compares each one to our currently selected weapon. The array was not well maintained and was missing some hashes. We now read data directly from memory so the feature will work with all aircraft equipped with MGs.

### CommandExecutor

- Fix command meta showing translation keys for some commands instead of the translated label.

### Scripts/Translations

- Move the hash map file to the Lua source.

Author: xesdoog

CONTRIBUTING.md

@@ -230,7 +230,8 @@ The project is organized by responsibility rather than feature size. Folders def
 
 ```bash
 ├─ includes/
-│  ├─ classes/          # Contains reverse-engineered game classes (mostly sourced from Yimura's archived classes repository) and a few Lua-defined classes.
+│  ├─ classes/
+│  │  └─ gta/           # Contains reverse-engineered game classes mostly sourced from Yimura's archived repository and others I reversed myself using a mix of debuggers, public research, and personal suffering.
 │  │
 │  ├─ data/             # A place where all raw data is stored.
 │  │  ├─ actions/       # Contains YimActions V3 data (animations, scenarios, synchronized scenes, and movement clipsets).

…ncludes/classes/CBaseSubHandlingData.lua …des/classes/gta/CBaseSubHandlingData.luaSSV2/includes/classes/CBaseSubHandlingData.lua renamed to SSV2/includes/classes/gta/CBaseSubHandlingData.lua SSV2/includes/classes/CBaseSubHandlingData.lua renamed to SSV2/includes/classes/gta/CBaseSubHandlingData.lua

@@ -1,6 +1,6 @@
 ---@diagnostic disable: param-type-mismatch
 
-local fwDrawData = require("includes.classes.fwDrawData")
+local fwDrawData = require("includes.classes.gta.fwDrawData")
 
 ---@ignore
 ---@class CBaseModelInfo : GenericClass
@@ -28,7 +28,7 @@ local CAttackers = GenericClass
 ---@field m_hostility pointer<uint8_t> -- 0x018C
 ---@field m_health pointer<float> -- 0x0280
 ---@field m_max_health pointer<float> -- 0x0284
----@field m_max_attackers pointer<CAttackers> -- 0x0288
+---@field m_attackers pointer<CAttackers> -- 0x0288
 ---@overload fun(entity: handle): CEntity
 local CEntity = Class("CEntity", nil, 0x290)
 
@@ -53,7 +53,7 @@ function CEntity:init(entity)
 	instance.m_hostility             = ptr:add(0x018C)
 	instance.m_health                = ptr:add(0x0280)
 	instance.m_max_health            = ptr:add(0x0284)
-	instance.m_max_attackers         = ptr:add(0x0288)
+	instance.m_attackers             = ptr:add(0x0288):deref()
 
 	return instance
 end

…2/includes/classes/CBikeHandlingData.lua …cludes/classes/gta/CBikeHandlingData.luaSSV2/includes/classes/CBikeHandlingData.lua renamed to SSV2/includes/classes/gta/CBikeHandlingData.lua SSV2/includes/classes/CBikeHandlingData.lua renamed to SSV2/includes/classes/gta/CBikeHandlingData.lua

@@ -0,0 +1,25 @@
+---@class CFiringPatternAlias
+---@field protected m_ptr pointer
+---@field m_firing_pattern_hash pointer<joaat_t> // 0x0
+---@field m_alias_hash pointer<joaat_t> // 0x4
+---@overload fun(ptr: pointer): CFiringPatternAlias
+local CFiringPatternAlias = {}
+CFiringPatternAlias.__index = CFiringPatternAlias
+---@diagnostic disable-next-line: param-type-mismatch
+setmetatable(CFiringPatternAlias, {
+	__call = function(_, ...)
+		return CFiringPatternAlias.new(...)
+	end
+})
+
+---@param ptr pointer
+---@return CFiringPatternAlias
+function CFiringPatternAlias.new(ptr)
+	return setmetatable({
+		m_firing_pattern_hash = ptr:add(0x0),
+		m_alias_hash          = ptr:add(0x4)
+		---@diagnostic disable-next-line: param-type-mismatch
+	}, CFiringPatternAlias)
+end
+
+return CFiringPatternAlias

…2/includes/classes/CBoatHandlingData.lua …cludes/classes/gta/CBoatHandlingData.luaSSV2/includes/classes/CBoatHandlingData.lua renamed to SSV2/includes/classes/gta/CBoatHandlingData.lua SSV2/includes/classes/CBoatHandlingData.lua renamed to SSV2/includes/classes/gta/CBoatHandlingData.lua

@@ -1,11 +1,11 @@
 ---@diagnostic disable: param-type-mismatch
 
-local CEntity     = require("includes.classes.CEntity")
-local CPlayerInfo = require("includes.classes.CPlayerInfo")
+local CEntity           = require("includes.classes.gta.CEntity")
+local CPlayerInfo       = require("includes.classes.gta.CPlayerInfo")
+local CPedWeaponManager = require("includes.classes.gta.CPedWeaponManager")
 
 ---@class CPedIntelligence
 ---@class CPedInventory
----@class CPedWeaponManager
 
 --------------------------------------
 -- Class: CPed
@@ -15,21 +15,21 @@ local CPlayerInfo = require("includes.classes.CPlayerInfo")
 ---@field private m_ptr pointer
 ---@field m_ped_intelligence pointer<CPedIntelligence>
 ---@field m_ped_inventory pointer<CPedInventory>
----@field m_ped_weapon_mgr pointer<CPedWeaponManager>
+---@field m_ped_weapon_mgr CPedWeaponManager
 ---@field m_player_info? CPlayerInfo
 ---@field m_velocity pointer<vec3>
 ---@field m_ped_type pointer<uint8_t>
 ---@field m_ped_task_flag pointer<uint8_t>
 ---@field m_seatbelt pointer<uint8_t>
 ---@field m_armor pointer<float>
 ---@field m_cash pointer<uint16_t> // 0x1614
----@overload fun(ped: handle): CPed|nil
-local CPed        = Class("CPed", CEntity, 0x161C)
+---@overload fun(ped: handle): CPed
+local CPed              = Class("CPed", CEntity, 0x161C)
 
 ---@param ped handle
 ---@return CPed
 function CPed:init(ped)
-	if not ENTITY.DOES_ENTITY_EXIST(ped) or not ENTITY.IS_ENTITY_A_PED(ped) then
+	if (not ENTITY.DOES_ENTITY_EXIST(ped) or not ENTITY.IS_ENTITY_A_PED(ped)) then
 		error("Invalid entity!")
 	end
 
@@ -41,7 +41,7 @@ function CPed:init(ped)
 	instance.m_ptr = ptr
 	instance.m_ped_intelligence = ptr:add(0x10A0)
 	instance.m_ped_inventory = ptr:add(0x10B0)
-	instance.m_ped_weapon_mgr = ptr:add(0x10B8)
+	instance.m_ped_weapon_mgr = CPedWeaponManager(ptr:add(0x10B8))
 	instance.m_velocity = ptr:add(0x0300)
 	instance.m_ped_type = ptr:add(0x1098)
 	instance.m_ped_task_flag = ptr:add(0x144B)

…V2/includes/classes/CCarHandlingData.lua …ncludes/classes/gta/CCarHandlingData.luaSSV2/includes/classes/CCarHandlingData.lua renamed to SSV2/includes/classes/gta/CCarHandlingData.lua SSV2/includes/classes/CCarHandlingData.lua renamed to SSV2/includes/classes/gta/CCarHandlingData.lua

@@ -0,0 +1,52 @@
+local CWeaponInfo = require("includes.classes.gta.CWeaponInfo")
+
+---@class CPedWeaponManager
+---@field protected m_ptr pointer
+---@field public m_owner pointer<CPed>
+---@field public m_selected_weapon_hash pointer<uint32_t>
+---@field public m_weapon_info CWeaponInfo?
+---@field public m_vehicle_weapon_info CWeaponInfo?
+---@overload fun(ptr: pointer): CPedWeaponManager
+local CPedWeaponManager = { m_ptr = nullptr }
+CPedWeaponManager.__index = CPedWeaponManager
+---@diagnostic disable-next-line: param-type-mismatch
+setmetatable(CPedWeaponManager, {
+	__call = function(_, ...)
+		return CPedWeaponManager.new(...)
+	end
+})
+
+---@param ptr pointer
+---@return CPedWeaponManager?
+function CPedWeaponManager.new(ptr)
+	if (not ptr or ptr:is_null()) then
+		return
+	end
+
+	ptr = ptr:deref()
+	return setmetatable({
+		m_ptr                  = ptr,
+		m_owner                = ptr:add(0x0010):deref(), -- CPed
+		m_selected_weapon_hash = ptr:add(0x0018),
+		m_weapon_info          = CWeaponInfo(ptr:add(0x0020):deref()),
+		m_vehicle_weapon_info  = CWeaponInfo(ptr:add(0x0070):deref()),
+		---@diagnostic disable-next-line: param-type-mismatch
+	}, CPedWeaponManager)
+end
+
+---@return boolean
+function CPedWeaponManager:IsValid()
+	return self.m_ptr and self.m_ptr:is_valid()
+end
+
+---@return pointer
+function CPedWeaponManager:GetPointer()
+	return self.m_ptr
+end
+
+---@return uint64_t
+function CPedWeaponManager:GetAddress()
+	return self.m_ptr:get_address()
+end
+
+return CPedWeaponManager