Garajes BB

BB Garages – Sistema Avanzado de Gestión de Vehículos para QBCore

Revoluciona la forma en que tus jugadores interactúan con los vehículos usando BB Garages, un sistema integral de gestión de garajes y vehículos construido específicamente para servidores QBCore. Esto no es solo otro script de garaje básico, es un ecosistema completo de almacenamiento de vehículos que maneja todo, desde la aparición y el almacenamiento hasta la incautación y la persistencia de daños. Ya sea que estés actualizando desde los qb-garages predeterminados o construyendo un nuevo servidor desde cero, BB Garages proporciona la gestión de vehículos de nivel profesional que tu comunidad merece.

Desarrollado por barbaroNN, conocido por crear los recursos QBCore de la más alta calidad en la comunidad FiveM, BB Garages representa años de refinamiento basado en los comentarios de cientos de servidores. El sistema se integra perfectamente con la base de datos de propiedad de vehículos de QBCore al tiempo que agrega características críticas como la persistencia de daños, el guardado del estado del combustible, la gestión de incautaciones y el soporte de múltiples garajes en todo tu mapa. Los jugadores pueden acceder a sus vehículos desde cualquier ubicación de garaje configurada, con sistemas inteligentes que rastrean dónde se estacionó cada vehículo por última vez y evitan exploits de duplicación.

Qué está incluido

BB Garages llega como un paquete completo listo para su implementación inmediata en su servidor. El script incluye ubicaciones de garajes preconfiguradas que cubren todas las principales áreas de la ciudad: el centro de Los Santos, Sandy Shores, Paleto Bay y ubicaciones especializadas como los patios de impound de la LSPD y garajes privados premium. Cada garaje puede personalizarse con puntos de aparición de vehículos únicos, restricciones de acceso (público, trabajo-bloqueado, bloqueado por pandilla o bloqueado por propiedad), y branding visual que se adapta a la estética de tu servidor.

El sistema incluye una interfaz UI intuitiva que muestra la información del vehículo de un vistazo – nombre del modelo, número de placa, nivel actual de combustible, estado de daños y ubicación de almacenamiento. Los jugadores pueden previsualizar vehículos antes de generarlos, ver en qué garaje se encuentra cada uno de sus autos y transferir vehículos entre ubicaciones de almacenamiento (si está configurado). Las herramientas administrativas están integradas directamente en el script, permitiendo que el personal embargue vehículos, fuerce la generación de autos de jugadores para solucionar problemas y monitoree el uso de garajes en todo el servidor.

Características principales

• Sistema de Persistencia de Daños – Los vehículos recuerdan su estado exacto de daño cuando se almacenan, incluyendo el daño en el cuerpo, la salud del motor y las partes rotas
• Guardado del Estado de Combustible – Los niveles de gasolina se conservan al almacenar vehículos, evitando el uso de garajes para repostar gratis
• Red de Garajes Múltiples – Los jugadores acceden a todos los vehículos propiedad desde cualquier garaje público, o configuran garajes privados para acceso exclusivo
• Sistema de Depósito – Funcionalidad de depósito de vehículos con tarifas configurables, policía-solo acceso, e integración de grúas de remolque
• Vista previa del vehículo – Ver modelos 3D de vehículos en el UI antes de aparecer, ayudando a los jugadores a identificar los autos por su apariencia
• Gestión de Puntos de Aparición – La selección inteligente de ubicación de spawn evita colisiones de vehículos y garantiza un spawn suave
• Garajes de Trabajo – Configure garajes dedicados para la policía, EMS, mecánicos y trabajos personalizados con acceso a vehículos del trabajo
• Garajes de Territorio de Pandilla – Crear ubicaciones de almacenamiento específicas para pandillas que solo los miembros pueden acceder
• Integración de la Propiedad – Vincular garajes a scripts de vivienda para estacionamiento residencial privado
• Protección contra Duplicación – Robustas comprobaciones del lado del servidor evitan exploits de duplicación de vehículos
• Sistema de Transferencia de Estado – Los vehículos transicionan entre estados (fuera, almacenados, remolcados) con registro completo
• Herramientas de Migración de Base de Datos – Incluye scripts SQL para convertir desde el qb-garages predeterminado u otros sistemas de vehículos
• Comandos de Administrador – Forzar el spawn, incautar, eliminar o transferir vehículos con permisos administrativos
• Sistema de lugares de estacionamiento – Ubicaciones de estacionamiento opcionales donde los jugadores pueden almacenar vehículos fuera de los garajes
• Rendimiento optimizado – 0.00ms en espera, mínimo resmon durante las interacciones en el garaje

