> 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/informations-general/faq.md).

# FAQ

## ❓ FAQ & Erreurs fréquentes

Voici la liste des erreurs les plus courantes rencontrées lors de l’installation ou du démarrage d’une ressource **FiveM**. Chaque message est accompagné de sa cause et de la solution recommandée.

***

### ⚠️ Erreurs courantes au démarrage

#### 🧩 `Couldn't start resource bsensei_script`

👉 **Cause :** Le dossier de la ressource est mal placé ou mal nommé.\
💡 **Solution :** Vérifiez que le dossier soit directement dans `/resources` et qu’il ne soit pas imbriqué dans un autre dossier du même nom.

***

#### 📦 `No such export ... in resource ox_lib`

👉 **Cause :** La ressource `ox_lib` n’est pas démarrée avant votre script.\
💡 **Solution :** Ouvrez votre `server.cfg` et assurez-vous que `ensure ox_lib` soit placé avant votre ressource.

***

#### ❌ `attempt to index a nil value (global 'ESX')`

👉 **Cause :** Le framework `ESX` n’est pas chargé correctement ou est lancé après votre ressource.\
💡 **Solution :** Vérifiez que `ensure es_extended` soit présent et placé avant la ligne de votre script dans le `server.cfg`.

***

#### 🪛 `nil value (field 'RegisterNetEvent')`

👉 **Cause :** Votre ressource est probablement configurée en `fxmanifest.lua` mais lancée avec une version obsolète de l’artifact FiveM.\
💡 **Solution :** Mettez à jour votre serveur vers la dernière version stable de FXServer (artifact récent).

***

#### 💥 `Invalid resource manifest found`

👉 **Cause :** Votre fichier `fxmanifest.lua` est mal écrit ou utilise un format non reconnu.\
💡 **Solution :** Vérifiez la première ligne :

```
fx_version 'cerulean'
game 'gta5'
```

Et assurez-vous qu’il n’y ait aucune faute de frappe ni guillemets oubliés.

***

#### 🔍 `attempt to call a nil value (global 'exports')`

👉 **Cause :** Une dépendance (souvent `ox_lib` ou `ox_target`) n’est pas active.\
💡 **Solution :** Vérifiez que toutes les dépendances sont bien présentes et démarrées avant votre ressource.

***

#### 🧠 `Couldn’t find resource ...`

👉 **Cause :** Le nom du dossier dans `/resources` ne correspond pas au nom du manifest.\
💡 **Solution :** Vérifiez que le nom du dossier et celui du manifest sont identiques :

```
resource_manifest_version '44febabe-d386-4d18-afbe-5e627f4af937'
```

***

### 💬 Problèmes liés au gameplay ou au chargement

#### 🎯 `Target not found`

👉 **Cause :** Vous utilisez `ox_target` mais la ressource n’est pas configurée dans votre `config.lua`.\
💡 **Solution :** Vérifiez que l’option `Config.UseTarget = true` soit bien activée et que `ox_target` soit chargé avant.

***

#### 💾 `Invalid item name`

👉 **Cause :** L’item utilisé n’existe pas dans votre base de données ou inventaire (ESX / OX Inventory).\
💡 **Solution :** Ajoutez l’item manquant dans votre table `items` ou fichier de config d’inventaire.

***

#### 🧾 `TriggerServerEvent(...) was not found`

👉 **Cause :** Le script client appelle un event serveur qui n’existe plus (souvent après une mise à jour).\
💡 **Solution :** Mettez à jour le client et le serveur en même temps, et comparez vos fichiers pour repérer les events manquants.

***

#### 🔒 `Access denied for command ensure`

👉 **Cause :** Vous essayez d’exécuter la commande `ensure` depuis la console du client au lieu du serveur.\
💡 **Solution :** Les commandes `ensure` ou `restart` doivent être exécutées depuis la console serveur.

***

### 🆘 Toujours bloqué ?

Si aucune de ces solutions n’a fonctionné :

* Vérifiez la section **Dépendances & Compatibilité** de cette documentation.
* Consultez le fichier `server.log` pour repérer le message exact d’erreur.
* Rejoignez le [serveur Discord](https://discord.gg/4kQQJPyJPJ) et envoyez votre erreur complète pour une aide rapide.

***

<p align="center">🛒 <a href="https://sensei-scripts-store.tebex.io/">Accéder à la Boutique</a>   •   💬 <a href="https://discord.gg/4kQQJPyJPJ">Rejoindre le Support</a></p>


---

# 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/informations-general/faq.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.