> ## 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.

# Installation

> Installez RCO Creator sur RSG Core ou VORP Core.

Quelques minutes suffisent. Choisissez votre framework ci-dessous — seules les étapes qui diffèrent sont séparées en onglets.

<Info>
  Creator a besoin de [RCO Appearance](/fr/rco-appearance/installation) installé avant. Même téléchargement, même dossier — Appearance avant Creator.
</Info>

<Warning>
  Vous utilisez déjà un multichar ou un spawn personnalisé ? Ne faites pas `ensure` Creator sur un serveur live en espérant que ça passe. Arrêtez les anciennes ressources, testez sur une copie, puis basculez la production.
</Warning>

## Ce qu'il faut désactiver

Creator remplace la sélection et le spawn **stock** de votre framework. S'ils démarrent encore, deux systèmes se battent pour le même joueur — ou Creator refuse de démarrer.

| Resource             | RSG         | VORP        | Pourquoi                           |
| -------------------- | ----------- | ----------- | ---------------------------------- |
| `rsg-multicharacter` | **Arrêter** | —           | Creator gère la sélection          |
| `rsg-spawn`          | **Arrêter** | —           | Creator gère le spawn              |
| `rsg-appearance`     | **Arrêter** | —           | Utilisez rco-appearance            |
| `rsg-wardrobe`       | **Arrêter** | —           | Garde-robe dans Appearance         |
| `rsg-barbers`        | **Arrêter** | —           | Barbiers dans Appearance           |
| `vorp_character`     | —           | **Arrêter** | Creator + Appearance le remplacent |
| `vorp_barbershop`    | —           | **Arrêter** | Barber shop séparé                 |
| `vorp_clothingstore` | —           | **Arrêter** | Anciennes boutiques                |
| `vorp_stores`        | —           | **Garder**  | Boutiques générales — sans lien    |

Vous pouvez laisser les anciens dossiers sur le disque. L'important : ils ne doivent **pas** figurer dans votre liste `ensure`.

### À propos de `provide` (version courte)

Appearance indique au serveur qu'il *répond pour* des noms comme `rsg-appearance` et `vorp_character`. Les scripts avec `dependency 'rsg-appearance'` résolvent vers **rco-appearance**.

Ce n'est **pas** « lancer RCO **et** le stock ensemble ». Arrêtez quand même le stock. Deux systèmes de personnage = données cassées.

<Steps>
  <Step title="Télécharger et extraire">
    Depuis [Keymaster](https://keymaster.fivem.net/), placez les deux dossiers dans votre répertoire resources :

    ```text theme={"dark"}
    resources/
    └── [rco]/
        ├── rco-appearance/
        └── rco-creator/
    ```

    Gardez les noms de dossiers exactement tels qu'expédiés.
  </Step>

  <Step title="Arrêter les ressources stock">
    Commentez ou supprimez les lignes conflictuelles dans `server.cfg` (voir le tableau ci-dessus).

    <Tabs>
      <Tab title="RSG Core">
        ```cfg theme={"dark"}
        # ensure rsg-multicharacter
        # ensure rsg-spawn
        # ensure rsg-appearance
        # ensure rsg-wardrobe
        # ensure rsg-barbers
        ```
      </Tab>

      <Tab title="VORP Core">
        ```cfg theme={"dark"}
        # ensure vorp_character
        # ensure vorp_barbershop
        # ensure vorp_clothingstore
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Ajouter au démarrage">
    L'ordre compte : base de données → core framework → Appearance → Creator.

    <Tabs>
      <Tab title="RSG Core">
        ```cfg theme={"dark"}
        ensure oxmysql
        ensure rsg-core
        ensure rco-appearance
        ensure rco-creator
        ```
      </Tab>

      <Tab title="VORP Core">
        ```cfg theme={"dark"}
        ensure oxmysql
        ensure vorp_core
        ensure rco-appearance
        ensure rco-creator
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Base de données">
    Sur un serveur normal, **pas** d'import SQL à la main. Le premier démarrage crée les tables Creator.

    Votre utilisateur MySQL doit pouvoir créer et modifier des tables (la plupart des hébergeurs le permettent déjà). Si votre hébergeur bloque tout, utilisez les fichiers SQL fournis — sinon le démarrage vous le dira clairement au lieu d'échouer en silence.

    Appearance crée aussi ses propres tables — voir [installation Appearance](/fr/rco-appearance/installation).
  </Step>

  <Step title="Vérification rapide de la config">
    Ouvrez `rco-creator/config/config.lua`. Les valeurs par défaut fonctionnent. Avant le premier restart, jetez un œil à ces deux lignes :

    ```lua theme={"dark"}
    Config.Framework = 'auto' -- laissez sur auto
    Config.Debug = false      -- true seulement pendant un dépannage
    ```

    Tout le reste : [Configuration](/fr/rco-creator/configuration).
  </Step>

  <Step title="Redémarrer et tester">
    Redémarrez le serveur, connectez-vous — vous devriez arriver sur la sélection de personnage. Créez un personnage, choisissez un spawn, confirmez que vous êtes dans le monde avec le contrôle.

    Ancien sélecteur, écran noir ou rien ? [Dépannage](/fr/rco-creator/troubleshooting).
  </Step>
</Steps>

## Optionnel : qui peut éditer les spawns en jeu

Les admins utilisent `/rcospawns` pour déplacer les points de spawn sur la carte. Par défaut, le groupe `admin` du framework suffit. Pour accorder explicitement :

```cfg theme={"dark"}
add_ace group.admin rco.creator.spawns allow
```

Plus d'infos dans [Emplacements de spawn](/fr/rco-creator/spawn-locations).

## Versions du package et version checker

RCO Creator + RCO Appearance sont publiés comme une seule release **RCO Identity**. Mettez toujours les deux resources à jour ensemble.

Creator compare les versions locales de `rco-creator` et `rco-appearance`. En cas de différence :

```text theme={"dark"}
[RCO Identity] Resource version mismatch: rco-creator v1.7.1 / rco-appearance v1.7.0. Update the complete RCO Identity package.
```

Ne corrigez pas cela en modifiant seulement le numéro dans `fxmanifest.lua` ; installez les fichiers correspondants de la même release.

Seul `rco-creator` effectue une requête server-side au démarrage pour vérifier la release publique actuelle :

```text theme={"dark"}
[RCO Identity] RCO Identity is up to date (v1.7.1).
```

Le check est informatif : aucune donnée player/character n'est envoyée, aucune requête par joueur, aucun polling permanent, et RCO continue si le metadata distant est indisponible.