Skip to main content
Erstellt ein neues Inventar in Datenbank und Speicher (abhängig von den Optionen). Existiert bereits ein Inventar mit der gleichen ID, wird das bestehende unverändert zurückgegeben.

Parameter

Rückgabewert

Hinweise

options-Felder:
  • maxWeight (number, optional): Maximale Gewichtskapazität
  • maxSlots (number, optional): Maximale Anzahl an Slots
  • columns (number, optional): Anzahl der Spalten für die Grid-Darstellung in der UI (z.B. 10 Slots insgesamt, aber 2 Spalten → 2x5-Grid)
  • temporary (boolean, optional): Bei true wird das Inventar nicht in der Datenbank gespeichert und geht beim Script-Neustart verloren
  • prefillItems (table, optional): Konfiguration für zufälligen Loot. Items werden per gewichteter Auswahl ohne Zurücklegen ausgewählt:
    • minTypes (number, optional): Minimale Anzahl unterschiedlicher Item-Typen. Standard: 1
    • maxTypes (number, optional): Maximale Anzahl unterschiedlicher Item-Typen. Standard: Pool-Größe
    • items (table, erforderlich): Array möglicher Items, jeder Eintrag: {name = string, chance = number, min = number, max = number, metadata = table?}
  • revealItems (table, optional): Schrittweise Item-Enthüllungsanimation beim Öffnen des Inventars:
    • delayPerItem (number, optional): Millisekunden zwischen jeder Item-Enthüllung. Standard: 1000
    • randomOrder (boolean, optional): Bei true werden Items in zufälliger statt Slot-Reihenfolge enthüllt. Standard: false
  • slots (table, optional): Konfiguration pro Slot. Key ist die Slot-Nummer, Wert ist eine SlotConfig-Tabelle: label, image, opacity, whitelist, blacklist
  • whitelist / blacklist (table, optional): Item-Filter auf Inventarebene. Format: {itemName = true, ...}
  • allowedJobs (table, optional): Jobs, die auf dieses Inventar zugreifen dürfen
  • allowedIdentifiers (table, optional): Charakter-Identifier, die auf dieses Inventar zugreifen dürfen
  • disableIncoming / disableOutgoing (boolean, optional): Transfers vom/zum Spieler blockieren
  • dropDisabled (boolean, optional): Bei true können Items aus diesem Inventar nicht fallen gelassen werden
  • noLimitDrag (boolean, optional): Bei true überspringt das Ziehen den Mengenauswahl-Dialog und bewegt den ganzen Stack. Intern für Shops genutzt
Außerdem:
  • Existiert id bereits, wird das bestehende Inventar unverändert zurückgegeben, statische items und prefillItems werden NICHT erneut angewendet
  • prefillItems nutzt gewichtete Zufallsauswahl ohne Zurücklegen (jeder Item-Typ kann nur einmal ausgewählt werden)
  • prefillItems wird über options verarbeitet, während statische items ein separater Parameter sind, sie dienen unterschiedlichen Zwecken
  • Nutze temporary = true für kurzlebige Inventare (Lootboxen, Event-Belohnungen), um Datenbank-Aufblähung zu vermeiden