Une erreur d'inventaire ESX nécessite le texte d'erreur exact et la ressource d'inventaire utilisée. Une fonction canCarryItem manquante est un problème d'API ou d'intégration ; un joueur incapable de transporter plus de poids est une condition différente. Ne remplacez pas ESX et votre inventaire ensemble sans vérifier la compatibilité.
Identifier l'intégration
Enregistrez la version ou le commit ESX, la ressource d'inventaire et le script qui a déclenché l'erreur. Capturez la trace de la pile du serveur, son fichier et son numéro de ligne. Vérifiez si la ressource utilise l'API d'inventaire ESX ou un pont d'inventaire tiers.
Si canCarryItem est nil
Une erreur de fonction nil signifie que l'appelant ne peut pas accéder à cette fonction sur l'objet qu'il utilise. Vérifiez comment il obtient l'objet joueur, si le joueur est chargé et si le framework ou l'intégration d'inventaire installé prend en charge cette API. L'erreur seule ne prouve pas qu'un objet n'a pas de poids.
Comparez le code appelant avec l'implémentation officielle du joueur ESX et la documentation de votre inventaire. Mettez à jour ou adaptez la ressource incompatible sur une copie de test. Ne contournez pas les vérifications de capacité en renvoyant true : cela peut créer des débordements ou des exploits de transfert d'objets.
Si la capacité de transport est incorrecte
Vérifiez la définition de l'objet, l'unité de poids, la quantité et la capacité du joueur dans l'inventaire qui les possède. Ne supposez pas qu'une ligne d'objet de base de données fait autorité lorsqu'un inventaire de remplacement utilise des fichiers ou des métadonnées. Sauvegardez les données persistantes avant de modifier les définitions.
Testez un objet à la fois : un inventaire vide, juste en dessous de la capacité, exactement à la capacité et au-dessus de la capacité. Incluez les transferts, les achats, le stockage et la suppression d'objets, puis reconnectez-vous pour vérifier la persistance.
Déployer une correction vérifiée
Maintenez des versions compatibles ensemble et suivez leur ordre de migration documenté. Utilisez un redémarrage contrôlé lorsque l'état du framework l'exige. Confirmez que le démarrage, les inventaires existants et les nouveaux joueurs fonctionnent avant de rouvrir le serveur. Si les modifications de données échouent, restaurez uniquement l'état de test ou de migration affecté via votre procédure de récupération.