HYPER REALISTIC MAINTENANCE 2 — FS25
========================================
Combina as ideias de dois mods reais (Real Mechanical Wear e Advanced
Damage System) num sistema original — nenhuma linha de código copiada,
só técnicas e arquitetura estudadas e reimplementadas de raiz.

O QUE SIMULA
---------------
  - MOTOR: 5 componentes independentes (cilindro, pistão, chumaceiras,
    cambota, válvulas), que se influenciam entre si — desgaste do
    cilindro aumenta "blow-by", que contamina o óleo, que acelera
    ainda mais o desgaste. Efeitos reais: perda de potência, mais
    consumo de combustível, fumo, pior arranque a frio.
  - TÉRMICO: temperatura do motor, sobe com a carga, sobreaquece se o
    radiador estiver degradado.
  - FLUIDOS: óleo (nível + contaminação) e refrigerante.
  - TRANSMISSÃO/TURBO/BATERIA: desgaste da embraiagem, caixa, turbo,
    perda de capacidade da bateria e do motor de arranque.
  - AVARIAS: probabilísticas, sobem muito de hipótese acima de ~35% de
    desgaste do componente relevante. Sobreaquecimento crítico (>118°C)
    é garantido, não é sorte.
  - DIFERENCIAÇÃO POR TIPO: tratores, camiões, ceifeiras e carros
    desgastam a ritmos diferentes (ceifeiras mais depressa no motor,
    camiões mais na transmissão, carros muito mais devagar). Ceifeiras
    têm ainda um efeito extra: motor muito degradado reduz a eficiência
    real da debulha.

EFEITOS REAIS, NÃO COSMÉTICOS
---------------------------------
  - Perda de potência: reduz mesmo o binário disponível do motor
    (VehicleMotor.getMotorAvailableTorque, confirmado por engenharia
    inversa do Real Mechanical Wear)
  - Bloqueio de arranque: bateria ou motor de arranque avariados
    impedem MESMO o motor de arrancar, com aviso a piscar no ecrã
    (Motorized.startMotor + g_currentMission.hud:showBlinkingWarning)

MANUTENÇÕES PROGRAMADAS (revisões, tal como na vida real)
--------------------------------------------------------------
8 itens, cada um com o seu intervalo em horas de motor e custo real
(dinheiro da quinta, calculado como fração do preço do veículo — um
trator caro custa mais a revisar que um barato, tal como na vida
real):

  Óleo e filtro do motor .... 250h
  Filtro de ar .............. 500h
  Filtro de combustível ..... 500h
  Óleo hidráulico ........... 1200h
  Óleo da transmissão ....... 1000h
  Líquido de arrefecimento .. 1500h
  Lubrificação (massa) ...... 50h
  Correias .................. 1000h

Estes intervalos são valores TÍPICOS da indústria agrícola para
motores diesel modernos — não é a ficha técnica exata de nenhuma
marca/modelo específico do FS25 (isso não tenho como confirmar por
veículo). Se souberes os intervalos reais de algum trator específico
que uses, ajusta em HRM2_Maintenance.ITEMS.

Se deixares passar muito do intervalo, o desgaste do motor e da
transmissão acelera (até +120% mais rápido no pior caso) — negligenciar
manutenção tem um custo real, tal como devia.

HUD COM 3 PÁGINAS (Ctrl+P circula, Ctrl+M mostra/esconde)
----------------------------------------------------------------
  1. GERAL — motor, temperatura, óleo, refrigerante, transmissão,
     turbo, bateria, potência disponível
  2. DIAGNÓSTICO — compressão, blow-by, carbono, fumo, fiabilidade de
     arranque, estabilidade ao ralenti, consumo extra, contaminação
  3. MANUTENÇÃO — os 10 itens programados, horas desde a última
     revisão, e se estão em dia ou atrasados

A posição do HUD move-se com o rato — ver "MOVER O PAINEL COM O RATO"
mais abaixo.

CLASSIFICAÇÃO AUTOMÁTICA POR POTÊNCIA (HP)
------------------------------------------------
Além das substituições por marca/série (John Deere 7J, Compact
Utility), o mod lê a potência real do veículo (storeItem.specs.power,
confirmado no Advanced Damage System) para escolher automaticamente
entre as classes Compact (<50 HP), Utility (50-150 HP) e Large Ag
(>150 HP) da tua tabela genérica — sem precisares de configurar nada
por veículo. As substituições de marca específica têm sempre
prioridade sobre isto, quando existem.

