Comment mettre en place un système de garage sur FiveM (ESX et QBCore)

Un système de garage est indispensable à tout serveur roleplay — c’est ainsi que les joueurs conservent et utilisent réellement les véhicules qu’ils achètent. Ce tutoriel met un garage en place proprement sous ESX ou QBCore, et couvre les erreurs qui font « disparaître » les voitures.

Étape 1 — Dépendances

Les garages modernes dépendent généralement de :

• oxmysql (base de données)
• ox_lib (interface/menus)
• Votre framework (es_extended / qb-core / qbx_core)
• Un système de target pour l’interaction (par ex. ox_target) si le garage fonctionne au « regardez le marqueur pour ouvrir »

Vérifiez que tout ça démarre avant le garage.

Étape 2 — Ajouter la ressource + importer le SQL

1. Déposez le dossier du garage dans resources/.
2. Importez son .sql (les garages ajoutent généralement une table pour les véhicules rangés / l’état des garages). Sauvegardez d’abord.
3. S’il se branche sur votre table owned_vehicles existante, n’en créez pas de doublon — lisez la doc.

Étape 3 — Ordre de chargement

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_target
ensure mon-garage

Étape 4 — Configurer emplacements, apparitions et blips

C’est la partie qui rend un garage agréable :

• Emplacements des garages — les coordonnées où les joueurs ouvrent le menu.
• Points d’apparition — là où le véhicule apparaît physiquement. Dégagez-les de la géométrie pour que les voitures n’apparaissent pas dans un mur.
• Blips — les marqueurs sur la carte pour que les joueurs trouvent les garages.
• Catégories de véhicules — voitures, bateaux, aéronefs dans des garages séparés si votre script le gère.
• Fourrière / véhicules perdus — où vont les voitures détruites, et le tarif pour les récupérer.

Étape 5 — Tester la boucle complète

• Achetez ou faites apparaître un véhicule possédé.
• Rangez-le au garage.
• Reconnectez-vous, rouvrez le garage, récupérez le même véhicule (bonne plaque, état des dégâts si géré).
• Détruisez une voiture et récupérez-la à la fourrière.

Si une voiture rangée ne revient pas, c’est presque toujours une plaque qui ne correspond pas entre la table du garage et votre table de propriété.

Choisir un script de garage

Les garages par défaut des frameworks fonctionnent mais font daté. Les options payantes ajoutent des intérieurs personnalisables, des garages partagés / de gang, la gestion des plaques et une interface moderne. Des options payantes reconnues existent dans tout l’écosystème ; un choix soigné et multi-framework est Quasar Garages, qui propose des garages personnels décorés, plusieurs intérieurs IPL et des permissions d’accès — à voir sur la Quasar Store. Quoi que vous choisissiez, vérifiez son resmon en charge, car un garage qui fait des vérifications de distance à chaque frame peut coûter des FPS en silence — voyez notre guide d’optimisation.

La suite

Un garage n’est qu’une pièce d’une expérience véhicule cohérente. Associez-le à un HUD propre et à un inventaire solide (pour le coffre), et vous avez les fondations d’une économie roleplay crédible.