QBCore Inventarsystem

QBCore Inventory System – Modernes Item-Management für FiveM-Server

Rüste dein QBCore-Server mit einem voll ausgestatteten Inventarsystem auf, das intuitive Drag-and-Drop-Item-Verwaltung für FiveM bietet. Diese umfassende Inventarlösung ersetzt grundlegende Item-Listen durch eine visuelle Gitterschnittstelle, mit der Spieler ihre Gegenstände organisieren, Items zwischen Behältern übertragen und mit Speichersystemen natürlich interagieren können. Es ist die Grundlage für immersive Rollenspiel-Wirtschaften, Handwerkssysteme und Spielerinteraktionen, die modern und poliert wirken.

Das QBCore-Inventarsystem verwaltet alles, von Spielertaschen bis zu Fahrzeugkofferräumen, Verstecken bis zu Ladenauslagen. Items haben Gewicht, nehmen Inventarplatz ein und können visuell nach den Vorlieben der Spieler organisiert werden. Das System integriert sich nahtlos mit QBCore-Jobs, Läden und Item-Nutzung, wodurch eine kohärente Erfahrung entsteht, bei der die Inventarverwaltung wie ein natürlicher Teil des Gameplays und nicht wie eine lästige Menüsuche wirkt.

Video-Vorschau wird nicht geladen? Klicke hier

Im Leistungsumfang enthalten

Du erhältst einen vollständigen Inventarrahmen mit Spielerinventar, Hotbar-Slots, Item-Tooltips, Gewichtsverwaltung und Behältersystemen. Die visuelle Schnittstelle zeigt Item-Symbole, Mengen und Metadaten auf einen Blick. Spieler können Items zwischen Slots ziehen, Stapel teilen und mit Tastenkürzeln schnell übertragen. Das System umfasst Inventarzugriff für Fahrzeuge (Kofferräume, Handschuhfächer), Immobilien (Verstecke, Kühlschränke), fallengelassene Items (Bodenschätze) und Läden.

Der Backend handelt die gesamte Komplexität – Item-Dauerhaftigkeit, Metadaten-Speicherung (Waffenaufsätze, Item-Qualität, Eigentümerinformationen), Gewichtsberechnungen, Slot-Verwaltung und Berechtigungsprüfungen. Alles synchronisiert sich korrekt im Multiplayer, verhindert Duplikationsausnutzungen und integriert sich mit dem bestehenden Item-System von QBCore, ohne die Kompatibilität mit deinen aktuellen Skripten zu brechen.

Hauptmerkmale

• Drag-and-Drop-Oberfläche – Visuelles Rasterinventar mit flüssigem Ziehen, Ablegen und Item-Austausch zwischen Slots
• Gewichts- & Slot-Verwaltung – Jeder Gegenstand hat Gewicht, das Inventar hat Kapazitätsgrenzen, mit klaren visuellen Indikatoren, wenn es voll ist
• Hotbar-System – Schnellzugriffs-Slots für häufig verwendete Gegenstände, an die Zahlentasten gebunden für sofortige Nutzung
• Item-Metadaten – benutzerdefinierte Daten pro Gegenstand speichern (Waffenseriennummern, Lebensmittelqualität, hergestellt-von-Info, Haltbarkeit)
• Container-Unterstützung – Zugriff auf Fahrzeugkofferräume, Immobilienverstecke, fallengelassene Taschen und gemeinsame Lager mit derselben Oberfläche
• Stapelteilung – Rechtsklick, um Item-Stapel in benutzerdefinierte Mengen zu teilen, perfekt für Handel oder Verteilung
• Gegenstands-Tooltips – Über Items fahren, um detaillierte Informationen, Statistiken und Nutzbarkeit zu sehen
• Drop & Pickup-System – Items als physische Objekte auf den Boden fallen lassen, fallengelassene Beutebeutel an Tatorten sehen
• Shop-Integration – Visuelle Laden-Schnittstellen, bei denen du Items zum Kaufen/Verkaufen ziehst, mit Preisanzeigen und Transaktionsbestätigungen
• Waffenaufsatz-Anzeige – Ausgerüstete Waffenaufsätze direkt im Inventar sehen, Loadouts visuell verwalten
• Inventar-Tastenkürzel – Tastatursteuerung für schnelle Nutzung von Gegenständen, alles übertragen, Inventar sortieren und schnelles Plündern
• Gegenstands-Haltbarkeitssystem – Gegenstände verschlechtern sich durch Nutzung und erfordern mit der Zeit Reparatur oder Ersatz
• Suchfunktion – Große Inventare nach Gegenstandsnamen filtern für schnellen Zugriff
• Berechtigungssteuerung – Festlegen, wer auf bestimmte Behälter zugreifen kann, nützlich für Gang-Verstecke oder Polizeibeweislager
• Exploit-Schutz – Serverseitige Validierung verhindert Gegenstandsvervielfältigung, Gewichtsmanipulation und Inventar-Hacking