Perfecto para

• Servidores QBCore que necesitan una gestión de vehículos confiable y profesional
• Servidores que actualizan desde scripts de garaje predeterminados limitados
• Comunidades de Roleplay que buscan almacenamiento de vehículos inmersivo con persistencia de daños/combustible
• Servidores con múltiples ciudades, pueblos o mapas grandes que requieren acceso a garajes distribuidos
• Servidores enfocados en la economía donde las tarifas de incautación y los costos de recuperación importan
• Servidores con sistemas de vivienda que necesitan estacionamiento de propiedades integrado
• Comunidades con departamentos de policía activos que utilizan mecánicas de depósito

Detalles Técnicos

• Estructura: QBCore (diseñado específicamente para la arquitectura QB-Core)
• Impacto en el Rendimiento: 0.00ms en espera, ~0.01-0.02ms durante las interacciones del UI del garaje
• Base de datos: Tabla bbvehicles personalizada o configurable para usar la estructura player_vehicles existente
• Dependencias: Marco de trabajo QBCore, qb-target o ox_target para puntos de interacción
• Integraciones Opcionales: qb-housing, qb-apartments, qb-policejob, qb-ambulancejob
• Personalización: 100+ opciones de configuración para ubicaciones, tarifas, restricciones y comportamiento

Migración de Base de Datos Hecha Fácil

Cambiar a BB Garages desde otro sistema es sencillo gracias a los scripts de migración SQL incluidos. El paquete proporciona consultas de conversión que transfieren todos los datos de vehículos de la tabla player_vehicles de qb-garages predeterminada a la estructura optimizada de bbvehicles. La migración preserva información crítica como la propiedad (citizenid), placas de licencia, modelos de vehículos y modificaciones/personalizaciones.

Para servidores que actualmente ejecutan player_vehicles, los comandos SQL proporcionados manejan la conversión automáticamente. El script copia de manera segura todos los datos de vehículos existentes, inicializa las nuevas columnas de seguimiento de daños y combustible, establece estados de estacionamiento predeterminados para vehículos actualmente “fuera” en el mundo, y asigna estados de depósito apropiados para vehículos faltantes. Se incluyen consultas de verificación post-migración para confirmar que todos los vehículos se transfirieron exitosamente y no se perdió ningún dato en el proceso de conversión.

Instalación

1. Extrae bb-garages a la carpeta de recursos de tu servidor
2. Ejecuta el archivo SQL proporcionado para crear la tabla bbvehicles (o usa los scripts de migración si conviertes de un sistema existente)
3. Configura las ubicaciones de los garajes en config.lua – docenas de ubicaciones preestablecidas incluidas
4. Configurar ubicaciones y tarifas de recuperación de depósitos
5. Configure garajes de trabajo para la policía, EMS y otros trabajos del servidor
6. Añade ‘ensure bb-garages’ a server.cfg y reinicia
7. Almacenamiento, generación y persistencia del estado del vehículo de prueba

Tipos y Configuraciones de Garajes

BB Garages admite múltiples tipos de garajes para satisfacer diferentes necesidades del servidor. Los garajes públicos son accesibles para todos los jugadores y muestran sus vehículos civiles de propiedad personal. Estas ubicaciones suelen aparecer en estacionamientos, a lo largo de las principales calles y en áreas residenciales. Los jugadores pueden almacenar y recuperar vehículos de cualquier garaje público, con el sistema rastreando qué ubicación contiene cada automóvil.

Los garajes de trabajo proporcionan acceso a los vehículos departamentales para la policía, EMS, mecánicos y trabajos personalizados. Estas ubicaciones están restringidas por el nombre del trabajo y a veces por el grado del trabajo, asegurando que solo el personal autorizado pueda hacer aparecer vehículos de emergencia o camiones de trabajo. Los garajes de trabajo pueden extraer de los grupos de vehículos compartidos del trabajo o permitir que los empleados almacenen vehículos de trabajo personales. El sistema rastrea las apariciones de vehículos de trabajo para evitar duplicaciones, permitiendo que varios oficiales usen coches patrulla idénticos.

