> 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/metiers-and-missions/editor/configuration.md).

# Configuration

## ⚙️ Configuration complète du script

Le fichier `config.lua` te permet de personnaliser le comportement du script **BSensei EMS** selon les besoins de ton serveur.\
Chaque option est expliquée ci-dessous pour t’aider à tout régler rapidement.

***

### 📁 Localisation du fichier

Le fichier se trouve ici :

```plaintext
bsensei_ems/config.lua
```

### 🔧 Structure du fichier

Voici la structure complète du `config.lua` avec les explications associées 👇

```lua
Config = {}

-- Langue utilisée pour les notifications et textes
Config.Locale = "fr"

-- Nom du job EMS (doit correspondre à celui défini dans la base de données ESX)
Config.EMSJob = "ambulance"

-- Délai (en secondes) entre chaque mission générée
Config.MissionCooldown = 120

-- Nombre maximum de missions actives simultanément
Config.MaxMissions = 3

-- Paiement de base par mission (ajustable selon ton économie)
Config.BaseReward = 500

-- Bonus de distance (ajouté au paiement selon la distance parcourue)
Config.DistanceBonus = true

-- Coordonnées de l’hôpital (point de dépôt des patients)
Config.HospitalCoords = vector3(298.44, -584.89, 43.26)

-- Liste des véhicules autorisés pour les missions EMS
Config.AllowedVehicles = {
    "ambulance",
    "emsnspeedo",
    "emssprinter"
}

-- Système de notification (choisir entre "ox", "okok", ou "esx")
Config.NotifySystem = "ox"

-- Active ou désactive le debug mode (affiche les logs dans la console)
Config.Debug = false
```

### 💬 Détails des options

#### 🌍 `Config.Locale`

Langue utilisée pour les textes et notifications du script.\
Actuellement : `"fr"` ou `"en"`.

#### 🚑 `Config.EMSJob`

Détermine le **nom du métier EMS** utilisé par ton serveur.\
Exemple :

```lua
Config.EMSJob = "ambulance"
```

➡️ Ce nom doit être identique à celui défini dans ta base de données ESX (`jobs`).

#### ⏱️ `Config.MissionCooldown`

Délai en secondes entre deux nouvelles missions.\
Permet d’éviter que les joueurs soient submergés d’appels.

#### 📊 `Config.MaxMissions`

Nombre maximum de missions EMS actives en même temps.\
Utile pour limiter la charge serveur ou le désordre RP.

#### 💵 `Config.BaseReward`

Montant de base reçu après avoir terminé une mission.\
💡 Tu peux combiner cette valeur avec le bonus de distance.

#### 📏 `Config.DistanceBonus`

Active un bonus basé sur la distance parcourue entre le lieu d’intervention et l’hôpital.\
Mettre `true` pour activer, `false` pour désactiver.

#### 🏥 `Config.HospitalCoords`

Coordonnées exactes de l’hôpital où les patients doivent être déposés.\
Si ton serveur utilise un mapping différent, adapte ces valeurs.

#### 🚐 `Config.AllowedVehicles`

Liste blanche des véhicules autorisés à lancer des missions EMS.\
Les autres véhicules ne déclencheront pas le script.

#### 🔔 `Config.NotifySystem`

Système de notification utilisé pour les messages en jeu :

* `"ox"` → utilise **ox\_lib.notify**
* `"okok"` → utilise **okokNotify**
* `"esx"` → utilise **ESX.ShowNotification**

💡 Choisis celui correspondant à ton serveur.\
Si tu utilises un autre système, tu peux le modifier dans `notify.lua`.

#### 🧠 `Config.Debug`

Mode développeur.\
Quand activé (`true`), affiche dans la console tous les événements, chargements et triggers du script.

### 🧰 Exemple de configuration personnalisée

Voici un exemple prêt à l’emploi pour un serveur RP dynamique :

```lua
Config.Locale = "fr"
Config.EMSJob = "ambulance"
Config.MissionCooldown = 90
Config.MaxMissions = 5
Config.BaseReward = 650
Config.DistanceBonus = true
Config.HospitalCoords = vector3(312.44, -597.89, 43.28)
Config.AllowedVehicles = {"ambulance", "emsnspeedo"}
Config.NotifySystem = "okok"
Config.Debug = false
```

***

<p align="center">➡️ Étape suivante : Systeme de notifications</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/metiers-and-missions/editor/configuration.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.
