> ## 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 Appearance et comment les résoudre.

Avant toute chose : définissez `Config.Debug = true` dans `rco-appearance/config/config.lua`, redémarrez la ressource et reproduisez le problème. Appearance 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="'Could not detect a framework. Start rsg-core or vorp_core...'">
    Appearance démarre avant le core de votre framework. Placez `ensure rsg-core` (ou `ensure vorp_core`) au-dessus de `rco-appearance` dans votre liste de démarrage.
  </Accordion>

  <Accordion title="'Both rsg-core and vorp_core are started...'">
    Votre `server.cfg` démarre les deux cores. C'est presque toujours un `ensure` en trop — supprimez la ligne du framework que vous n'utilisez **pas**. RSG : uniquement `rsg-core` ; VORP : uniquement `vorp_core`.
  </Accordion>

  <Accordion title="'Config.Framework is rsg but rsg-core is not started' (ou l'équivalent VORP)">
    Vous avez forcé un framework dans la configuration, mais ce core ne tourne pas au démarrage d'Appearance. Corrigez l'ordre de démarrage ou définissez `Config.Framework = 'auto'`.
  </Accordion>

  <Accordion title="'oxmysql is not started. Persistence requires oxmysql...'">
    `oxmysql` démarre après Appearance. Placez `ensure oxmysql` en tête de votre liste de démarrage, au-dessus du core du framework. Sans lui, les apparences ne peuvent pas être enregistrées.
  </Accordion>

  <Accordion title="'Failed to migrate rco_appearance / rco_appearance_outfits'">
    Appearance n'a pas pu créer ou mettre à jour ses tables. Le détail après `Error=db_schema` indique pourquoi — généralement l'utilisateur base de données n'a pas les droits `CREATE` / `ALTER`. Accordez-les, ou importez `sql/rco_appearance.sql` à la main une fois, puis redémarrez.
  </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="'stop the stock vorp_barbershop resource before starting this pack' (VORP)">
    Le `vorp_barbershop` d'origine tourne encore. Il ne fait **pas** partie de `vorp_character`. Supprimez `ensure vorp_barbershop` de votre liste de démarrage et redémarrez le serveur. Le dossier peut rester sur le disque.
  </Accordion>

  <Accordion title="'stop the stock vorp_clothingstore resource before starting this pack' (VORP)">
    Le `vorp_clothingstore` d'origine tourne encore. Supprimez `ensure vorp_clothingstore` de votre liste de démarrage et redémarrez. Les packs VORP actuels omettent souvent cette ressource ; ce message n'apparaît que si ce dossier est started.
  </Accordion>

  <Accordion title="'stop the stock rsg-barbers resource before starting this pack' (RSG)">
    Le `rsg-barbers` d'origine tourne encore. Supprimez `ensure rsg-barbers` de votre liste de démarrage et redémarrez le serveur. Le dossier peut rester sur le disque.
  </Accordion>
</AccordionGroup>

## Apparences et enregistrement

<AccordionGroup>
  <Accordion title="Un personnage a perdu ses cheveux, ou son visage a été réinitialisé">
    Presque toujours un autre script a écrit un blob d'apparence complet sur le personnage. Coupables fréquents : `rsg-barbers` encore actif sur RSG, ou un script de vêtements/barbier tiers qui envoie la peau entière au lieu des champs qu'il modifie.

    Arrêtez les ressources d'origine listées dans [Installation](/fr/rco-appearance/installation), et consultez [Compatibilité](/fr/rco-appearance/compatibility) pour ce que les scripts tiers doivent faire. Ensuite, faites corriger l'apparence du joueur chez un barbier ou, en tant qu'admin, ouvrez le créateur pour lui avec `/rco_creator`.
  </Accordion>

  <Accordion title="J'ai modifié quelque chose avec ApplyAppearance / EquipCategory et ce n'est pas enregistré">
    C'est normal. Les exports client appliquent une apparence visuellement ; ils n'enregistrent jamais. Pour persister une modification depuis une autre ressource, utilisez l'export serveur `SetAppearanceForCharacter`. Voir [Exports](/fr/rco-appearance/exports).
  </Accordion>

  <Accordion title="Les personnages existants affichent un ped par défaut après l'installation">
    La migration s'exécute la première fois que chaque personnage se connecte. Si un personnage affiche encore une apparence par défaut ensuite, ses anciennes données étaient vides ou invalides et ont été ignorées. Avec `Config.Debug` activé, la console nomme le personnage. Il peut reconstruire son apparence dans le créateur (`/rco_creator` en admin, ou chez un barbier et un magasin de vêtements).
  </Accordion>

  <Accordion title="Le ped a l'air bugué après une longue session">
    Tapez `/reloadskin`. Cela réapplique l'apparence enregistrée sans rien modifier. Si cela arrive souvent après une action précise (promenade à cheval, mort), dites-nous quel script la déclenche.
  </Accordion>
</AccordionGroup>

## Magasins

<AccordionGroup>
  <Accordion title="Deux blips de barbier dans chaque ville (RSG)">
    `rsg-barbers` tourne encore. Retirez-le de votre liste de démarrage. Ses magasins enregistrent dans `playerskins`, que Appearance ne lit plus, donc les coupes achetées là-bas disparaissent de toute façon à la reconnexion.
  </Accordion>

  <Accordion title="Deux interfaces de barbier ou deux blips dans la même ville (VORP)">
    `vorp_barbershop` tourne encore. Retirez-le de votre liste de démarrage. Arrêter `vorp_character` ne suffit pas — le barbier est une ressource séparée du pack VORP par défaut.
  </Accordion>

  <Accordion title="L'invite à la porte du magasin ne fait rien">
    Vérifiez que le joueur est à moins de `Config.ShopInteractDistance` des coordonnées `prompt` et appuie sur la touche définie dans `Config.ShopInteractControl`. Avec `Config.Debug` activé, la console client indique si l'invite a été enregistrée et si le serveur a accepté la demande d'ouverture.
  </Accordion>

  <Accordion title="Les joueurs ne sont pas facturés">
    `Config.ShopCost` vaut `0` par défaut. Définissez le prix souhaité. Rappel : il est facturé uniquement à la sauvegarde dans un magasin de vêtements ou un barbier — jamais dans le créateur ou la garde-robe.
  </Accordion>

  <Accordion title="Mon tatouage personnalisé n'apparaît pas">
    Trois points à vérifier : le `.ytd` est dans `rco-appearance/stream/addons/`, le `dict` de votre entrée `Config.OverlayAddons` correspond exactement au nom du fichier (sans `.ytd`), et l'`id` est unique. Redémarrez la ressource après modification. Voir [Magasins et overlays personnalisés](/fr/rco-appearance/shops#custom-tattoos-and-makeup).
  </Accordion>

  <Accordion title="Les anciennes commandes de garde-robe de rsg-wardrobe ne font rien">
    `rsg-wardrobe` est volontairement arrêté. Les joueurs utilisent les magasins garde-robe ; les scripts utilisent `OpenEditor` avec `mode = 'wardrobe'`, `SetUndressed` ou `ListOutfits`.
  </Accordion>
</AccordionGroup>