Los garajes de pandillas crean almacenamiento basado en territorio para organizaciones criminales. Configura estos garajes en las sedes de pandillas o zonas de territorio, restringiendo el acceso a los miembros solo. Los líderes de pandillas pueden usar estas ubicaciones para almacenar recursos compartidos como vehículos de huida, camiones blindados o coches de equipo especializado. El script se integra con qb-gangs o sistemas similares de gestión de pandillas para verificar la membresía antes de conceder el acceso.

Los depósitos sirven como almacenamiento de penalización para vehículos abandonados, ilegales o incautados por la policía. Los jugadores deben pagar tarifas configurables para recuperar los autos incautados, con costos que escalan según el tiempo que el vehículo ha estado incautado. La policía puede incautar vehículos de jugadores a través de comandos o scripts integrados, enviándolos a la perrera con notas visibles para los jugadores que explican por qué su auto fue incautado. Los vehículos no reclamados pueden ser eliminados automáticamente después de períodos de tiempo configurados para mantener la base de datos limpia.

Persistencia de daños y combustible

Una de las características más valiosas de BB Garages es la persistencia real del estado del vehículo. Cuando los jugadores guardan un vehículo dañado con el parabrisas roto, guardabarros abollados y el motor al 40% de su salud, ese estado de daño exacto se guarda en la base de datos. Cuando recuperan el coche más tarde, incluso días después, desde un garaje diferente, aparece con el mismo daño. Esto crea consecuencias realistas para la conducción imprudente y anima a los jugadores a visitar a los mecánicos para reparar en lugar de usar el garaje como un reinicio gratuito.

La persistencia de combustible funciona de la misma manera. Un coche almacenado con 15% de combustible se genera con 15% de combustible al ser recuperado. Los jugadores no pueden usar garajes para rellenar mágicamente sus tanques, manteniendo el valor de las gasolineras y las mecánicas de economía de combustible. El sistema guarda porcentajes exactos de combustible, no valores redondeados, asegurando precisión en múltiples ciclos de almacenamiento/recuperación. Combinado con la persistencia de daños, esto crea una experiencia realista de propiedad de vehículos donde los coches requieren mantenimiento y cuidado reales.

Qué hace que BB Garages destaque

BB Garages no intenta reinventar la gestión de vehículos, la perfecciona. barbaroNN construyó este sistema después de observar las limitaciones y errores en innumerables scripts de garajes en cientos de servidores. El resultado es un script que maneja cada caso límite, previene cada explotación conocida y proporciona un rendimiento suave y confiable bajo una carga pesada del servidor. Duplicación de vehículos, imposible con la validación de estado integrada. Acampar en garajes, la randomización de la ubicación de aparición lo previene. Vehículos faltantes, el sistema de depósito los captura automáticamente.

La arquitectura del script prioriza el rendimiento del servidor sin sacrificar características. La caché inteligente reduce las consultas a la base de datos, la comunicación cliente-servidor está optimizada para minimizar la sobrecarga de la red, y el renderizado UI utiliza marcos eficientes que no reducen los FPS. Incluso los servidores con miles de vehículos en la base de datos mantienen tiempos de carga instantáneos en el menú del garaje. El código es limpio, bien documentado y diseñado para una fácil personalización por parte de los desarrolladores de servidores que desean añadir características únicas.

El soporte para BB Garages va más allá de la solución de problemas básicos. barbaroNN proporciona una extensa documentación que cubre cada opción de configuración, configuraciones de ejemplo para escenarios comunes y guías en video para integraciones complejas. La comunidad de soporte de Discord incluye propietarios de servidores que han implementado con éxito configuraciones avanzadas como estacionamiento vinculado a propiedades, almacenamiento compartido de pandillas y sistemas de vehículos personalizados. Cuando llegan las actualizaciones del marco, BB Garages recibe actualizaciones de compatibilidad rápidamente, asegurando que su sistema de vehículos nunca se rompa debido a cambios en QBCore.

Opciones de configuración avanzadas