OFICINA REAL DO JOGO
------------------------
O botão de reparação da loja de veículos, da oficina da quinta, ou de
uma oficina móvel (todas usam o mesmo ecrã do jogo) agora também
realiza uma revisão completa HRM2 — paga todos os itens de manutenção
em atraso mais uma reparação geral proporcional ao desgaste, tudo
debitado à quinta. A reparação normal do jogo (danos visuais/chapa)
continua a acontecer como seria de esperar, em paralelo.

CONTROLOS
------------
  - Ctrl+M: mostra/esconde o HUD
  - Ctrl+P: circula entre as 3 páginas do HUD
  - Ctrl+Shift+H: ativa/desativa o modo de edição do HUD (arrastar o painel
    com o rato)
  - "hrm2Status": estado mecânico completo do veículo atual
  - "hrm2MaintStatus": lista as 10 manutenções, horas desde a última,
    se estão em dia/atrasadas, e o custo de cada uma
  - "hrm2Service <item>": realiza uma manutenção específica, com custo
    real debitado à quinta (ex: "hrm2Service engineOil")
  - "hrm2Repair": repara tudo de uma vez (motor, transmissão, bateria,
    fluidos, avarias, todas as manutenções) — sem custo, é o "botão de
    pânico" para testes

REFORÇO DE SOM DO MOTOR SOB CARGA
---------------------------------------------------
Não há som de "turbo" isolado neste FS25 (confirmado em jogo) — o som
do motor é uma gravação única, que o jogo já ajusta de tom/volume
consoante a carga. O HRM2 reforça esse mesmo som (volume e um
pouco de tom) quando a carga está no máximo, com a mesma inércia
suave usada no resto do mod. A intensidade do reforço varia por
veículo, seguindo a mesma gama de pressão de turbo que o HRM2 já
atribui por motor: um trator grande fica com um assobio bem mais
encorpado, um mais pequeno quase não muda. Não precisa de nenhum
ficheiro de áudio novo.


Se tiveres também o mod FS25_4x4TractionSystem ativo, o HRM2 deteta-o
sozinho (sem nada a configurar) e liga o estado real do 4x4/diff lock
a dois efeitos:
  - Consumo de combustível: +4.5% com o eixo dianteiro engatado
    (escalado pelo nível de engate no modo "smart"), mais +3% se o
    diferencial estiver bloqueado — perdas de atrito extra na
    transmissão, tal como na vida real.
  - Desgaste dos eixos (HRM2_Core, campo "axleWear"): stress extra de
    +0.15 com o eixo dianteiro engatado, mais +0.35 se o diferencial
    estiver bloqueado — não mexe no desgaste da embraiagem nem da
    caixa, só dos eixos/diferenciais.

Sem o mod 4x4 instalado, isto nunca ativa — o HRM2 funciona
exatamente como antes, sem depender dele para nada. É uma dependência
só num sentido: o HRM2 sabe ler o 4x4, o 4x4 não sabe nem precisa de
saber que o HRM2 existe.
MOVER O PAINEL COM O RATO
---------------------------------------------------
Pedido pela comunidade: prime Ctrl+Shift+H para ativar o modo de edição do
HUD (mostra o cursor do rato), clica sem soltar em cima do painel do
HRM2 e arrasta para onde quiseres. Solta o botão para largar a
posição fica gravada automaticamente entre sessões. Prime Ctrl+Shift+H outra
vez para sair do modo de edição. O menu de Definições Gerais também
tem as opções antigas, mas nem sempre aparecem lá de forma fiável; o
arrastar com o rato é o caminho recomendado.

LIMITAÇÕES HONESTAS
-----------------------
  - As taxas de desgaste e os intervalos de manutenção são estimativas
    minhas para "parecerem realistas" (baseadas em valores típicos da
    indústria), não valores de nenhum veículo real específico do FS25
    — ajusta HRM2_Core.ENGINE_BASE_WEAR_PER_HOUR,
    HRM2_Failure.BASE_CHANCE_PER_HOUR e HRM2_Maintenance.ITEMS à
    vontade
  - O "turbo" aplica-se a todos os veículos por igual — não tenho
    forma confirmada de detetar se um motor específico tem turbo ou não
  - Multijogador melhorado e testado num servidor real, mas ainda não
    totalmente validado — ver o aviso de compatibilidade no modDesc

INSTALAÇÃO
-------------
1) Zip da pasta "FS25_HyperRealisticMaintenance2" com o mesmo nome,
   ficheiros na raiz do zip.
2) Documentos\My Games\FarmingSimulator2025\mods
3) Ativar no menu de mods antes de carregar a partida.

Erros aparecem só uma vez no log, prefixo "[HRM2]".
