> For the complete documentation index, see [llms.txt](https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/bsensei-vehicle-control-controle-complet-des-vehicules/dependances-necessaires.md).

# Dépendances nécessaires

## 🧩 Dépendances nécessaires

Pour fonctionner correctement, **BSensei Vehicle Control** nécessite très peu de ressources externes.

Le script ne demande aucune base de données, aucun système Target et aucun inventaire particulier.

***

### 📦 Dépendances obligatoires

Les éléments suivants sont indispensables :

```
ESX Legacy
OneSync
```

La ressource ESX doit porter par défaut le nom :

```
es_extended
```

Le fichier `fxmanifest.lua` vérifie automatiquement leur présence :

```lua
dependencies {
    'es_extended',
    '/onesync'
}
```

***

### 🧠 ESX Legacy

**BSensei Vehicle Control** utilise ESX pour initialiser certaines fonctions du script et afficher les notifications natives lorsque ce système est sélectionné.

Ressource nécessaire :

```
es_extended
```

Ordre conseillé dans le `server.cfg` :

```
ensure es_extended
ensure BSensei_vehicle_control
```

⚠️ `es_extended` doit démarrer avant Vehicle Control.

***

### 🌐 OneSync

OneSync est obligatoire pour assurer la synchronisation correcte des véhicules entre les joueurs.

Il est notamment utilisé pour :

* synchroniser l’ancre des bateaux ;
* immobiliser correctement les jet-skis ;
* maintenir les hélicoptères en stationnaire ;
* conserver le stationnaire lors d’un changement de siège ;
* désactiver le stationnaire lorsque l’hélicoptère est vide ;
* synchroniser certains états du véhicule.

Sur la majorité des serveurs récents utilisant txAdmin, OneSync est déjà activé.

Si la ressource refuse de démarrer avec une erreur concernant :

```
/onesync
```

vérifie que OneSync est bien activé dans la configuration de ton serveur.

***

### 🔔 Dépendances facultatives

Certaines ressources sont uniquement nécessaires selon le système de notifications sélectionné.

Systèmes disponibles :

```
esx
ox_lib
okokNotify
custom
```

La sélection s’effectue dans :

```
BSensei_vehicle_control/config.lua
```

Exemple :

```lua
Config.Notifications.System = 'esx'
```

***

### 🟦 Notifications ESX

Avec la configuration par défaut :

```lua
Config.Notifications.System = 'esx'
```

Aucune ressource supplémentaire n’est nécessaire en dehors de :

```
es_extended
```

Ordre conseillé :

```
ensure es_extended
ensure BSensei_vehicle_control
```

***

### 🔴 Notifications `ox_lib`

Si tu sélectionnes :

```lua
Config.Notifications.System = 'ox_lib'
```

La ressource suivante devient nécessaire :

```
ox_lib
```

Ordre conseillé :

```
ensure ox_lib
ensure es_extended
ensure BSensei_vehicle_control
```

Vérifie également le nom configuré :

```lua
Config.Notifications.Resources.OxLib = 'ox_lib'
```

***

### 🟢 Notifications `okokNotify`

Si tu sélectionnes :

```lua
Config.Notifications.System = 'okokNotify'
```

La ressource suivante devient nécessaire :

```
okokNotify
```

Ordre conseillé :

```
ensure okokNotify
ensure es_extended
ensure BSensei_vehicle_control
```

Vérifie également :

```lua
Config.Notifications.Resources.OkOkNotify = 'okokNotify'
```

***

### 🛠️ Notifications personnalisées

Pour utiliser ton propre système :

```lua
Config.Notifications.System = 'custom'
```

L’intégration doit être réalisée dans :

```
BSensei_vehicle_control/client/editable.lua
```

La ressource de ton système personnalisé doit démarrer avant Vehicle Control.

Exemple :

```
ensure mon_hud
ensure es_extended
ensure BSensei_vehicle_control
```

***

### 🗄️ Base de données

**Aucun fichier SQL n’est nécessaire.**

Le script n’utilise pas :

```
oxmysql
mysql-async
ghmattimysql
```

Les préférences de l’interface sont enregistrées localement avec le système KVP de FiveM.

Cela comprend notamment :

```
La taille du menu
L’opacité
La couleur principale
L’arrondi
La position de l’interface
```

***

### 🎯 Système Target

Aucun système Target n’est nécessaire.

Le script n’utilise pas :

```
ox_target
qb-target
qtarget
```

Le menu s’ouvre avec :

```
F5
```

ou :

```
/vehiclemenu
```

***

### 🎒 Système d’inventaire

Aucun inventaire particulier n’est nécessaire.

Le script n’utilise pas :

```
ox_inventory
qs-inventory
qb-inventory
esx_inventory
```

Vehicle Control agit directement sur les véhicules présents en jeu.

***

### 🖥️ Interface NUI

L’interface est directement incluse dans la ressource :

```
BSensei_vehicle_control/html/
```

Elle contient :

```
index.html
style.css
app.js
```

Aucune ressource externe n’est nécessaire pour son fonctionnement.

⚠️ Ne supprime pas ou ne déplace pas ces fichiers.

***

### 💜 Script de customisation des néons

Un script de customisation n’est pas obligatoire pour démarrer Vehicle Control.

Cependant, pour détecter précisément les néons installés, ton système de tuning doit utiliser l’export suivant :

```lua
exports['BSensei_vehicle_control']:SetNeonInstalled(vehicle, true)
```

Lors du retrait des néons :

```lua
exports['BSensei_vehicle_control']:SetNeonInstalled(vehicle, false)
```

Cette intégration peut être utilisée avec n’importe quel script de customisation accessible et modifiable.

***

### 🚫 Ressources non nécessaires

Dans sa configuration par défaut, le script ne nécessite pas :

```
ox_lib
oxmysql
ox_target
ox_inventory
qb-core
qb-target
qs-dispatch
okokNotify
```

`ox_lib` et `okokNotify` deviennent uniquement nécessaires lorsqu’ils sont sélectionnés pour les notifications.

***

### ⚙️ Ordre de démarrage conseillé

#### Configuration minimale

```
ensure es_extended
ensure BSensei_vehicle_control
```

#### Avec `ox_lib`

```
ensure ox_lib
ensure es_extended
ensure BSensei_vehicle_control
```

#### Avec `okokNotify`

```
ensure okokNotify
ensure es_extended
ensure BSensei_vehicle_control
```

***

### ✅ Vérification des dépendances

Depuis la console serveur :

```
refresh
ensure es_extended
ensure BSensei_vehicle_control
```

Vérifie qu’aucune erreur similaire n’apparaît :

```
Couldn't find dependency es_extended
```

```
Required feature /onesync is not available
```

```
No such export
```

Teste ensuite en jeu :

```
/vehiclemenu
```

***

### 🚨 En cas de problème

* Vérifie que `es_extended` est démarré
* Vérifie que OneSync est activé
* Contrôle le nom exact du dossier `BSensei_vehicle_control`
* Vérifie l’ordre des ressources dans le `server.cfg`
* Démarre le système de notifications sélectionné
* Assure-toi que l’asset est téléchargé avec le bon compte Cfx.re
* Consulte la console serveur
* Consulte la console F8
* Teste avec un véhicule GTA natif
* Redémarre complètement le serveur si nécessaire

***

➡️ **Étape suivante : FAQ & problèmes fréquents**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/bsensei-vehicle-control-controle-complet-des-vehicules/dependances-necessaires.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
