O que é o FR Dealership?
FR Dealership (v1.2.0) é a concessionária e garagem gratuita da FiveRank para FiveM. Inclui um showroom cinematográfico com turntable ao vivo, financiamento de veículos, propriedade real guardada na base de dados e exportações para que outros scripts validem a propriedade.
A concessionária que o teu servidor merece — grátis, open-source e pronta para produção.
O que inclui?
Showroom cinematográfico
O veículo selecionado aparece num pódio com uma câmera orbital giratória, barras de desempenho ao vivo (velocidade, aceleração, travagem, manuseamento) e número de lugares. A câmera orbita o carro enquanto o jogador navega no catálogo.
Catálogo completo por categorias
9 categorias de série — Compactos, Sedãs, SUVs, Cupés, Muscle, Desportivos, Super, Todo-o-terreno e Motos — totalmente configuráveis em config.lua. Adicionar um carro personalizado é uma única linha.
Seletor de cor
Pré-visualização das cores de pintura ao vivo antes de comprar.
Pagamento a dinheiro ou banco
Feedback de acessibilidade em tempo real: se o jogador não tiver fundos suficientes na conta escolhida, o botão de compra indica-o antes de confirmar.
Financiamento de veículos (prestações)
Compra o carro em prestações com uma entrada e juro configuráveis. Prestações em falta penhoram o veículo (não pode ser retirado da garagem) e acumulam encargos de mora; o incumprimento prolongado reposui o carro e proíbe o jogador de financiar durante um período configurável.
Garagem pessoal
Retira os veículos, guarda-os (com todas as propriedades guardadas) ou vende-os de volta ao concessionário por uma percentagem configurável.
Propriedade real server-side
Cada compra escreve em fr_owned_vehicles com uma matrícula única gerada. O servidor nunca confia no cliente para preço, label ou propriedade.
Exportações para outros scripts
exports['fr_dealership']:IsOwner(source, plate)
exports['fr_dealership']:GetOwner(plate)
Test drive
Experimenta qualquer veículo antes de comprar. Uma cópia temporária aparece no aeroporto durante um tempo configurável.
Dependências
| Dependência | Tipo | Notas |
|---|---|---|
oxmysql | Obrigatória | Única dependência estrita |
| ESX Legacy | Framework | Auto-detetado em runtime |
| QBCore | Framework | Auto-detetado em runtime |
fr_interact | Opcional | Prompts "pressiona E" flutuantes |
fr_notify | Opcional | Notificações estilizadas |
Créditos
- Autor: FiveRank Team · Licença: Gratuito para uso comunitário
- Website: https://fiverank.gg · Docs: https://docs.fiverank.gg