Lege Inventarlimits fest, die sich an den Aktivitäten orientieren, die Spieler erledigen müssen: gewöhnliche Vorräte, die Ausrüstung für einen Job und eine sinnvolle Wahl bezüglich zusätzlicher Fracht. Gewicht, Slots und Item-Metadaten lösen unterschiedliche Probleme, daher überprüfe deine tatsächliche Inventarressource, bevor du Werte änderst.
Identifiziere die Inventarimplementierung
Notiere die Inventarressource/-version, ihre Framework-Integration und wo sie Gegenstände, Spieler-Kapazität, Fahrzeuglager und Verstecke definiert. ESX, QBCore und Qbox implizieren kein universelles Inventarformat. Verwende die installierte Quelle oder die Dokumentation des Inventar-Autors.
Sichere die Konfiguration und die gespeicherten Inventare. Teste Änderungen auf einer separaten Instanz; eine Verringerung der Kapazität kann dazu führen, dass bestehende Container über ihrem neuen Limit liegen.
Verstehe die drei Limits
Gewichtslimits begrenzen die gesamte getragene Masse unter Verwendung der Einheiten der Ressource. Slots begrenzen unterschiedliche Stapel. Stapelregeln bestimmen, ob identische Namen mit unterschiedlichen Metadaten einen Slot teilen können. Ein Container kann keine Slots mehr haben, obwohl er noch freies Gewicht hat.
Verwende die gleiche Einheit konsequent. Wenn dein Inventar Gramm verwendet, stellen ein Gegenstand mit 500 Gewicht und eine Kapazität von 20.000 0,5 kg und 20 kg dar. Diese Zahlen sind eine Veranschaulichung, kein empfohlenes Server-Preset.
Erstelle eine repräsentative Ausrüstung
Liste auf, was ein neuer Spieler für eine normale Sitzung benötigt, dann wiederhole dies für jeden Job. Berechne Menge × Artikelgewicht und die benötigten Stapelplätze. Schließe Munition, Werkzeuge und Verbrauchsmaterialien ein. Teste die Ausrüstung im Spiel, anstatt dich nur auf eine Tabelle zu verlassen.
Wähle Fahrzeug- und Versteckkapazitäten entsprechend ihrem Verwendungszweck. Ein Nutzfahrzeug kann die Logistik unterstützen, ohne jeden Spieler zu zwingen, ein ganzes Lagerhaus mit sich zu führen. Die Serverpopulation allein bestimmt keine sinnvolle Tragfähigkeit.
Bearbeite die Ressource, der die Einstellung gehört
In QBCore-Setups können gemeinsame Item-Definitionen und die Container-Limits des Inventars in verschiedenen Ressourcen liegen. In ox_inventory sind gewöhnliche Item-Definitionen und Waffen-Definitionen getrennte Anliegen. Befolge die tatsächliche Dateistruktur deiner installierten Version.
Kopiere keine pauschale Einstellung wie PlayerMaxWeight, useWeight oder Stash-Funktion in eine Datei, es sei denn, diese Ressource liest sie. Suche im Quellcode nach dem Schlüssel und seiner Verwendung. Bewahre bestehende Item-Namen und -Verhalten, während du das beabsichtigte Limit änderst.
Metadaten beibehalten
Seriennummern, Haltbarkeit, Munition und Aufsätze sind implementierungsspezifisch. Überprüfe Bereiche und Feldnamen vor jeder Konvertierung; eine Haltbarkeitsskala von 0 bis 1 ist nicht austauschbar mit 0 bis 100. Bewahre einzigartige Gegenstände separat auf und melde unbekannte Felder, anstatt sie zu löschen.
Eine Inventarmigration benötigt einen versionierten Konverter für das exakte Quell- und Zielschema, wobei Mengen und Metadaten vor und nachher verglichen werden. Führe keine generischen SQL-Abfragen gegen erratene Spieler-Item-Tabellen aus.
Kapazität und Persistenz testen
- Füge eine bekannte Menge hinzu und entferne sie; bestätige, dass das angezeigte und das durchgesetzte Gewicht übereinstimmen.
- Fülle Slots mit unterschiedlichen Stapeln und teste dann einen passenden Stapel und einen Gegenstand mit unterschiedlichen Metadaten.
- Teste Übertragungen zwischen Spieler, Fahrzeug und Versteck, wenn das Ziel voll ist. Bestätige, dass ein Fehlschlag weder Gegenstände verliert noch dupliziert.
- Verbinde dich erneut und starte den Testserver neu. Überprüfe Mengen, Besitz und Metadaten.
- Teste einen bestehenden Container über der vorgeschlagenen neuen Kapazität und entscheide, wie Spieler ohne Item-Löschung wiederherstellen können.
Verständliche Änderungen einführen
Erkläre geänderte Limits und gib Spielern eine Möglichkeit, bestehende Lager neu zu organisieren. Beobachte abgelehnte Transfers, häufig getragene Gegenstände und Spieler-Feedback. Passe den spezifischen Engpass an, anstatt wiederholt jede Kapazität zu erhöhen.
Referenzdokumentation
Quelle: qbcore-fivem/qb-inventory · Quelle: overextended/ox_inventory