SISTEMA DE TRAÇÃO 4x4 — FARMING SIMULATOR 25
================================================
Estado: CONFIRMADO A FUNCIONAR EM TESTES REAIS — diferença visível na
rotação das rodas entre 2x4/4x4 e diff lock on/off, testado com carga
pesada e chuva.

O QUE ESTE MOD FAZ
---------------------
  - Ctrl+J: liga/desliga a tração ao eixo dianteiro (2x4 <-> 4x4)
  - Ctrl+K: liga/desliga um bloqueio de diferencial real
  - Ctrl+N: mostra/esconde o indicador no ecrã
  - Indicador no ecrã: "4x4"/"2x4" a verde/vermelho, modo de tração
    entre parênteses, percentagem de engate no modo "smart", e
    "Diferencial bloqueado" a amarelo quando ativo
  - Cada trator vem com o modo "de série" conforme a tabela real que
    forneceste (ver scripts/DriveModeConfig.lua)
  - Deteção automática por PATINAGEM REAL das rodas traseiras (não só
    velocidade) — confirmado por engenharia inversa do mod Advanced
    Damage System (physicsWheel.netInfo.slip)
  - Modo "smart" (Fendt): engate gradual e contínuo, proporcional à
    patinagem, desliga sempre acima da velocidade de estrada
  - Se tiveres o mod Variable Tire Pressure instalado no mesmo
    veículo, o modo "smart"/"auto" ajusta automaticamente a pressão
    dos pneus (campo ao engatar 4x4, estrada ao voltar a 2x4) —
    chamando a função pública deles, sem duplicar o sistema deles
  - Posição do HUD ajustável DENTRO DO JOGO (Esc > Definições >
    Geral), sem editar nenhum ficheiro
  - Restrito a tratores, camiões, ceifeiras e carros
  - Multijogador: a tecla Ctrl+J (ligar/desligar 4x4) está sincronizada
    em rede; o resto (Ctrl+K, modos automáticos) ainda não

MODOS DE TRAÇÃO
-------------------
  "manual"   — Ctrl+J liga/desliga sempre
  "semiauto" — liga/desliga o 4x4 sozinho por patinagem real, mas o
               BLOQUEIO DO DIFERENCIAL (Ctrl+K) continua manual
  "auto"     — igual ao semiauto no engate do 4x4, mas o bloqueio do
               diferencial também passa a ser automático
  "smart"    — modo Fendt: engate GRADUAL e proporcional à patinagem,
               nunca binário, bloqueio automático; usado atualmente só
               nos Fendt Vario

Tratores marcados como "semiauto" podem ser atualizados para "auto" a
sério na loja (ver PERSONALIZAR ao comprar) — útil porque a diferença
entre os dois não é óbvia à primeira vista.

Todos os parâmetros (limiares de patinagem, velocidade de estrada,
tempo de rampa do modo smart) estão no topo de
"scripts/DriveModeConfig.lua", com comentários a explicar cada um.

AJUSTAR A POSIÇÃO DO HUD (dentro do jogo, não por XML)
-----------------------------------------------------------
Abre o menu do jogo (Esc) -> Definições -> Geral. Deves ver uma secção
"4x4 Traction System HUD" com duas opções:
  "HUD 4x4 esquerda/direita" e "HUD 4x4 cima/baixo"
Cada uma tem incrementos de 5% do ecrã, entre -100% e +100%. A escolha
fica gravada automaticamente (num ficheiro na tua pasta de perfil, não
na savegame), por isso mantém-se em todas as quintas.

Se por algum motivo a secção não aparecer no menu (ex: uma versão do
jogo que mudou a estrutura desse menu), o mod usa como reserva os
valores hudOffsetXPercent/hudOffsetYPercent em DriveModeConfig.lua.

PRESSÃO DE PNEUS NATIVA (não depende de nenhum outro mod)
--------------------------------------------------------------
Versões anteriores dependiam do Variable Tire Pressure (chamando a
função pública dele). Isso causava dois problemas: oscilação (o 4x4 e
a pressão alimentavam-se um ao outro) e comportamento inconsistente —
o VTP tem a sua própria lógica de "parar = volta logo a modo estrada",
que não seguia o nosso próprio estado de 4x4.

Agora a pressão é 100% nossa: reduzimos ligeiramente o raio físico da
roda (o mesmo mecanismo que o VTP usa, confirmado por engenharia
inversa — reduzir wheel.physics.radius e marcar
wheel.physics.isPositionDirty = true) sempre que o 4x4 está engatado,
e voltamos ao normal quando desliga. A transição é gradual (3
segundos) para nunca dar solavancos. O limite de redução (-15% do
raio) é o mesmo valor por omissão que o VTP usa, já testado por um mod
real.

O HUD mostra sempre a pressão atual em bar (valor ilustrativo, 1.0 bar
em modo campo a 1.8 bar em modo estrada). Não precisas de ter o
Variable Tire Pressure instalado — e se o tiveres, os dois mods vão
mexer na mesma roda de forma independente, o que pode causar
conflitos; recomenda-se desativar a configuração de pressão variável
do VTP nos veículos onde uses o 4x4 inteligente.

MODOS DE TRAÇÃO POR TRATOR
-------------------------------
Populei "scripts/DriveModeConfig.lua" com os modos das tabelas que
forneceste. Os "match" são o meu melhor palpite do nome real do
ficheiro de cada veículo — confirma sempre no log:

  [FS25_4x4TractionSystem] <veículo>: modo de tração = manual/semiauto/auto/smart

Ajusta os "match" no ficheiro se algum trator não corresponder.
Qualquer veículo sem correspondência fica em "manual" por omissão.

COMO INSTALAR
----------------
1) Compacta a pasta "FS25_4x4TractionSystem" num .zip com o mesmo nome
   — os ficheiros (modDesc.xml, etc.) ficam na RAIZ do zip.
2) Coloca o .zip em Documentos\My Games\FarmingSimulator2025\mods
3) Ativa o mod no menu de mods antes de carregares a partida.
4) Entra num trator/camião/ceifeira/carro e testa Ctrl+J, Ctrl+K e
   Ctrl+N, e confirma a nova secção nas Definições Gerais do jogo.

SE DER ERRO
-------------
Qualquer erro só aparece UMA VEZ no log, com o prefixo
"[FS25_4x4TractionSystem]" — procura por isso em
"My Games\FarmingSimulator2025\log.txt" depois de fechares o jogo.