Perfekt für

• Rollenspielserver – Bietet immersive Inventar-Interaktion für Jobs, Handel und tägliche Aktivitäten
• Economy-Server – Wesentliche Grundlage für Spielerhandel, Geschäfte, Handwerk und gegenstandsbasierte Wirtschaften
• Survival-Server – Gewichtsbeschränkungen und Inventarverwaltung fügen Plündern und Ressourcensammeln eine Überlebensherausforderung hinzu
• Kriminelles Rollenspiel – Visueller Drogenhandel, Waffenhandel und Transport von Schmuggelware mit realistischen Inventareinschränkungen
• Jobsysteme – Mechaniker tragen Teile, Köche verwalten Zutaten, Polizisten organisieren Beweise – alle nutzen dasselbe intuitive System

Wie es funktioniert

Spieler öffnen ihr Inventar mit einer konfigurierbaren Taste (standardmäßig I oder Tab, je nach Einrichtung). Die Benutzeroberfläche zeigt verfügbare Slots in einem Raster an, wobei belegte Slots Gegenstandssymbole und Mengen anzeigen. Wenn man mit der Maus über einen Gegenstand fährt, werden detaillierte Informationen angezeigt – was es ist, was es tut, besondere Eigenschaften oder Metadaten. Durch Klicken und Ziehen kann man neu organisieren, Gegenstände in verschiedene Inventare (Fahrzeugkofferraum, anderer Spieler, Geschäft) verschieben oder auf den Boden fallen lassen.

Das Gewichtssystem bietet realistische Einschränkungen – du kannst nicht 500 Waffen und unbegrenzt Drogen tragen. Jeder Gegenstand hat ein konfiguriertes Gewicht, und deine gesamte Tragfähigkeit ist begrenzt. Wenn du das Maximalgewicht erreicht hast, musst du Gegenstände fallen lassen oder in einem Fahrzeug verstauen, bevor du weitere aufnehmen kannst. Dies schafft sinnvolle Entscheidungen darüber, was du mitnimmst, und fördert die Nutzung von Aufbewahrungssystemen.

Fahrzeuginventare funktionieren identisch zum Spielerinventar. Öffne einen Kofferraum und du siehst sowohl dein persönliches Inventar als auch den Fahrzeugstauraum nebeneinander. Ziehe Gegenstände zwischen ihnen, um zu laden/entladen. Unterschiedliche Fahrzeuge haben unterschiedliche Lagerkapazitäten – ein Sportwagen hat minimalen Kofferraum, während ein Van ernsthafte Ladung transportieren kann. Grundstücksverstecke funktionieren genauso und ermöglichen es dir, sichere Häuser mit gelagerten Waffen, Drogen oder legitimen Geschäftsinventaren zu organisieren.

Installation

