> 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/illegal-and-criminalite/bsensei-npc-robbery-braquage-de-citoyens-immersif/installation.md).

# Installation

## ⚡ Installation du script BSensei NPC Robbery

Bienvenue dans le guide d’installation du script **BSensei NPC Robbery**.\
Suis attentivement chaque étape pour garantir un fonctionnement optimal.

***

### 🧩 Étape 1 – Dépôt du script

Place le dossier du script dans ton répertoire :

```
resources/[bsensei]/BSensei_npcrobbery
```

⚠️ **Attention :**\
Conserve exactement le nom du dossier : `BSensei_npcrobbery`.\
Cela évitera les problèmes lors des mises à jour ou avec le système FiveM Asset Escrow.

***

### ⚙️ Étape 2 – Ajout dans le `server.cfg`

Ouvre ton fichier `server.cfg` et ajoute la ligne suivante :

```
ensure BSensei_npcrobbery
```

💡 **Astuce :**\
Si tu utilises une structure de dossiers comme `[scripts]` ou `[illegal]`, assure-toi que le script est bien chargé **après ses dépendances** (`ox_lib`, `ox_target`, framework, etc.).

***

### 🔧 Étape 3 – Installation des dépendances

Assure-toi d’avoir ces ressources installées et démarrées avant le script :

* `ox_lib`
* `ox_target`
* `es_extended` pour ESX Legacy\
  ou
* `qb-core` pour QBCore

Selon ta configuration, certaines ressources peuvent également être nécessaires :

* `ox_inventory`
* `qs-dispatch`
* `okokNotify`

Tu peux vérifier leur bon fonctionnement avec les commandes :

```
refresh
ensure ox_lib
ensure ox_target
ensure es_extended
ensure BSensei_npcrobbery
```

Pour une base QBCore, remplace simplement `es_extended` par `qb-core`.

***

### 🧠 Étape 4 – Vérification de l’installation

Une fois ton serveur démarré :

1. Connecte-toi en jeu.
2. Approche-toi d’un PNJ compatible.
3. Vérifie que l’interaction de braquage apparaît avec `ox_target`.
4. Lance le braquage.
5. Vérifie le mini-jeu, la réaction du PNJ et les récompenses.
6. Contrôle l’alerte police si le dispatch est activé.

✅ Si l’interaction apparaît et qu’aucune erreur ne s’affiche dans les consoles client ou serveur, le script est correctement installé 🎉

***

### ❌ Mauvais exemple

Exemple de mauvaise installation à ne pas faire :

```
resources/BSensei_npcrobbery/BSensei_npcrobbery
```

ou :

```
start BSensei_npcrobbery
```

Utilise toujours :

```
ensure BSensei_npcrobbery
```

***

### 🚨 En cas de problème

* Vérifie le nom exact du dossier : `BSensei_npcrobbery`
* Assure-toi que `ox_lib` et `ox_target` sont démarrés
* Vérifie que ton framework est correctement sélectionné
* Contrôle que les objets configurés existent dans ton inventaire
* Consulte les consoles client et serveur
* Vérifie que le script démarre après toutes ses dépendances
* Si le problème persiste, contacte le support sur le Discord

***

➡️ **Étape suivante : Configuration complète du script**


---

# 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/illegal-and-criminalite/bsensei-npc-robbery-braquage-de-citoyens-immersif/installation.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.