Wie man ein Element erstellt (QBCore Framework)

Willkommen bei dieser Schritt-für-Schritt-Anleitung zum Erstellen eines benutzerdefinierten Artikels in QBCore, ein beliebtes Framework für FiveM-Rollenspielserver. Diese Anleitung führt dich durch den gesamten Prozess, von der Definition des Gegenstandes in shared.lua zur Erstellung eines Symbols für Ihr Inventar. Fangen wir an!

Einführung

Benutzerdefinierte Gegenstände verbessern das Rollenspielerlebnis, indem sie einzigartige Elemente zu Ihrem Server hinzufügen. Egal, ob Sie neue Lebensmittel, Waffen oder andere Gegenstände einführen, dieser Leitfaden wird Ihnen helfen, sie nahtlos in Ihren QBCore-Server zu integrieren.

QBCore's Item System verstehen

In QBCore werden Elemente in einer gemeinsamen Lua-Datei definiert, auf die sowohl der Server als auch der Client Zugriff haben. Jedes Objekt hat spezifische Attribute wie Name, Bezeichnung, Gewicht, Typ, Bild und mehr. Das Verständnis dieser Attribute ist entscheidend für die Erstellung funktionaler und ausgewogener Objekte.

Erstellen eines neuen Artikels in shared.lua

Auffinden der shared.lua Datei

Die shared.lua Datei werden alle Elementdefinitionen gespeichert. Sie finden sie im folgenden Verzeichnis:

[qb] > qb-core > shared > items.lua

Anmerkung: Bei einigen Versionen kann die Datei den Namen shared.lua oder Artikel.lua.

Struktur der Elementdefinition

Ein Element in QBCore wird über eine Lua-Tabelle mit bestimmten Schlüsseln definiert. Hier ist die allgemeine Struktur:

["itemname"] = {
    ["Name"] = "Artikelname",
    ["label"] = "Artikelbezeichnung",
    ["Gewicht"] = 0,
    ["Typ"] = "Artikel",
    ["image"] = "itemimage.png",
    ["unique"] = false,
    ["verwendbar"] = true,
    ["shouldClose"] = true,
    ["Kombinierbar"] = null,
    ["description"] = "Artikelbeschreibung"
},

• Name: In Skripten verwendeter Bezeichner.
• Etikett: Anzeigename im Inventar.
• Gewicht: Artikelgewicht (auf 0 gesetzt, wenn nicht verwendet).
• Typ: Normalerweise eingestellt auf "Artikel".
• Bild: Dateiname des Symbols für das Objekt.
• einzigartig: wahr wenn der Gegenstand einmalig ist (nicht stapelbar).
• brauchbar: wahr ob der Gegenstand verwendet werden kann.
• shouldClose: wahr um den Bestand nach Gebrauch zu schließen.
• Kombinierbar: Legt fest, ob der Artikel mit anderen kombiniert werden kann.
• Beschreibung: Eine kurze Beschreibung des Artikels.

Hinzufügen Ihres benutzerdefinierten Artikels

1. Öffnen Sie Artikel.lua oder shared.luaVerwenden Sie einen Texteditor wie Visual Studio Code oder Notepad++, um die Datei zu öffnen.
2. Ihre Artikeldefinition hinzufügen:Fügen Sie Ihre Elementdefinition innerhalb der vorhandenen Elemente ein. Zum Beispiel:luaCode kopieren["energy_drink"] = { ["name"] = "energy_drink", ["label"] = "Energy Drink", ["weight"] = 500, ["type"] = "item", ["image"] = "energy_drink.png", ["unique"] = false, ["useable"] = true, ["shouldClose"] = true, ["combinable"] = nil, ["description"] = "Eine Dose erfrischender Energydrink." },
   • Stellen Sie sicher, dass Ihr Artikelname ("energie_getränk") ist eindeutig und verwendet Unterstriche anstelle von Leerzeichen.
   • Die Bilddatei ("energie_getränk.png") sollte dem Symbol entsprechen, das Sie später hinzufügen werden.