1. Entpacke die qb-inventory-Ressource in deinen Server-Ressourcenordner
2. Ersetze oder deaktiviere dein vorhandenes Inventarsystem (qb-core’s Basis-Inventar)
3. Füge “ensure qb-inventory” in server.cfg hinzu, nachdem qb-core geladen wird
4. Importiere die SQL-Datei, um die notwendigen Datenbanktabellen für die Item-Speicherung zu erstellen
5. Konfiguriere die Inventareinstellungen in config.lua (Maximalgewicht, Slot-Anzahl, Item-Bilder-Pfad)
6. Füge Item-Bilder zum html/images/ Ordner hinzu (PNGs für jedes Item auf deinem Server)
7. Starte den Server neu – die Spieler verwenden nun das neue Inventarsystem
8. Aktualisiere alle benutzerdefinierten Skripte, um qb-inventory-Exporte statt alte Inventarfunktionen zu verwenden

Framework-Kompatibilität

• ✅ Abonnieren – Native Integration, speziell für das QBCore-Framework entwickelt
• ✅ QBOX – Kompatibel mit QBOX (QBCore-Abzweigung), funktioniert mit minimalen Änderungen
• ❌ ESX – Für QBCore entwickelt, würde für ESX-Kompatibilität erhebliche Umstrukturierung erfordern

Konfiguration & Anpassung

Die Konfigurationsdatei ermöglicht dir, die Inventarkapazität (Standard 50 Slots) anzupassen, maximale Gewichtsgrenzen (variiert je nach Einrichtung, typischerweise 120-150 kg) und die Anzahl der Hotbar-Slots. Du kannst unterschiedliche Kapazitäten für Fahrzeugtypen festlegen – Motorräder haben weniger Stauraum als LKWs. Konfiguriere, ob fallengelassene Items physische Props oder nur Interaktionszonen erstellen. Setze Inventarzugriffsberechtigungen für Jobs, Gangs oder spezifische Immobilien.

Die Item-Konfiguration wird über die gemeinsame Items-Tabelle von QBCore gehandhabt, in der du das Gewicht, die Nutzbarkeit und die Metadaten-Felder jedes Items definierst. Das Inventarsystem liest diese Daten und wendet sie automatisch an. Möchtest du, dass Waffen Haltbarkeit haben? Aktiviere es in der Konfiguration und füge die Haltbarkeitsverfolgung zu Waffen-Items hinzu. Brauchst du Qualitätsbewertungen für Lebensmittel? Füge Qualitäts-Metadaten zu verbrauchbaren Items hinzu. Das System ist flexibel genug, um alle Item-Eigenschaften zu unterstützen, die dein Server benötigt.

Die visuelle Anpassung ist einfach – die HTML/CSS-Schnittstelle kann neu gestaltet werden, um zum Thema deines Servers zu passen. Item-Bilder sind einfache PNG-Dateien, die du nach Bedarf ersetzen oder hinzufügen kannst. Das Layout, die Farben, Schriftarten und Animationen sind alle anpassbar, wenn du möchtest, dass das Inventar ein einzigartiges Aussehen für deine Server-Marke hat.

Was es auszeichnet

Das ist nicht nur ein weiteres Inventarskript – es ist zum Gemeinschaftsstandard für QBCore-Server geworden, weil es die Komplexität richtig handhabt. Item-Duplikationsfehler werden durch serverseitige Validierung verhindert. Gewichtsberechnungen funktionieren korrekt mit Brüchen. Behälter synchronisieren sich korrekt in Multiplayer-Szenarien. Das UI ist responsiv und verursacht keine Verzögerungen beim Verwalten großer Inventare. Diese Details sind wichtig, wenn du einen belebten Server betreibst, bei dem Inventarfehler deine Wirtschaft zerstören können.

