Garages BB

BB Garages – Système de gestion de véhicules avancé pour QBCore

Révolutionnez la façon dont vos joueurs interagissent avec les véhicules grâce à BB Garages, un système complet de gestion de garages et de véhicules conçu spécifiquement pour les serveurs QBCore. Ce n'est pas un simple script de garage de base – c'est un écosystème complet de stockage de véhicules qui gère tout, de l'apparition et du stockage à la mise en fourrière et à la persistance des dégâts. Que vous passiez des qb-garages par défaut ou que vous construisiez un nouveau serveur à partir de zéro, BB Garages offre la gestion de véhicules de qualité professionnelle que votre communauté mérite.

Développé par barbaroNN, connu pour créer les ressources QBCore de la plus haute qualité dans la communauté FiveM, BB Garages représente des années de raffinement basées sur les retours de centaines de serveurs. Le système s'intègre parfaitement à la base de données de propriété de véhicules de QBCore tout en ajoutant des fonctionnalités essentielles telles que la persistance des dégâts, la sauvegarde de l'état du carburant, la gestion des mises en fourrière et la prise en charge de plusieurs garages sur l'ensemble de votre carte. Les joueurs peuvent accéder à leurs véhicules depuis n'importe quel emplacement de garage configuré, avec des systèmes intelligents qui suivent où chaque véhicule a été garé pour la dernière fois et empêchent les exploits de duplication.

Ce qui est inclus

BB Garages arrive comme un package complet prêt à être déployé immédiatement sur votre serveur. Le script inclut des emplacements de garage préconfigurés couvrant toutes les principales zones urbaines – le centre-ville de Los Santos, Sandy Shores, Paleto Bay, et des emplacements spécialisés comme les fourrières du LSPD et les garages privés premium. Chaque garage peut être personnalisé avec des points d'apparition de véhicules uniques, des restrictions d'accès (public, , emploi-verrouillé, verrouillé par gang, ou verrouillé par propriété), et une image de marque visuelle qui correspond à l'esthétique de votre serveur.

Le système est livré avec une UI intuitive qui affiche les informations du véhicule en un coup d'œil – nom du modèle, numéro de plaque, niveau de carburant actuel, état des dégâts et emplacement de stockage. Les joueurs peuvent prévisualiser les véhicules avant de les faire apparaître, voir quel garage contient chacune de leurs voitures et transférer des véhicules entre les emplacements de stockage (si configuré). Des outils administratifs sont intégrés directement dans le script, permettant au personnel de mettre des véhicules en fourrière, de faire apparaître de force les voitures des joueurs pour le dépannage et de surveiller l'utilisation des garages sur le serveur.

Caractéristiques principales

• Système de persistance des dégâts – Les véhicules conservent leur état de dégâts exact lorsqu'ils sont stockés, y compris les dégâts de carrosserie, la santé du moteur et les pièces cassées
• Sauvegarde de l'état du carburant – Les niveaux d'essence sont préservés lors du stockage des véhicules, empêchant l'exploit d'utiliser les garages pour faire le plein gratuitement
• Réseau multi-garages – Les joueurs accèdent à tous les véhicules possédés depuis n'importe quel garage public, ou configurent des garages privés pour un accès exclusif
• Système de mise en fourrière – Fonctionnalité de fourrière intégrée avec des frais configurables, , police-accès uniquement, et intégration de la dépanneuse
• Aperçu du véhicule – Visualisez les modèles de véhicules en 3D dans la UI avant de les faire apparaître, aidant les joueurs à identifier les voitures par leur apparence
• Gestion des Points de Spawn – La sélection intelligente de l'emplacement d'apparition empêche les collisions de véhicules et assure une apparition fluide
• Garages d'emploi – Configurez des garages dédiés pour la police, EMS, les mécaniciens et les emplois personnalisés avec accès aux véhicules de travail
• Garages de territoire de gang – Créez des emplacements de stockage spécifiques aux gangs auxquels seuls les membres peuvent accéder
• Intégration immobilière – Liez les garages aux scripts de logement pour un parking résidentiel privé
• Protection contre la duplication – Des vérifications robustes côté serveur empêchent les exploits de duplication de véhicules
• Système de transfert d'état – Les véhicules passent d'un état à l'autre (sorti, stocké, mis en fourrière) avec une journalisation complète
• Outils de migration de base de données – Inclut des scripts SQL pour convertir depuis les qb-garages par défaut ou d'autres systèmes de véhicules
• Commandes d'administration – Forcer l'apparition, la saisie, la suppression ou le transfert de véhicules avec des autorisations administratives
• Système de place de stationnement – Emplacements de stationnement optionnels où les joueurs peuvent stocker des véhicules en dehors des garages
• Performances optimisées – 0.00ms inactif, resmon minimal pendant les interactions avec le garage

