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
  - SÓ SINGLEPLAYER — não sincroniza em servidores multijogador

MODOS DE TRAÇÃO
-------------------
  "manual"   — Ctrl+J liga/desliga sempre
  "semiauto" — liga sozinho quando deteta patinagem real, Ctrl+J força
               uma escolha manual durante 8 segundos
  "auto"     — igual ao semiauto, para veículos com 4x4 automático
               "normal" (sensor + ativação binária)
  "smart"    — modo Fendt: engate GRADUAL e proporcional à patinagem,
               nunca binário; usado atualmente só nos Fendt Vario

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.

SOBRE A SINERGIA COM O VARIABLE TIRE PRESSURE
--------------------------------------------------
Não reimplementei um sistema de pressão de pneus — o Variable Tire
Pressure já faz isso muito bem, com mais de 5000 linhas dedicadas ao
assunto. Em vez disso, se detetarmos esse mod no mesmo veículo, o
nosso mod chama a função pública dele (vtpSetRoadMode) sempre que o
4x4 liga ou desliga — baixando a pressão automaticamente ao entrar em
modo campo (mais aderência) e subindo ao voltar à estrada (menos
desgaste/consumo), tal como o VarioGrip real. Se não tiveres esse mod
instalado, esta parte simplesmente não faz nada (não é obrigatório).

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.
