feat: add odometer functionality to vehicle HUD

- Introduced odometer configuration in shared/config.lua, allowing for automatic or manual mileage tracking.
- Updated ClassicGauge component to display odometer values using a new OdometerReel component.
- Enhanced VehicleHud to integrate odometer display within the classic gauge framework.
- Created OdometerReel and OdometerDisplay components for rendering odometer values in a visually appealing manner.

Author: mur4i

MANUAL.md

@@ -101,6 +101,20 @@ Os **defaults** ficam em `shared/config.lua`. Quando `Config.AdminOnly = true`,
 
 As três opções `ClassicSpeedo*` também podem ser trocadas in-game pelo admin (menu **Aparência**, com o tema `classic` selecionado).
 
+#### Odômetro (milhagem)
+
+O velocímetro exibe um odômetro (aparece na cápsula abaixo da velocidade no tema `sport`; ocultado quando o valor é 0). O HUD **só exibe** — a quilometragem vem de um provedor externo. Há suporte automático embutido:
+
+| Campo | Valores | Padrão |
+|---|---|---|
+| `Config.Odometer.enabled` | boolean | `true` |
+| `Config.Odometer.provider` | `'auto'` \| `'mri_mechanic'` \| `'jg-vehiclemileage'` \| `'none'` | `'auto'` |
+| `Config.Odometer.interval` | ms entre leituras | `2000` |
+
+- `'auto'` detecta o provedor rodando (prioriza `mri_mechanic`, depois `jg-vehiclemileage`) e funciona mesmo se o provedor iniciar depois do HUD.
+- Os provedores retornam **km**; o HUD converte para **milhas** quando `Config.UseMPH = true`.
+- `'none'` desliga a leitura automática — nesse caso qualquer script pode alimentar o odômetro manualmente pelo evento `mri_Qhud:client:setOdometer` (client) ou `TriggerClientEvent('mri_Qhud:client:setOdometer', src, distance)` (server).
+
 ### 3.4 Skin de player (sobrenatural)
 
 | Campo | Valores | Padrão |

client/main.lua

@@ -1041,6 +1041,65 @@ RegisterNetEvent("mri_Qhud:client:setOdometer", function(distance)
     })
 end)
 
+-- ─────────────────────────────────────────────────────────────────
+-- Suporte automatico a provedores de milhagem (mri_mechanic / jg-vehiclemileage).
+-- O HUD so exibe; a milhagem (km) vem do export do provedor ativo. Detecta em
+-- runtime (aguenta o provedor iniciar depois do HUD), le a milhagem do veiculo
+-- atual e alimenta o mesmo caminho do odometro. Ver Config.Odometer.
+-- ─────────────────────────────────────────────────────────────────
+local function resolveMileageProvider()
+    local p = (Config.Odometer and Config.Odometer.provider) or 'none'
+    if p == 'none' then return nil end
+    if p == 'auto' then
+        if GetResourceState('mri_mechanic') == 'started' then return 'mri_mechanic' end
+        if GetResourceState('jg-vehiclemileage') == 'started' then return 'jg-vehiclemileage' end
+        return nil
+    end
+    if GetResourceState(p) == 'started' then return p end
+    return nil
+end
+
+-- Le a milhagem (km) do veiculo pelo export do provedor. pcall porque o export
+-- pode nao existir se o provedor for parado em runtime.
+local function getVehicleMileageKm(provider, veh)
+    local ok, km
+    if provider == 'mri_mechanic' then
+        ok, km = pcall(function() return exports['mri_mechanic']:GetMileage(veh) end)
+    elseif provider == 'jg-vehiclemileage' then
+        ok, km = pcall(function() return exports['jg-vehiclemileage']:getMileageByEntity(veh) end)
+    end
+    return (ok and tonumber(km)) or 0
+end
+
+CreateThread(function()
+    if not (Config.Odometer and Config.Odometer.enabled) then return end
+    if Config.Odometer.provider == 'none' then return end
+    local provider = nil
+    local lastSent = -1
+    local interval = (Config.Odometer.interval and math.max(500, Config.Odometer.interval)) or 2000
+    while true do
+        if provider == nil then provider = resolveMileageProvider() end
+        local wait = provider and interval or 5000 -- sem provedor: checa devagar
+        if provider and LocalPlayer.state.isLoggedIn then
+            local ped = PlayerPedId()
+            local veh = GetVehiclePedIsIn(ped, false)
+            if veh ~= 0 and GetPedInVehicleSeat(veh, -1) == ped then
+                local km = getVehicleMileageKm(provider, veh)
+                -- Provedores retornam km; o HUD exibe milhas quando UseMPH.
+                local value = Menu.isUseMPHChecked and math.floor(km * 0.621371) or math.floor(km)
+                if value ~= lastSent then
+                    lastSent = value
+                    SendNUIMessage({ action = "odometer", value = value })
+                end
+            elseif lastSent ~= 0 then
+                lastSent = 0 -- fora do veiculo: zera (o UI esconde com 0)
+                SendNUIMessage({ action = "odometer", value = 0 })
+            end
+        end
+        Wait(wait)
+    end
+end)
+
 RegisterNetEvent('hud:client:UpdateUISettings', function(data)
     UIConfig = data
     sendUIUpdateMessage(data)