Los propietarios de servidores pueden ajustar cada aspecto de la experiencia del garaje a través del extenso archivo config.lua. Establecer diferentes tarifas de depósito para diferentes clases de vehículos – tarifas baratas para autos compactos, tarifas caras para superdeportivos. Configurar cuánto tiempo pueden estar los vehículos antes de ser incautados automáticamente, animando a los jugadores a usar sus autos regularmente o arriesgarse a perder el acceso. Establecer límites máximos de vehículos por jugador para evitar el acaparamiento de garajes, o crear niveles VIP con mayor capacidad de almacenamiento.

El comportamiento del punto de aparición es completamente configurable. Elija si los vehículos aparecen en ubicaciones fijas, puntos seleccionados aleatoriamente dentro de una zona o el espacio disponible más cercano al punto de interacción del garaje. Establezca un espaciado mínimo entre los vehículos aparecidos para evitar colisiones, configure la orientación de aparición para una orientación consistente y defina ubicaciones de aparición de respaldo si los puntos principales están bloqueados. El sistema incluso puede validar que las ubicaciones de aparición estén despejadas antes de intentar aparecer, evitando la frustración de que los vehículos aparezcan dentro de otros coches.

El control de acceso va más allá de simples verificaciones de trabajo. Configura los garajes para requerir elementos específicos (permisos de estacionamiento, llaves del garaje), cobrar tarifas de acceso cada vez que se abre el menú, o limitar el acceso a jugadores con ciertas licencias. Crea garajes premium que cobren tarifas de almacenamiento mientras proporcionan beneficios como reparaciones gratuitas o lavados estéticos. La flexibilidad permite crear experiencias de garaje únicas que se adapten a la economía y al estilo de rol de tu servidor.

SQL de migración Scripts explicado

Los scripts de migración SQL proporcionados manejan la complejidad técnica de cambiar a Garajes BB. El primer script crea la estructura de la tabla bbvehicles con índices adecuados para el rendimiento. El segundo script copia todos los datos de vehículos de player_vehicles a bbvehicles, coincidiendo columnas y convirtiendo tipos de datos según sea necesario. El tercer script inicializa nuevas columnas como estadísticas de daños y niveles de combustible con valores predeterminados sensatos, estableciendo el combustible en 100% y el daño en mínimo para vehículos existentes.

La lógica de conversión de estado determina si cada vehículo migrado debe ser marcado como almacenado, fuera o depositado según su estado actual en el sistema antiguo. Los vehículos marcados como almacenados permanecen almacenados. Los vehículos actualmente “fuera” en el mundo reciben un tratamiento especial, pueden ser auto-depositados o dejados en un estado “fuera” para que los jugadores los almacenen manualmente. El campo de ubicación de estacionamiento se establece adecuadamente, con los vehículos almacenados asignados al garaje más cercano y los vehículos fuera marcados con datos de estacionamiento vacíos hasta que se almacenen correctamente.

Vista previa del video

Referencia de Conversión de Base de Datos

Convertir (bueno, más o menos) ejecutar en SQL:

INSERT INTO bbvehicles (citizenid,plate,model) SELECT citizenid,plate,vehicle FROM player_vehicles

UPDATE `bbvehicles` SET `stats`='{"damage":10,"fuel":98}' WHERE stats is NULL

UPDATE `bbvehicles` SET `props`='{}' WHERE props? is NULL

UPDATE `bbvehicles` SET `state`='impound' WHERE state = 'unknown' or state is NULL

UPDATE `bbvehicles` SET `parking` = '' WHERE parking is NULL

Relacionado QBCore Scripts

• Máquina perforadora V2
• Envío de CD
• LMX iFruitPods
• Envío de trabajos de carga de UZ

Convertir (bueno, más o menos) ejecutar en SQL:

INSERT INTO bbvehicles (citizenid,plate,model) SELECT citizenid,plate,vehicle FROM player_vehicles

UPDATE `bbvehicles` SET `stats`='{"damage":10,"fuel":98}' WHERE stats is NULL

UPDATE `bbvehicles` SET `props`='{}' WHERE props? is NULL

UPDATE `bbvehicles` SET `state`='impound' WHERE state = 'unknown' or state is NULL

UPDATE `bbvehicles` SET `parking` = '' WHERE parking is NULL