Was ist ox_inventory?
ox_inventory ist ein modernes, leistungsstarkes Inventarsystem für FiveM, das zur Standardwahl für ernsthafte Roleplay-Server geworden ist. Es wurde vom Overextended-Team entwickelt und ersetzt ältere Inventarlösungen durch ein System, das schneller, flexibler und einfacher zu erweitern ist. Es verfügt über eine elegante React-basierte Benutzeroberfläche, integrierte Waffenverwaltung, Handwerksunterstützung, Shops, Verstecke und eine leistungsstarke API, mit der Skriptentwickler benutzerdefinierte Interaktionen mit Gegenständen erstellen können. Ganz gleich, ob du einen neuen Server erstellen oder von einem anderen Bestand migrieren: Wenn du ox_inventory genau verstehen, wirst du ein besserer FiveM-Entwickler.
Installation und Konfiguration
ox_inventory erfordert ox_lib als Abhängigkeit und funktioniert sowohl mit den Frameworks ESX und QBCore als auch mit eigenständigen Setups. Die Installation umfasst das Herunterladen der Ressource, das Importieren des SQL-Schemas in deine Datenbank und das Konfigurieren der Framework-Brücke. Die Konfigurationsdatei steuert alles, von Lagergewichtsgrenzen bis hin zu Artikelverfall-Timern.
Registrieren benutzerdefinierter Elemente
Elemente in ox_inventory werden in der Datei data/items.lua definiert. Jedes Element benötigt einen eindeutigen Namen, eine Bezeichnung, ein Gewicht und optional eine Stapelgröße, Abklingrate, Beschreibung und clientseitige oder serverseitige Ereignishandler. Wenn du das vollständige Elementdefinitionsschema verstehen, kannst du Elemente erstellen, die genau das tun, was deine Scripts benötigen.
Verwendung der ox_inventory-Server-API
Die serverseitigen Exporte sind der am häufigsten verwendete Teil von ox_inventory und ermöglichen Ihnen das Hinzufügen von Artikeln, das Entfernen von Artikeln, das Überprüfen des Inventarinhalts und das Bearbeiten von Metadaten. Verwende für die Manipulation von Gegenständen immer eine serverseitige API, um eine Ausnutzung durch Betrüger zu verhindern.
Arbeiten mit Artikelmetadaten
Artikelmetadaten sind eine der leistungsstärksten Funktionen von ox_inventory. Es ermöglicht Ihnen, beliebige Daten an einzelne Artikelinstanzen anzuhängen und so eindeutige Seriennummern für Waffen, Verfallsdaten für Lebensmittel, Spielernamen auf Ausweisen und benutzerdefinierte Eigenschaften für jeden Artikel zu ermöglichen.
Erstellen von Custom Shops
ox_inventory umfasst ein integriertes Shop-System, das du mit benutzerdefinierten Artikelkatalogen, Preisen, Auftragsbeschränkungen und Standorten konfigurieren können. Shops werden in data/shops.lua definiert und können an Ped-Anbieter, Blip-Standorte angehängt oder programmgesteuert ausgelöst werden.
Stash-System und benutzerdefinierte Container
Stashes sind dauerhafte Lagerbehälter, auf die Spieler an bestimmten Orten zugreifen können. ox_inventory unterstützt persönliche Verstecke, die an eine Spieler-ID gebunden sind, gemeinsame Verstecke, auf die jeder zugreifen kann, und berufsbeschränkte Verstecke für Polizei-Beweisräume und Krankenhauslager.
Best Practices für die ox_inventory-Integration
Zusammenfassung
Agency Scripts baut seine gesamte Produktlinie nach denselben Grundprinzipien: Framework-agnostische Architektur, schlanke Performance-Eigenschaften, klar dokumentierte Konfiguration und eine API, die echte Composability zwischen den Scripts ermöglicht. Kein Script ist eine Insel — jedes ist so gebaut, dass es gut allein und noch besser als Teil des Ökosystems funktioniert.
Für Fragen zur Installation, Konfiguration oder Kompatibilität ist der Agency Scripts Discord der schnellste Weg zur Hilfe. Die Community dort ist aktiv und hilfsbereit, und das Core-Team ist regelmäßig präsent. Für kritische Probleme steht auch ein direktes Support-Ticket-System auf der Tebex-Produktseite zur Verfügung.
Updates für alle Agency-Scripts werden über Tebex-Benachrichtigungen kommuniziert. Active-Business-Abonnenten erhalten neue Scripts automatisch ohne zusätzlichen Kauf. Changelog-Details erscheinen im #changelog-Kanal des Discords, damit du Updates bewerten kannst, bevor du sie auf einem Produktionsserver installierst.