Les peds FiveM sont des modèles de personnages utilisés pour les joueurs, les métiers, les NPC ambiants ou les scènes scriptées. Un ped additionnel ajoute normalement un nouveau nom de modèle ; un ped de remplacement écrase un modèle GTA V existant. Les add-ons sont généralement plus faciles à isoler et à annuler, tandis que les remplacements peuvent affecter toute ressource qui appelle le modèle original.
Confirmez l’édition GTA visée avant d’installer ou d’exporter des éléments. Les paquets Legacy ne sont pas automatiquement compatibles avec Enhanced ; suivez les directives officielles de conversion d'assets Enhanced si c'est votre cible.
Base technique : vérifié le 9 août 2026 à partir de la documentation officielle Cfx.re des manifestes de ressources. Respectez toujours la licence et les notes d’installation propres au paquet.
Ce qu'un package de ped devrait contenir
Un modèle streamable comprend généralement des fichiers drawable et de texture, ainsi qu'un manifeste de ressource. Les fichiers exacts diffèrent selon le type de modèle. Ne renommez pas les fichiers et ne les copiez pas dans une autre ressource tant que vous n'avez pas compris la structure du package ; les noms de modèles, les métadonnées et les références de script doivent continuer à correspondre.
Add-on ou remplacement ?
| Type | Idéal pour | Risque principal |
|---|---|---|
| Ped additionnel | Personnages nommés, métiers et modèles que les joueurs peuvent choisir | Collisions de noms de modèle ou un script qui ne prend pas en charge les modèles personnalisés |
| Ped de remplacement | Un remplacement visuel global délibéré | Modifications inattendues partout où le modèle original est utilisé |
| PNJ scripté | Boutiques, missions et scènes | Erreurs d'apparition côté client, de propriété réseau ou de nettoyage |
Flux de travail d'installation
- Vérifiez la licence et confirmez que la redistribution et l'utilisation sur des serveurs commerciaux sont autorisées.
- Créez une ressource dédiée plutôt que de mélanger des modèles non liés.
- Conservez le manifeste fourni et la structure des dossiers, sauf indication contraire dans la documentation.
- Ajoutez la ressource à la configuration du serveur de staging et redémarrez dans une fenêtre contrôlée.
- Faites apparaître le modèle via la commande, le menu ou le script documenté — et non une commande universelle supposée.
- Testez la reconnexion, les vêtements/composants, les animations, les véhicules, les armes et le rendu à distance.
Vérifications des performances et de la qualité
- Inspectez la résolution des textures et la taille des fichiers. Un ped visuellement simple peut toujours avoir des textures surdimensionnées.
- Testez plusieurs copies à la fois ; un seul modèle dans une scène vide ne représente pas un serveur occupé.
- Surveillez les textures manquantes, les niveaux de détail cassés, le clipping et les incohérences d'animation.
- Confirmez que les entités PNJ générées sont nettoyées par le script qui les crée lorsque sa scène se termine ou qu'il s'arrête ; la ressource de streaming seule ne gère pas ce cycle de vie.
- Vérifiez la console F8 du client et la sortie de la console du serveur pour les erreurs de streaming ou de modèle.
Pannes courantes
Si le modèle est invisible, vérifiez que la ressource a démarré et que le nom du modèle demandé correspond aux fichiers streamés. Si des textures sont manquantes, restaurez les noms de fichiers et la structure du package d'origine. Si seul un script ne peut pas sélectionner le ped, confirmez que le script prend en charge les modèles add-on et que toute liste d'autorisation utilise le nom correct. Annulez la ressource dédiée si des plantages ou une pression mémoire commencent après le déploiement.
Avant de publier un ped
Conservez le créateur, la licence, la version, l'URL source et les notes d'installation avec la ressource. Évitez de republier un modèle lorsque la licence est absente. Pour les décisions d'achat à l'échelle du serveur, utilisez la liste de contrôle de pré-achat RPCrate.