Inventare

4. Items und Inventare

Items werden nur auf Framework-Servern gebraucht. Die Dateien liegen in config/items/ und die Bilder in config/items/images/.

Was das Handy von selbst macht. Beim Start ermittelt es, welche Items die eingeschalteten Features brauchen (Tabelle unten), und dann:

Der Start-Check hat eine Zeile Items: [OK], wenn jedes Item da ist, oder [FAIL] mit den fehlenden Namen und der Lösung darunter. phone:health gibt sie erneut aus, nachdem du etwas behoben hast.

Wenn ein Item fehlt, startet das Handy trotzdem. Der Laden schaltet Boxen ab oder nimmt das Item aus dem Verkauf, und die Konsole nennt das Item, das du hinzufügen musst.

Reserves stapeln sich. Volle Packs tragen keine Metadaten, also teilen sich bis zu 20 einen Slot. Ein teilweise verbrauchter Pack, der abgenommen wird, wird zu einem eigenen Item mit seiner Ladung in den Metadaten (bei ox_inventory, qb-inventory und qs-inventory), braucht also einen freien Slot. Ohne Item-Metadaten (standalone, das Standard-Inventar von ESX) wird nur der Pack in Benutzung erfasst, einer pro Charakter und Größe.

Mit Config.Item.required = true (oder einzigartigen Handys) prüft der Server das Handy-Item über dein Inventar und lehnt Handy-Anfragen von Spielern ohne Handy ab. Verliert ein Spieler das Item, enden seine Anrufe, Notrufe eingeschlossen, und das Handy schließt sich.

Eine versiegelte Box an jemand anderen geben. Bei ox_inventory, qb-inventory und qs-inventory trägt das Box-Item selbst das gekaufte Modell und Finish, sodass jeder, der es öffnet, dieses Handy bekommt. Bei jedem anderen Inventar ist die Box ein einfaches Item, und Modell und Finish liegen im Kaufdatensatz des Käufers: Eine verschenkte Box öffnet sich als nächster eigener Kauf des neuen Besitzers oder als Standardmodell und -finish. Mit Config.Store.boxPerFinish = true behält der Name des Box-Items das Finish, aber nicht das Modell.

Der genaue Text zum Einfügen, für dein Inventar

Du musst nie selbst einen Item-Eintrag ausarbeiten. Wenn ein Item fehlt, gibt der Start-Check unter seinem Kasten genau den Text für dein Inventar aus, und Settings > Server > Health Check zeigt denselben Text mit einem Copy-Button. Füg ihn ein, starte das Inventar und das Handy neu und führ phone:health erneut aus.

So sieht jeder aus, für das Reserve:

-- ox_inventory/data/items.lua
['pulse_magpack'] = { label = "Pulse Reserve", weight = 110, stack = true, close = true, consume = 0, description = "Magnetic battery pack. Fills 70% of a phone.", client = { export = "phone.usePack", image = "pulse_magpack.png" } },

-- qb-core/shared/items.lua, qs-inventory and similar
['pulse_magpack'] = { name = "pulse_magpack", label = "Pulse Reserve", weight = 110, type = 'item', image = "pulse_magpack.png", unique = false, useable = true, shouldClose = true, description = "Magnetic battery pack. Fills 70% of a phone." },

-- TMC
['pulse_magpack'] = { ['label'] = "Pulse Reserve", ['weight'] = 110, ['type'] = 'item', ['image'] = "pulse_magpack.png", ['unique'] = false, ['stackable'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = "Magnetic battery pack. Fills 70% of a phone." },

-- ESX default inventory
INSERT IGNORE INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
  ('pulse_magpack', 'Pulse Reserve', 1, 0, 1);

Das eigene Item phone von ox_inventory. ox_inventory liefert einen Eintrag phone mit, der für ein anderes Handy-Script gemacht ist. Du musst ihn nicht ändern: Wird er benutzt, öffnet sich Pulse Phone. Der Start-Check hat eine Zeile Phone item, die sagt, wie dein Eintrag verknüpft ist. Nur wenn sie den Export eines anderen Scripts nennt ([WARN], oder [FAIL] mit Pflicht- oder einzigartigen Handys), gibt sie den Ersatz-Eintrag aus. Wenn das Handy-Script, für das dieser Eintrag gemacht wurde, noch läuft, öffnet das Item stattdessen dieses: Die Zeile Phone item nennt es; entferne es aus der server.cfg.

Was du für dein Inventar tun musst

Für die anderen Inventare in dieser Tabelle macht das Handy die Items selbst benutzbar. ox_inventory nutzt die Zeilen client = { export = 'phone....' }, die schon in seiner Datei stehen.

ox_inventory: Wenn du vorher ein anderes Handy genutzt hast, entferne auch seinen Item('phone', ...)-Hook aus ox_inventory/modules/items/client.lua.

ak47_inventory legt die Item-Benutzung im eigenen Eintrag jedes Items fest. Füg diese hinzu:

-- powerbank
server = { onUse = function(source) exports.phone:UsePowerbank(source) end },
-- pulse_magpack and pulse_magpack_max
server = { onUse = function(source, item) exports.phone:UseMagPack(source, item and item.slot, item and item.name) end },
-- pulse_cable
server = { onUse = function(source) exports.phone:UseChargingCable(source) end },
-- pulse_phone_box
server = { onUse = function(source, item) exports.phone:UseBox(source, item and item.slot) end },
-- pulse_router
server = { onUse = function(source) exports.phone:UseRouter(source) end },
-- pulse_burner
server = { onUse = function(source, item) exports.phone:UseBurner(source, item and item.slot) end },
-- pulse_case, pulse_case_clear, pulse_pouch, pulse_protector
server = { onUse = function(source, item) exports.phone:FitPhoneProtection(source, item and item.name) end },
-- pulse_buds
server = { onUse = function(source) exports.phone:UseBuds(source) end },
-- pulse_ringlight
server = { onUse = function(source) exports.phone:UseRingLight(source) end },
-- pulse_wallet
server = { onUse = function(source) exports.phone:UseCardWallet(source) end },

Einzigartige Handys (Config.Item.unique = true) legen die Telefonnummer auf das Item, sodass die Weitergabe des Items das Handy weitergibt. Sie brauchen ox_inventory, qb-inventory, qs-inventory, core_inventory oder codem-inventory.