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

# Dépannage

> Problèmes courants de RCO Creator et comment les résoudre.

Avant toute chose : définissez `Config.Debug = true` dans `rco-creator/config/config.lua`, redémarrez la ressource et reproduisez le problème. Creator affiche ce qu'il fait et pourquoi il a rejeté quelque chose. La plupart des problèmes deviennent évidents à partir de cette sortie.

Si vous êtes bloqué, ouvrez un ticket sur [Discord](https://discord.gg/j67u6pbnDs) avec la sortie console, votre framework et ce que vous attendiez.

## Démarrage

<AccordionGroup>
  <Accordion title="Creator ne démarre pas : 'rco-appearance' is not started">
    Creator déclare une dépendance à `rco-appearance`. Assurez-vous qu'Appearance est installé et apparaît **au-dessus** de Creator dans votre liste de démarrage :

    ```cfg theme={"dark"}
    ensure rco-appearance
    ensure rco-creator
    ```
  </Accordion>

  <Accordion title="'rsg-core must start before rco-creator' ou 'vorp_core must start before rco-creator'">
    Le core de votre framework démarre après nos ressources. Placez `ensure rsg-core` (ou `ensure vorp_core`) au-dessus de `rco-appearance` et `rco-creator`.
  </Accordion>

  <Accordion title="'both supported cores are started; set Config.Framework explicitly'">
    Votre `server.cfg` démarre `rsg-core` et `vorp_core` ensemble. Supprimez le `ensure` du framework que vous n'utilisez **pas**. RSG : uniquement `rsg-core` ; VORP : uniquement `vorp_core`.
  </Accordion>

  <Accordion title="'stop the stock vorp_character resource before starting this pack' (VORP)">
    Le `vorp_character` d'origine tourne encore. Supprimez `ensure vorp_character` de votre liste de démarrage et redémarrez le serveur. Le dossier peut rester sur le disque ; seule une ressource d'origine *en cours d'exécution* déclenche ce message.
  </Accordion>

  <Accordion title="'Discord slots are enabled, but guildId or botToken is empty'">
    Vous avez activé `CreatorServerConfig.Discord.enabled` sans renseigner l'ID du serveur et le token du bot dans `config/server.lua`. Remplissez-les ou mettez `enabled = false`.
  </Accordion>

  <Accordion title="'starter item N in config/server.lua is invalid'">
    Une entrée de `CreatorServerConfig.Starter.items` n'a pas de `name`, ou a un `amount` qui n'est pas un entier d'au moins 1. Corrigez l'entrée à cette position.
  </Accordion>
</AccordionGroup>

## Sélection de personnage

<AccordionGroup>
  <Accordion title="Je vois encore l'ancien sélecteur de personnage">
    Le sélecteur d'origine tourne encore aux côtés de Creator.

    * **RSG :** supprimez `ensure rsg-multicharacter` et `ensure rsg-spawn`.
    * **VORP :** supprimez `ensure vorp_character`.

    Redémarrez le serveur après avoir modifié la liste de démarrage.
  </Accordion>

  <Accordion title="La sélection s'ouvre deux fois, ou par-dessus un personnage actif">
    Un autre script appelle le flux de personnage alors que le joueur est déjà dans le monde. Creator lui-même refuse d'empiler les écrans (`OpenCharacterSelection` retourne `already_open` / `already_active`), cherchez donc une ressource d'origine ou un script tiers qui déclenche les événements de connexion de votre framework une seconde fois. La sortie debug affiche la raison du rejet.
  </Accordion>

  <Accordion title="Rien ne se passe après la connexion, l'écran reste noir">
    Vérifiez la console serveur pour l'un des messages de démarrage ci-dessus. Si Creator a démarré correctement, activez `Config.Debug` et consultez la console client (F8) — un problème de locale ou de chargement NUI s'y affichera.
  </Accordion>

  <Accordion title="Un joueur a moins d'emplacements que prévu">
    Les emplacements sont résolus dans un ordre fixe : fonction personnalisée, Discord, dérogation par joueur, limite du framework, défaut. Si Discord est activé, les dérogations par joueur ne sont **pas** consultées. Consultez [Emplacements de personnage](/fr/rco-creator/character-slots) pour la logique complète. Le résultat est toujours plafonné par `Config.MaxCharacters`.
  </Accordion>

  <Accordion title="La création de personnage rejette une date de naissance valide">
    L'âge est vérifié par rapport à `Config.IdentityReferenceDate`, et non à la date réelle. Avec la valeur par défaut `1899-01-01` et des âges de 18 à 100, les années de naissance valides vont de 1799 à 1881. Ajustez la date de référence ou `BirthYearMin` / `BirthYearMax` pour votre univers. Voir [Règles d'identité](/fr/rco-creator/configuration#identity-rules).
  </Accordion>
</AccordionGroup>

## Spawn

<AccordionGroup>
  <Accordion title="Le sélecteur de spawn n'apparaît jamais">
    Vérifiez `Config.Spawn.selectorMode`. Avec `new_character_only`, les personnages existants ignorent le sélecteur ; avec `first_login_after_restart`, chaque personnage le voit une fois par cycle serveur. Vérifiez aussi `CreatorServerConfig.ForceLastPosition` — par défaut, les personnages emprisonnés sont toujours renvoyés à leur dernière position.
  </Accordion>

  <Accordion title="J'ai modifié Config.Spawn.locations mais rien n'a changé">
    Cette liste sert uniquement à remplir la base de données la première fois. Ensuite, gérez les spawns en jeu avec `/rcospawns`, ou videz la table `rco_creator_spawn_locations` et redémarrez pour réinitialiser. Voir [Points de spawn](/fr/rco-creator/spawn-locations).
  </Accordion>

  <Accordion title="/rcospawns indique que je n'ai pas la permission">
    Accordez la permission ACE explicitement et redémarrez :

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

    Ou ajustez `CanManageSpawns` dans `config/server.lua`.
  </Accordion>

  <Accordion title="Les nouveaux personnages n'ont pas reçu le kit de départ">
    Vérifiez que `CreatorServerConfig.Starter.enabled` vaut `true` et que chaque nom d'objet existe dans l'inventaire de votre framework. Le kit est accordé une fois par personnage et enregistré en base ; si l'attribution a échoué, la console affiche un message et Creator ne réessaie **pas** automatiquement, pour éviter de dupliquer des objets. Corrigez la cause, puis accordez les objets manuellement aux joueurs concernés.
  </Accordion>

  <Accordion title="Le joueur se retrouve dans le mauvais routing bucket">
    Pendant la sélection de personnage, chaque joueur est isolé dans son propre bucket. Au spawn, Creator le renvoie dans le bucket qu'il avait lorsque la sélection s'est ouverte — il ne force pas le bucket 0. Si un autre script change de bucket pendant que l'écran de sélection est ouvert, cette interaction en est probablement la cause.
  </Accordion>
</AccordionGroup>

## Avertissements du version checker

`RCO Identity update available` signifie que le package installé est plus ancien que la release publique actuelle.

`Resource version mismatch` signifie que `rco-creator` et `rco-appearance` viennent de releases différentes. Remplacez les deux par le même package ; ne changez pas uniquement le numéro du manifest.

Si la requête distante échoue, le version checker est **fail-open** : RCO continue de démarrer normalement.