Der Entwickler hat dieses System eindeutig auf Produktionsservern verwendet, weil es Randfälle behandelt, die andere Inventarsysteme übersehen. Was passiert, wenn zwei Spieler gleichzeitig versuchen, den letzten Gegenstand aus einem Versteck zu nehmen? Was ist, wenn jemand die Verbindung trennt, während er einen Gegenstand zieht? Was ist mit Fahrzeugen, die despawnen, während sich Gegenstände im Kofferraum befinden? All diese Szenarien werden elegant ohne Gegenstandsverlust oder -vervielfältigung behandelt. Das ist der Schliff, der ein funktionierendes Skript von einem zuverlässigen Produktionssystem unterscheidet.

Technische Details

• Kundenleistung: Leichte Benutzeroberfläche mit optimiertem Rendering, minimale FPS-Auswirkung beim Öffnen
• Serverleistung: Effiziente Datenbankabfragen, zwischengespeicherte Inventardaten reduzieren den Suchaufwand
• Datenbank: Verwendet MySQL-Tabellen für dauerhafte Speicherung, für Leistung ordnungsgemäß indiziert
• Netzwerkoptimierung: Synchronisiert nur geänderte Slots, nicht das gesamte Inventar bei jedem Update
• Artikelbilder: Unterstützt PNG-Format, empfohlen 150x150px für optimale Anzeige
• Multiplayer-sicher: Alle Aktionen werden serverseitig validiert, verhindert Client-Manipulationsausnutzungen

Integration mit anderen Systemen

Das Inventarsystem exportiert Funktionen, die andere Ressourcen aufrufen können – AddItem, RemoveItem, GetInventory, CanCarryItem und mehr. Das bedeutet, dass deine Job-Skripte, Handwerkssysteme und Läden alle programmatisch mit dem Spielerinventar interagieren können. Ein Mechaniker-Job kann überprüfen, ob der Spieler Reparaturteile hat, bevor er eine Reparatur erlaubt. Ein Drogen-Skript kann den Inventarplatz überprüfen, bevor es ein Produkt hinzufügt. Alles verbindet sich durch standardisierte Exporte.

Für Entwickler, die benutzerdefinierte Skripte erstellen, bietet das Inventar Ereignisse und Callbacks. Löse ein Ereignis aus, wenn Items verwendet, entfernt oder fallen gelassen werden. Hooke in die Inventaröffnung ein, um benutzerdefinierte Validierungen hinzuzufügen. Höre auf Item-Metadaten-Änderungen, um externe Systeme zu aktualisieren. Der Rahmen ist erweiterbar, ohne dass Kern-Dateien geändert werden müssen, wodurch dein Setup upgrade-freundlich bleibt, wenn neue Versionen veröffentlicht werden.

Die Fahrzeug-Inventare integrieren sich mit den meisten Fahrzeugschlüssel/Eigentümersystemen. Nur autorisierte Spieler können auf den Kofferraum eines Fahrzeugs zugreifen, wodurch verhindert wird, dass zufällige Spieler dein Auto ausrauben. Immobilien-Verstecke sind mit Wohn-/Gang-Territoriumssystemen verbunden, sodass nur Gang-Mitglieder auf das Gang-Versteck zugreifen können. Laden-Inventare können von autorisierten Spielern neu bestückt werden, wodurch sich Spieler geführte Geschäftsmöglichkeiten ergeben. Das Berechtigungssystem ist flexibel genug, um jedes Zugriffskontrollszenario zu unterstützen, das dein Server benötigt.

Support & Updates

Als eine der am weitesten verbreiteten QBCore-Ressourcen profitiert das Inventarsystem von Community-Tests und Feedback. Fehler werden schnell identifiziert und behoben, weil tausende Server diesen Code ausführen. Updates erhalten die Kompatibilität mit QBCore-Rahmenänderungen, sodass du dich nicht auf alten Versionen wiederfindest, weil das Inventar kaputt ging. Der Code ist auch gut dokumentiert, was das Fehlerbeheben oder das Hinzufügen benutzerdefinierter Funktionen für deinen Server erleichtert.

Vorschauvideos