Parfait pour

• Serveurs ayant besoin d'une gestion de véhicules fiable et professionnelle
• Serveurs passant de scripts de garage par défaut limités
• Communautés souhaitant un stockage de véhicules immersif avec persistance des dégâts/carburant
• Serveurs avec plusieurs villes ou grandes cartes nécessitant un accès distribué aux garages
• Serveurs axés sur l'économie où les frais de saisie et de récupération sont importants
• Serveurs exécutant des systèmes de logement qui nécessitent un stationnement intégré à la propriété
• Communautés avec des services de police actifs utilisant des mécanismes de saisie

Détails techniques

• Cadre: Conçu spécifiquement pour l'architecture QBCore
• Impact sur la performance : 0.00ms inactif, ~0.01-0.02ms pendant les interactions avec le garage
• Base de données: Table bbvehicles personnalisée ou configurable pour utiliser la structure player_vehicles existante
• Dépendances: Framework QBCore, qb-target ou ox_target pour les points d'interaction
• Intégrations optionnelles : qb-housing, qb-apartments, qb-policejob, qb-ambulancejob
• Personnalisation : Plus de 100 options de configuration pour les emplacements, les frais, les restrictions et le comportement

Migration de base de données facilitée

Passer à BB Garages depuis un autre système est simple grâce aux scripts de migration SQL inclus. Le package fournit des requêtes de conversion qui transfèrent toutes les données de véhicule de la table player_vehicles par défaut de qb-garages vers la structure optimisée bbvehicles. La migration préserve les informations critiques telles que la propriété (citizenid), les plaques d'immatriculation, les modèles de véhicules et les modifications/personnalisations.

Pour les serveurs exécutant actuellement player_vehicles, les commandes SQL fournies gèrent la conversion automatiquement. Le script copie en toute sécurité toutes les données de véhicule existantes, initialise les nouvelles colonnes de suivi des dégâts et du carburant, définit les états de stationnement par défaut pour les véhicules actuellement “ sortis ” dans le monde et attribue les statuts de saisie appropriés pour les véhicules manquants. Des requêtes de vérification post-migration sont incluses pour confirmer que tous les véhicules ont été transférés avec succès et qu'aucune donnée n'a été perdue lors du processus de conversion.

Installation