3. Speichern Sie die DateiNachdem Sie Ihren Artikel hinzugefügt haben, speichern Sie die Artikel.lua oder shared.lua Datei.

Hinzufügen des Gegenstandssymbols zur Inventar-Benutzeroberfläche

Suchen oder Erstellen eines Symbols

Vorhandene Bilder verwenden

• Online-Ressourcen:
  • Flaticon
  • IconFinder
  • OpenGameArt
  Vergewissern Sie sich, dass Sie das Recht haben, die Bilder zu verwenden, und ziehen Sie die Lizenzierung in Betracht.

Erstellen eines eigenen Symbols

• Grafikdesign-Tools:
  • Adobe Photoshop
  • GIMP (kostenlose Alternative)
  • Canva (Online-Tool)
• Tipps:
  • Verwenden Sie einen transparenten Hintergrund (PNG-Format).
  • Das Design sollte mit den bestehenden Symbolen übereinstimmen.

Unterstützte Bildformate und -größen

• Format: PNG wird für die Unterstützung von Transparenz empfohlen.
• Größe: Normalerweise 64×64 Pixel, aber überprüfen Sie die vorhandenen Artikel-Symbole auf Konsistenz.

Platzierung des Symbols im richtigen Verzeichnis

1. Navigieren Sie zum Ordner "Inventory UI".:cssCode kopieren[qb] > qb-inventar > html > bilder
2. Ihr Icon hinzufügen:
   • Platzieren Sie Ihr Symbolbild (z. B., energie_getränk.png) in den Bilder Ordner.
   • Stellen Sie sicher, dass der Dateiname mit dem "Bild" Feld in Ihrer Artikeldefinition.
3. Ressource aktualisieren:
   • Wenn Ihr Server läuft, müssen Sie möglicherweise den qb-inventory Ressource oder starten Sie den Server ganz neu.

Testen Ihres neuen Artikels

1. Starten Sie den Server:Vergewissern Sie sich, dass Ihr Server ohne Fehler läuft.
2. Geben Sie sich selbst den GegenstandBenutzen Sie die Konsole im Spiel oder ein Admin-Menü, um sich das Item:bashCode kopieren zu geben./Gegenstand [DeineSpielerID] energy_drink 1
3. Prüfen Sie das Inventar:
   • Öffnen Sie Ihr Inventar.
   • Überprüfen Sie, ob das Element mit dem richtigen Symbol, Etikett und der richtigen Beschreibung angezeigt wird.
4. Verwenden Sie das Element:
   • Versuchen Sie, den Gegenstand zu benutzen, wenn er brauchbar ist.
   • Vergewissern Sie sich, dass es sich wie erwartet verhält.

Allgemeine Probleme und Fehlerbehebung

• Nicht angezeigtes Element:
  • Überprüfen Sie den Objektnamen und stellen Sie sicher, dass er korrekt zu Artikel.lua.
  • Überprüfen Sie, ob sich die Bilddatei im richtigen Verzeichnis befindet und mit dem Namen in der Objektdefinition übereinstimmt.
• Symbol wird nicht angezeigt:
  • Vergewissern Sie sich, dass die Bilddatei im PNG-Format vorliegt und im Ordner Bilder Ordner.
  • Vergewissern Sie sich, dass der Dateiname exakt übereinstimmt, einschließlich Groß- und Kleinschreibung.
• Fehler beim Serverstart:
  • Überprüfen Sie die Serverkonsole auf Fehlermeldungen.
  • Stellen Sie sicher, dass es keine Syntaxfehler in Artikel.lua (z. B. fehlende Kommas oder Klammern).

Schlussfolgerung

Das Erstellen von benutzerdefinierten Gegenständen in QBCore verbessert die Einzigartigkeit Ihres Servers und das Spielerlebnis. Wenn Sie diese Anleitung befolgen, sollten Sie nun in der Lage sein, neue Gegenstände hinzuzufügen, Symbole zuzuweisen und allgemeine Probleme zu beheben.