> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Tout ce que vous pouvez modifier dans config/config.lua, expliqué simplement.

Tous les réglages sont dans un seul fichier : `rco-vehicles/config/config.lua`. Ouvrez-le avec n'importe quel éditeur de texte (le Bloc-notes suffit, VS Code est plus confortable).

<Tip>
  Ne modifiez que ce qui se trouve après le signe `=`. Gardez les guillemets `'...'`, les virgules et les accolades tels quels. Après avoir enregistré, redémarrez le serveur.
</Tip>

<Note>
  Les commentaires du fichier sont en anglais. Cette page explique chaque réglage en français.
</Note>

## L'essentiel

| Réglage | À quoi il sert | Par défaut |
| - | - | - |
| `Config.Locale` | Langue des menus : `'en'` ou `'pt-br'` | `'en'` |
| `Config.StoreName` | Le nom de votre boutique, en haut de chaque menu | `'Rust & Co.'` |
| `Config.Framework` | Laissez `'auto'`. N'écrivez `'rsg'` ou `'vorp'` que si le script se trompe | `'auto'` |
| `Config.Debug` | Mode d'aide pour la mise en place (voir « Placer les concessionnaires et les garages » plus bas). Désactivez-le avant d'ouvrir aux joueurs | `false` |

### Une autre langue

Copiez `locales/en.json`, traduisez les textes à droite de chaque ligne, enregistrez par exemple sous `locales/fr.json` et mettez `Config.Locale = 'fr'`. Ce que vous ne traduisez pas s'affiche en anglais.

## Argent et limites

| Réglage | À quoi il sert | Par défaut |
| - | - | - |
| `Config.MoneyAccount` | L'argent qui paie les véhicules. RSG : `'cash'`, `'bank'`, `'gold'` ou un autre type d'argent de votre serveur. VORP : `'cash'` ou `'gold'` | `'cash'` |
| `Config.MaxVehicles` | Nombre de véhicules qu'un personnage peut posséder | `10` |
| `Config.MovePrice` | Prix pour faire venir un véhicule du garage d'une autre ville. `0` = gratuit | `1` |

## Prix

Chaque véhicule RCO a déjà son prix. Vous ne touchez cette liste que pour **changer** un prix :

```lua theme={"dark"}
Config.Prices = {
    wanderer = 25,    -- nom du véhicule = nouveau prix
}
```

Le nom du véhicule est le nom du modèle (le vélo Wanderer est `wanderer`). Un véhicule absent de la liste garde son propre prix.

## Touches et distances

| Réglage | À quoi il sert | Par défaut |
| - | - | - |
| `Config.OpenKey` | Touche pour ouvrir un concessionnaire ou un garage, à pied | **J** |
| `Config.StoreKey` | Touche pour ranger le véhicule sur lequel vous êtes, au garage | **R** |
| `Config.InteractDistance` | À combien de mètres du point du concessionnaire ou du garage le joueur doit se tenir | `2.0` |
| `Config.StoreDistance` | À combien de mètres du point du garage le véhicule doit être pour être rangé | `15.0` |
| `Config.TransferDistance` | À combien de mètres l'autre joueur doit être pour recevoir un véhicule | `5.0` |

<Note>
  Les touches s'écrivent avec le code de contrôle du jeu (comme `0xF3830D8E`), pas avec la lettre. Ne les changez que si vous connaissez le code de la touche voulue. La touche de rangement doit être une touche que le jeu lit quand on est sur un véhicule : le J, par exemple, ne marche pas sur un véhicule.
</Note>

## Garages

Chaque garage est un bloc comme celui-ci :

```lua theme={"dark"}
valentine = {
    label = 'Valentine',
    coords = vector3(-179.53, 648.90, 113.58),
    spawn = vector4(-179.87, 653.14, 113.65, 136.06),
    blip = true,
},
```

| Ligne | Ce qu'elle veut dire |
| - | - |
| `valentine` | Le nom court du garage. En minuscules, sans espace |
| `label` | Le nom que voit le joueur |
| `coords` | Où le joueur se tient pour ouvrir le garage |
| `spawn` | Où le véhicule apparaît quand on le sort. Le dernier nombre est la direction vers laquelle il regarde |
| `blip` | `true` l'affiche sur la carte, `false` le cache |

Choisissez un `spawn` avec environ 6 mètres libres autour et rien de bas au-dessus : le menu du garage y montre le véhicule avec la caméra qui tourne autour.

<Warning>
  Chaque véhicule retient le **nom court** de son garage. Si vous renommez `valentine`, les véhicules rangés là disparaissent de ce garage. Pour ajouter un garage, ajoutez un nouveau bloc avec un nouveau nom court.
</Warning>

Sept garages sont fournis : Saint Denis, Rhodes, Valentine, Annesburg, Blackwater, Strawberry et Armadillo.

## Concessionnaires

Ils fonctionnent comme les garages, avec quelques lignes en plus :

| Ligne | Ce qu'elle veut dire |
| - | - |
| `label` | Le nom que voit le joueur |
| `coords` | Où le joueur se tient pour ouvrir le concessionnaire |
| `range` | À combien de mètres de `coords` il s'ouvre. Retirez la ligne pour utiliser `Config.InteractDistance` |
| `preview` | Où se tient le véhicule exposé pendant que le joueur choisit |
| `npc` | Le vendeur (un modèle de personnage du jeu). Retirez la ligne pour ne pas avoir de vendeur |
| `chair` | Facultatif : la chaise sur laquelle le vendeur s'assoit. Sans elle, il cherche un siège à proximité |
| `garage` | Le garage (nom court) qui garde les véhicules achetés ici |
| `delivery` | Où le nouveau véhicule est remis juste après l'achat. Retirez la ligne pour le remettre au garage |
| `categories` | Les types de véhicules vendus ici, par exemple `{ 'bicycle' }`. `nil` vend tout |
| `blip` | `true` l'affiche sur la carte |
| `lift` | Uniquement pour la boutique de Saint Denis fournie avec la ressource : le véhicule exposé monte sur une plateforme. Ne le copiez pas vers d'autres concessionnaires |

Le script recale les hauteurs sur le sol : une `z` décalée d'un mètre ne pose pas de problème. L'exception est le concessionnaire de Saint Denis : son `preview` doit rester exact, car c'est le dessus de la plateforme.

## Placer les concessionnaires et les garages

La façon simple d'obtenir les chiffres d'un nouvel emplacement :

<Steps>
  <Step title="Activez le mode d'aide">
    Mettez `Config.Debug = true` et redémarrez le serveur.
  </Step>

  <Step title="Placez-vous à l'endroit voulu">
    En jeu, allez là où le garage (ou le véhicule) doit se trouver, tourné dans la direction voulue.
  </Step>

  <Step title="Copiez votre position">
    Tapez `/vehicles_here` dans le chat, ouvrez la console F8 et copiez la ligne affichée dans la configuration.
  </Step>

  <Step title="Désactivez le mode d'aide">
    Remettez `Config.Debug = false` avant d'ouvrir le serveur aux joueurs.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.