Zum Inhalt springen

Items

Ein Design kann auf drei Arten zu einem tragbaren Gegenstand für Spieler werden: als Kleidungs-Item, als Outfit, das mehrere Designs gleichzeitig anzieht, oder als Shop-Item mit eigenem Namen, das jeder normale Shop verkaufen kann. Alle drei Wege setzen ein aktives Config.Items.Enabled (standardmäßig an) sowie ESX, QBCore oder QBox voraus. Auf einem Standalone-Server funktioniert das Studio zwar, Designs können jedoch nicht in Items umgewandelt werden.


ItemFunktion
cloth_designZieht das hinterlegte Design oder Outfit an. Erneute Benutzung stellt die alte Kleidung wieder her

Der Item-Name wird über Config.Items.Name in shared/config.lua definiert. Definitionen liegen in items/ox.lua (ox_inventory) und items/qb.lua (QBCore) bei — trage den Eintrag in die Item-Datei deines Inventars ein und starte das Inventar neu. Das Item ist nicht stapelbar: Jedes Exemplar speichert sein eigenes Design.

Bei ox_inventory zeigt jedes Exemplar den Design-Namen und — sofern Fivemanage die Bilder hostet — den Render des Designs als Vorschaubild. Bei QBCore sorgt eine cloth_design.png in qb-inventory/html/images/ für ein Standard-Icon.


  1. Exportiere zuerst das Design — ein Item setzt ein auf einem Kleidungsstück gespeichertes Design voraus.
  2. Wähle im Studio beim gewünschten Design Create Clothing Item und vergib einen Namen.
  3. Du erhältst ein Exemplar und es erscheint unter My Content → Items.

Über die Items-Liste kannst du dir weitere Exemplare geben, das Item umbenennen oder löschen. Um es Spielern zu übergeben, gib es dir selbst und reiche es wie jeden anderen Gegenstand weiter.

Wähle unter My Content → Outfits mehrere deiner designten Kleidungsstücke aus, benenne das Outfit und erstelle es. Das Outfit ist ein einziges cloth_design-Item, das alle enthaltenen Stücke gemeinsam anzieht und bei erneuter Benutzung komplett wieder auszieht.


Jedes erstellte Item und jedes Outfit kann als eigenständiges Inventar-Item exportiert werden, sodass auch Shops ohne Metadaten-Unterstützung das Design verkaufen können.

  1. Öffne My Content → Items.
  2. Klicke beim entsprechenden Item auf </>.
  3. Wähle einen Item-Namen — Kleinbuchstaben, Zahlen und Unterstriche. Er darf noch nicht von einem anderen exportierten Item belegt sein.
  4. Klicke auf Save name.
  5. Kopiere den vom Studio generierten Codeblock in ox_inventory/data/items.lua oder qb-core/shared/items.lua und starte das Inventar neu.
  6. Hinterlege für ein Icon optional <item_name>.png in ox_inventory/web/images/ oder qb-inventory/html/images/. Es funktioniert auch ohne Bild.

Jetzt kann das Item in jedem beliebigen Shop angeboten werden. Die Benutzung zieht das Design an. Die Verknüpfung erfolgt serverseitig über den Item-Namen und wird bei jedem Serverstart automatisch registriert, sodass nach Neustarts nichts erneut gespeichert werden muss.


Mit Config.GlobalContent = true (Standard) sehen und verwalten alle autorisierten Studio-Nutzer dieselben Items und Outfits gemeinsam. Bei false sieht jeder Designer ausschließlich seine eigenen Inhalte.