¿Qué es FR Dealership?
FR Dealership (v1.2.0) es el concesionario y garaje gratuito de FiveRank para FiveM. Incluye un showroom cinematográfico con turntable en tiempo real, financiación de vehículos, propiedad real guardada en base de datos y exportaciones para que otros scripts validen la propiedad.
El concesionario que tu servidor merece — gratis, open-source y listo para producción.
¿Qué incluye?
Showroom cinematográfico
El vehículo seleccionado aparece sobre un podio con una cámara orbital giratoria, barras de rendimiento en vivo (velocidad, aceleración, frenada, manejo) y número de plazas. La cámara orbita el coche mientras el jugador navega por el catálogo.
Catálogo completo por categorías
9 categorías de serie — Compactos, Sedanes, SUVs, Cupés, Muscle, Deportivos, Súper, Todoterreno y Motos — totalmente configurables en config.lua. Añadir un coche personalizado o add-on es una sola línea.
Selector de color
Preview de colores de pintura en vivo antes de comprar. Los colores disponibles se definen en Config.Colors.
Pago en efectivo o banco
Feedback de asequibilidad en tiempo real: si el jugador no tiene fondos suficientes en la cuenta elegida, el botón de compra lo indica antes de confirmar.
Financiación de vehículos (cuotas)
Compra el coche en cuotas con una entrada inicial y un interés configurables. Los pagos perdidos embargan el vehículo (no se puede sacar del garaje) y acumulan cargos por mora; el impago prolongado reposeé el coche y prohíbe al jugador financiar durante un periodo configurable.
Garaje personal
Saca los vehículos, guárdalos (con todas sus propiedades guardadas) o véndelos de vuelta al concesionario por un porcentaje configurable. Múltiples garajes en el mapa — los vehículos se comparten entre todos.
Propiedad real server-side
Cada compra escribe en fr_owned_vehicles con una matrícula única generada. El servidor nunca confía en el cliente para precio, label ni propiedad.
Exportaciones para otros scripts
-- Devuelve true si el jugador (source) es dueño de la matrícula.
exports['fr_dealership']:IsOwner(source, plate)
-- Devuelve el identificador del propietario o nil.
exports['fr_dealership']:GetOwner(plate)
fr_carlock usa IsOwner para que los jugadores solo puedan cerrar/abrir sus propios vehículos.
Test drive
Prueba cualquier vehículo antes de comprarlo. Se teletransporta al jugador al aeropuerto con una copia temporal durante un tiempo configurable. El coche no puede guardarse, venderse ni conservarse y salir del geocercado termina la prueba antes de tiempo.
Dependencias
| Dependencia | Tipo | Notas |
|---|---|---|
oxmysql | Obligatoria | Única dependencia estricta |
ESX Legacy (es_extended) | Framework | Auto-detectado en runtime |
QBCore (qb-core) | Framework | Auto-detectado en runtime |
fr_interact | Opcional | Prompts flotantes "pulsa E"; cae a fallback nativo si no está |
fr_notify | Opcional | Notificaciones estilizadas; cae a notificaciones del framework |
El script es 100% agnóstico al framework: ESX y QBCore se mapean mediante un bridge (server/framework.lua + client/framework.lua) sin ninguna configuración.
Tablas de base de datos
Las tablas se crean automáticamente en el primer arranque. Si prefieres crearlas manualmente, importa el archivo incluido sql/fr_dealership.sql.
| Tabla | Propósito |
|---|---|
fr_owned_vehicles | Vehículos comprados con matrícula, propiedades, estado y estado de embargo |
fr_vehicle_loans | Préstamos activos con cuotas restantes y estado |
fr_finance_bans | Jugadores vetados temporalmente de financiación por impago |
Créditos
- Autor: FiveRank Team · Licencia: Gratis para uso comunitario
- Web: https://fiverank.gg · Docs: https://docs.fiverank.gg