Aparência
Configuração
Toda a personalização vive no config.lua do resource. As opções estão em três blocos: pneu furado, esterço ao descer e diagnóstico.
Config.License
A sua chave de licença. Página completa: Ativando a licença.
Pneu furado
Config.CheckInterval padrão: 350
Intervalo da checagem de pneus, em milissegundos. Abaixo de 300 o ganho é imperceptível e a thread roda à toa; acima de 500 o furo demora a ser sentido.
Config.OnlyDriver padrão: true
Limita a ação a quem está dirigindo. Com false, passageiros de um veículo furado também têm a velocidade limitada — o que só faz sentido em servidores onde ninguém anda acompanhado.
Config.IgnoredClasses
Classes de veículo que o módulo ignora por completo. Os números são os do GetVehicleClass:
lua
Config.IgnoredClasses = {
[13] = true, -- Cycles
[14] = true, -- Boats
[15] = true, -- Helicopters
[16] = true, -- Planes
[21] = true -- Trains
}O padrão tira o que não tem pneu que fure de forma útil. Para o módulo deixar de agir em motos também, acrescente [8] = true.
Config.WheelIndexes padrão: { 0, 1, 4, 5 }
Quais rodas entram na conta do furo. 0 e 1 são as da frente, 4 e 5 as de trás — mesmo em carro de quatro rodas, porque a numeração é por posição de eixo, não pelo total de rodas. Em veículos 6x6, acrescente 2 e 3 (meio esquerda e meio direita).
Índice que o modelo não tem é descartado sozinho — número sobrando não quebra nada, só não conta.
Os limites de velocidade
| Opção | Padrão | O que faz |
|---|---|---|
Config.OneBurstMaxSpeedKmh | 30.0 | Velocidade máxima com um pneu furado. É o caso "ainda dá para chegar à borracharia". |
Config.MinBurstTyresToApply | 2 | A partir de quantos pneus furados vale a limitação severa. Abaixo disso, vale o limite de um pneu. |
Config.FinalMaxSpeedKmh | 1.0 | Velocidade máxima na limitação severa. |
Config.SpeedPenaltyPerExtraBurstKmh | 0.0 | Quanto cada pneu além do mínimo desconta do alvo. Com o alvo já em 1 km/h não há o que descontar — suba junto com o FinalMaxSpeedKmh se quiser que 3 e 4 pneus doam mais que 2. |
Config.AbsoluteMinSpeedKmh | 1.0 | Piso do alvo. Existe para o veículo nunca travar em zero: parado de vez no meio da pista é indistinguível de script bugado. |
Config.DecelerationRateKmhPerSec padrão: 8.0
Com que rapidez a limitação chega ao alvo, em km/h por segundo. É o que separa "o pneu estourou e o carro foi perdendo" de "o carro bateu numa parede invisível".
Na prática: a 120 km/h, com 8 km/h por segundo, a queda até 1 km/h leva uns 15 segundos.
Esterço ao descer do veículo
Config.PreserveSteeringOnExit padrão: true
Mantém as rodas viradas quando o motorista desce do veículo parado. Sem isto, o GTA endireita o esterço no instante em que o banco esvazia — e o carro que você estacionou de rodas viradas aparece reto para todo mundo. false desliga o bloco inteiro.
Quando o esterço é guardado
| Opção | Padrão | O que faz |
|---|---|---|
Config.SteeringSaveMinAngle | 10.0 | Ângulo mínimo (graus) para valer a pena guardar. Abaixo disso é ruído de direção, não intenção de estacionar. |
Config.SteeringSaveMaxSpeedKmh | 3.0 | Velocidade máxima ao descer para o esterço ser guardado. Quem salta do carro andando não estacionou. |
Os tempos da reaplicação
São os intervalos das threads que seguram e sincronizam o esterço. Os padrões atendem a maioria dos servidores — mexa apenas se souber o que está procurando:
| Opção | Padrão | O que faz |
|---|---|---|
Config.SteeringMonitorInterval | 50 | Intervalo (ms) do acompanhamento do esterço de quem está ao volante. |
Config.SteeringApplyInterval | 0 | Intervalo (ms) da reaplicação nos veículos guardados. 0 = todo frame — é o que segura a roda sem tremer. |
Config.SteeringExitHoldDurationMs | 400 | Por quanto tempo (ms) o esterço é forçado logo após descer — a janela em que o GTA ainda tenta endireitar a roda. |
Config.SteeringExitHoldInterval | 0 | Intervalo (ms) dentro dessa janela. 0 = todo frame. |
Config.SteeringResyncInterval | 5000 | De quanto em quanto tempo (ms) o servidor reenvia os esterços guardados — é o que faz o carro aparecer virado também para quem entrou depois. |
Diagnóstico
Config.Debug padrão: false
Imprime no console F8 do jogador o que o módulo está fazendo com cada veículo — furo detectado, limite aplicado, esterço sincronizado. Serve para ajustar os números acima.
Desligue em produção
Com o veículo em movimento, o diagnóstico escreve a cada checagem. Ligue só durante o ajuste.
Não confunda com o sz_debug
O Config.Debug é o diagnóstico da física do módulo (no F8 do jogador). O diagnóstico do licenciamento é outro: set sz_debug "true" no server.cfg — ver Solução de problemas.