1. Extrayez bb-garages dans le dossier de ressources de votre serveur
2. Exécutez le fichier SQL fourni pour créer la table bbvehicles (ou utilisez des scripts de migration si vous convertissez à partir d'un système existant)
3. Configurez les emplacements des garages dans config.lua – des dizaines d'emplacements prédéfinis sont inclus
4. Configurez les emplacements des fourrières et les frais de récupération
5. Configurez les garages de travail pour la police, les EMS et les autres emplois du serveur
6. Ajoutez ‘ ensure bb-garages ’ à server.cfg et redémarrez
7. Test du stockage, de l'apparition et de la persistance de l'état des véhicules

Types et configurations de garages

BB Garages prend en charge plusieurs types de garages pour répondre aux différents besoins des serveurs. Les garages publics sont accessibles à tous les joueurs et affichent leurs véhicules civils personnels. Ces emplacements apparaissent généralement dans les parkings, le long des rues principales et dans les zones résidentielles. Les joueurs peuvent stocker et récupérer des véhicules depuis n'importe quel garage public, le système suivant l'emplacement qui détient actuellement chaque voiture.

Les garages de travail donnent accès aux véhicules de service pour la police, les EMS, les mécaniciens et les emplois personnalisés. Ces emplacements sont restreints par le nom de l'emploi et parfois par le grade de l'emploi, garantissant que seul le personnel autorisé peut faire apparaître des véhicules d'urgence ou des camions de travail. Les garages de travail peuvent puiser dans des pools de véhicules de travail partagés ou permettre aux employés de stocker des véhicules de travail personnels. Le système suit les apparitions de véhicules de travail pour éviter la duplication tout en permettant à plusieurs agents d'utiliser des voitures de patrouille identiques.

Les garages de gangs créent un stockage basé sur le territoire pour les organisations criminelles. Configurez ces garages dans les quartiers généraux de gangs ou les zones de territoire, en restreignant l'accès aux seuls membres. Les chefs de gangs peuvent utiliser ces emplacements pour stocker des ressources partagées comme des véhicules d'évasion, des camions blindés ou des voitures d'équipement spécialisé. Le script s'intègre à qb-gangs ou à des systèmes de gestion de gangs similaires pour vérifier l'appartenance avant d'accorder l'accès.

Les fourrières servent de stockage pénal pour les véhicules abandonnés, illégaux ou saisis par la police. Les joueurs doivent payer des frais configurables pour récupérer les voitures mises en fourrière, les coûts augmentant en fonction de la durée de la mise en fourrière du véhicule. La police peut mettre en fourrière les véhicules des joueurs via des commandes ou des scripts intégrés, les envoyant à la fourrière avec des notes visibles par les joueurs expliquant pourquoi leur voiture a été saisie. Les véhicules non réclamés peuvent être automatiquement supprimés après des périodes configurées pour maintenir la base de données propre.

Persistance des dégâts et du carburant

L'une des fonctionnalités les plus précieuses de BB Garages est la véritable persistance de l'état du véhicule. Lorsque les joueurs stockent un véhicule endommagé avec un pare-brise cassé, des ailes bosselées et une santé moteur de 40 %, cet état de dommage exact est enregistré dans la base de données. Lorsqu'ils récupèrent la voiture plus tard – même des jours plus tard depuis un garage différent – elle apparaît avec des dommages identiques. Cela crée des conséquences réalistes pour la conduite imprudente et encourage les joueurs à visiter les mécaniciens pour des réparations plutôt que d'utiliser le garage comme une réinitialisation gratuite.

La persistance du carburant fonctionne de la même manière. Une voiture stockée avec 15 % de carburant apparaît avec 15 % de carburant lorsqu'elle est récupérée. Les joueurs ne peuvent pas utiliser les garages pour remplir magiquement leurs réservoirs, ce qui maintient la valeur des stations-service et des mécanismes d'économie de carburant. Le système enregistre des pourcentages de carburant précis, et non des valeurs arrondies, garantissant la précision sur plusieurs cycles de stockage/récupération. Combiné à la persistance des dommages, cela crée une expérience de possession de véhicule réaliste où les voitures nécessitent un entretien et des soins réels.

Ce qui distingue BB Garages

BB Garages n'essaie pas de réinventer la gestion des véhicules – il la perfectionne. barbaroNN a construit ce système après avoir observé les limitations et les bugs dans d'innombrables scripts de garage sur des centaines de serveurs. Le résultat est un script qui gère tous les cas limites, prévient toutes les exploitations connues et offre des performances fluides et fiables sous une lourde charge de serveur. Duplication de véhicules ? Impossible avec la validation d'état intégrée. Camping de garage ? La randomisation de l'emplacement d'apparition l'empêche. Véhicules manquants ? Le système de fourrière les capture automatiquement.

L'architecture du script privilégie les performances du serveur sans sacrifier les fonctionnalités. La mise en cache intelligente réduit les requêtes de base de données, la communication client-serveur est optimisée pour minimiser la surcharge réseau, et le rendu de l'interface utilisateur utilise des frameworks efficaces qui ne font pas chuter les FPS. Même les serveurs avec des milliers de véhicules dans la base de données maintiennent des temps de chargement instantanés du menu du garage. Le code est propre, bien documenté et conçu pour une personnalisation facile par les développeurs de serveurs qui souhaitent ajouter des fonctionnalités uniques.

Le support de BB Garages va au-delà du dépannage de base. barbaroNN fournit une documentation complète couvrant chaque option de configuration, des exemples de configurations pour des scénarios courants et des guides vidéo pour des intégrations complexes. La communauté de support Discord comprend des propriétaires de serveurs qui ont mis en œuvre avec succès des configurations avancées comme le stationnement lié à la propriété, le stockage partagé de gangs et des systèmes de véhicules de travail personnalisés. Lorsque des mises à jour de framework arrivent, BB Garages reçoit rapidement des mises à jour de compatibilité, garantissant que votre système de véhicules ne tombe jamais en panne en raison de changements de FiveM.

Options de configuration avancées

Les propriétaires de serveurs peuvent affiner chaque aspect de l'expérience du garage via le fichier config.lua étendu. Définissez des frais de fourrière différents pour différentes classes de véhicules – des frais bon marché pour les voitures compactes, des frais coûteux pour les supercars. Configurez la durée pendant laquelle les véhicules peuvent rester avant la mise en fourrière automatique, encourageant les joueurs à utiliser régulièrement leurs voitures ou à risquer de perdre l'accès. Définissez des limites maximales de véhicules par joueur pour éviter le stockage excessif, ou créez des niveaux VIP avec une capacité de stockage accrue.

Le comportement des points d'apparition est entièrement configurable. Choisissez si les véhicules apparaissent à des emplacements fixes, à des endroits sélectionnés aléatoirement dans une zone, ou à l'espace disponible le plus proche du point d'interaction du garage. Définissez un espacement minimum entre les véhicules apparus pour éviter les collisions, configurez l'orientation d'apparition pour une orientation cohérente et définissez des emplacements d'apparition de secours si les emplacements primaires sont bloqués. Le système peut même valider que les emplacements d'apparition sont dégagés avant de tenter d'apparaître, évitant la frustration des véhicules apparaissant à l'intérieur d'autres voitures.

Le contrôle d'accès va au-delà des simples vérifications d'emploi. Configurez les garages pour exiger des objets spécifiques (permis de stationnement, clés de garage), facturer des frais d'accès à chaque ouverture du menu, ou limiter l'accès aux joueurs ayant certaines licences. Créez des garages premium qui facturent des frais de stockage tout en offrant des avantages comme des réparations gratuites ou des lavages cosmétiques. La flexibilité vous permet de créer des expériences de garage uniques qui correspondent à l'économie et au style de jeu de rôle de votre serveur.

Scripts de migration expliqués

Les scripts de migration fournis gèrent la complexité technique du passage à BB Garages. Le premier script crée la structure de la table bbvehicles avec des index appropriés pour les performances. Le deuxième script copie toutes les données de véhicule de player_vehicles vers bbvehicles, en faisant correspondre les colonnes et en convertissant les types de données si nécessaire. Le troisième script initialise de nouvelles colonnes comme les statistiques de dommages et les niveaux de carburant avec des valeurs par défaut sensées – en réglant le carburant à 100 % et les dommages au minimum pour les véhicules existants.

La logique de conversion d'état détermine si chaque véhicule migré doit être marqué comme stocké, sorti ou mis en fourrière en fonction de son état actuel dans l'ancien système. Les véhicules marqués comme stockés restent stockés. Les véhicules actuellement “ sortis ” dans le monde reçoivent un traitement spécial – ils peuvent être mis en fourrière automatiquement ou laissés dans un état “ sorti ” pour que les joueurs les stockent manuellement. Le champ d'emplacement de stationnement est défini de manière appropriée, les véhicules stockés étant attribués au garage le plus proche et les véhicules sortis étant marqués avec des données de stationnement vides jusqu'à ce qu'ils soient correctement stockés.

Aperçu vidéo

Référence de conversion de base de données

Convertir (enfin, en quelque sorte) exécuter 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

Scripts QBCore associés

• Machine à poinçonner V2
• Expédition de CD
• iFruitPods LMX
• Expédition de travaux de fret UZ

Convertir (enfin, en quelque sorte) exécuter 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