Ein ESX-Inventarfehler erfordert den genauen Fehlertext und die verwendete Inventarressource. Eine fehlende canCarryItem Funktion ist ein API- oder Integrationsproblem; ein Spieler, der nicht mehr Gewicht tragen kann, ist eine andere Bedingung. Ersetze ESX und dein Inventar nicht gleichzeitig, ohne die Kompatibilität zu prüfen.
Identifiziere die Integration
Notiere die ESX-Version oder den Commit, die Inventarressource und das Skript, das den Fehler ausgelöst hat. Erfasse den Server-Stack-Trace sowie die Datei- und Zeilennummer. Überprüfe, ob die Ressource die ESX-Inventar-API oder eine Drittanbieter-Inventarbrücke verwendet.
Wenn canCarryItem nil ist
Ein Nil-Funktionsfehler bedeutet, dass der Aufrufer nicht auf diese Funktion des verwendeten Objekts zugreifen kann. Überprüfe, wie es das Spielerobjekt erhält, ob der Spieler geladen ist und ob das installierte Framework oder die Inventarintegration diese API unterstützt. Der Fehler allein beweist nicht, dass ein Gegenstand kein Gewicht hat.
Vergleiche den aufrufenden Code mit der offiziellen ESX-Spielerimplementierung und der Dokumentation deines Inventars. Aktualisiere oder passe die inkompatible Ressource auf einer Testkopie an. Umgehe Kapazitätsprüfungen nicht, indem du „true“ zurückgibst: Das kann zu Überlauf- oder Item-Transfer-Exploits führen.
Wenn die Tragfähigkeit falsch ist
Überprüfe die Item-Definition, die Gewichtseinheit, die Menge und die Spieler-Kapazität im Inventar, dem sie gehören. Gehe nicht davon aus, dass eine Datenbank-Item-Zeile maßgeblich ist, wenn ein Ersatzinventar Dateien oder Metadaten verwendet. Sichere persistente Daten, bevor du Definitionen änderst.
Teste jeweils ein Item: ein leeres Inventar, knapp unter Kapazität, genau bei Kapazität und über Kapazität. Schließe Transfers, Käufe, Lagerung und Item-Entfernung ein und verbinde dich dann erneut, um die Persistenz zu überprüfen.
Setze eine verifizierte Korrektur ein
Halte kompatible Versionen zusammen und befolge deren dokumentierte Migrationsreihenfolge. Verwende einen kontrollierten Neustart, wenn der Framework-Status dies erfordert. Bestätige, dass der Start, bestehende Inventare und neue Spieler funktionieren, bevor du den Server wieder öffnest. Wenn Datenänderungen fehlschlagen, stelle nur den betroffenen Test- oder Migrationsstatus über dein Wiederherstellungsverfahren wieder her.