Ped addon invisible ou qui crashe ? Corrigez-le
Un ped addon qui ne charge rien, qui apparaît comme un mannequin gris ou violet, ou qui fait crasher le client, se résume presque toujours à l'une de six causes. Vérifiez-les dans cet ordre.
1. Les fichiers ne sont pas dans stream/
FiveM ne streame que les assets placés dans un dossier nommé stream (à n’importe quelle profondeur en dessous). Un ped placé à la racine de la resource, ou dans un dossier nommé models, ne se charge jamais. Vérifiez que chaque .ydd, .yft, .ytd et .ymt du ped se trouve sous stream/.
2. peds.meta manque ou n’est pas chargé
Un nouveau ped a besoin d’une entrée dans peds.meta, et le manifest doit le charger :
files { 'peds.meta' }
data_file 'PED_METADATA_FILE' 'peds.meta'Sans cela, le nom du modèle existe mais le jeu n’a aucune définition de ped : il ne fait rien spawner, ou retombe sur un ped par défaut.
3. Les noms ne correspondent pas
Le nom du modèle dans peds.meta, le .yft, le .ydd et le .ytd doivent tous utiliser le même nom de base. Une seule faute de frappe et les textures ou les drawables échouent sans bruit. Mettez tout en minuscules ; évitez les espaces et les tirets.
4. Textures trop lourdes
Un dictionnaire de textures trop gros (un seul .ytd de plus de 16 Mo, ou quelques maps en 4K) peut tout simplement ne pas se charger, ce qui donne un ped invisible ou sans texture, et sur les clients plus faibles un crash. Réduisez les textures ; un ped a rarement besoin de maps de plus de 2048 px.
5. Un squelette que GTA ne connaît pas
Si le ped apparaît mais reste en T-pose, glisse ou a les membres tordus, son squelette et ses poids ne correspondent pas à ce qu’attendent les animations de GTA. Construire sur le squelette freemode évite totalement ce problème : toutes les animations et emotes fonctionnent dessus.
6. Trop de collections de vêtements
Si l’ajout du ped coïncide avec le crash de tous les peds MP masculins ou féminins, le problème ne vient pas du ped mais des collections de vêtements chargées avec lui : GTA ne charge qu’un nombre limité de fichiers vêtements .ymt par genre. Consultez le guide sur la limite YMT.
Testez-le isolément
Lancez un serveur avec uniquement votre framework et le ped, puis faites-le spawner avec SetPlayerModel. S’il fonctionne là, une autre resource écrase le même nom de modèle ou dépasse une limite.
Questions fréquentes
Le ped est invisible mais je vois son ombre ou son nom. Pourquoi ?
Le modèle a été streamé mais pas ses drawables : en général un dictionnaire de textures qui n'a pas chargé (trop lourd ou mal nommé) ou des drawables nommés autrement que ce qu'attend le modèle.
Le ped reste en T-pose et ne s'anime pas. Pourquoi ?
Son squelette n'est pas un squelette que les animations de GTA connaissent. Les animations jouent sur des os nommés ; un ped construit sur son propre squelette ne joue que les animations faites pour lui.
Un seul ped cassé peut-il faire crasher tout le monde ?
Oui. Un ped dont les fichiers dépassent les limites de streaming ou dont le meta est mal formé peut faire crasher tous les clients qui le streament, d'où l'impression d'un crash aléatoire près d'un endroit précis.
Essayez gratuitement
Créez un compte gratuit, rejoignez le Discord pour vos crédits et créez votre premier asset en quelques minutes.