Inventoryk

4. Tárgyak és inventoryk

Tárgyakra csak frameworkös szervereken van szükség. A fájlok a config/items/ mappában, a képek a config/items/images/ mappában vannak.

Amit a telefon magától elvégez. Induláskor kideríti, mely tárgyakra van szükségük a bekapcsolt funkcióidnak (lásd az alábbi táblázatot), majd:

Az indítási ellenőrzésben egy Items sor van: [OK], ha minden tárgy megvan, vagy [FAIL] a hiányzó nevekkel és alatta a javítással. A phone:health újra kiírja, miután javítottál valamit.

Ha egy tárgy hiányzik, a telefon ettől még elindul. Az üzlet kikapcsolja a dobozokat, vagy leveszi az adott tárgyat a kínálatról, és a konzol megnevezi a hozzáadandó tárgyat.

A Reserve-ek halmozódnak. A teli csomagok nem hordoznak metaadatot, így legfeljebb 20 osztozik egy helyen. Egy részben lemerült, levett csomag külön tárgy lesz, a töltöttségével a metaadataiban (ox_inventory, qb-inventory és qs-inventory alatt), ezért szabad hely kell neki. Tárgymetaadat nélkül (standalone, az alapértelmezett ESX inventory) csak a használatban lévő csomagot követi, karakterenként és méretenként egyet.

Config.Item.required = true esetén (vagy egyedi telefonoknál) a szerver az inventorydon keresztül ellenőrzi a telefontárgyat, és elutasítja annak a játékosnak a telefonos kéréseit, akinél nincs. Ha a tárgy elvész, a játékos hívásai véget érnek, a segélyhívásokat is beleértve, és a telefon bezárul.

Lezárt doboz átadása valaki másnak. Az ox_inventory, a qb-inventory és a qs-inventory alatt maga a doboz tárgy hordozza a megvásárolt modellt és kivitelt, így aki kinyitja, azt a telefont kapja. Minden más inventorynál a doboz egyszerű tárgy, a modell és a kivitel pedig a vásárló saját vásárlási nyilvántartásában van: egy elajándékozott doboz az új tulajdonos saját következő vásárlásaként nyílik ki, vagy az alapértelmezett modellel és kivitellel. Config.Store.boxPerFinish = true esetén a doboz tárgy neve megőrzi a kivitelt, a modellt viszont nem.

A pontos beillesztendő szöveg az inventorydhoz

Soha nem kell magadnak kitalálnod egy tárgybejegyzést. Ha egy tárgy hiányzik, az indítási ellenőrzés a doboza alatt kiírja a pontos szöveget a te inventorydhoz, a Settings > Server > Health Check pedig ugyanezt a szöveget mutatja egy Copy gombbal. Illeszd be, indítsd újra az inventoryt és a telefont, majd futtasd újra a phone:health parancsot.

Így néz ki mindegyik a Reserve esetében:

-- 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);

Az ox_inventory saját phone tárgya. Az ox_inventory egy másik telefon scripthez készült phone bejegyzéssel érkezik. Nem kell módosítanod: használata a Pulse Phone-t nyitja meg. Az indítási ellenőrzésben van egy Phone item sor, amely megmondja, hogyan van bekötve a bejegyzésed. Csak akkor írja ki a helyettesítő bejegyzést, ha egy másik script exportját nevezi meg ([WARN], vagy kötelező vagy egyedi telefonok esetén [FAIL]). Ha az a telefon script, amelyhez a bejegyzés készült, még fut, a tárgy inkább azt nyitja meg: a Phone item sor megnevezi; töröld a server.cfg fájlból.

Teendők az inventorydhoz

A táblázat többi inventoryjánál a telefon magától teszi használhatóvá a tárgyakat. Az ox_inventory a fájljában már meglévő client = { export = 'phone....' } sorokat használja.

ox_inventory: ha korábban másik telefont használtál, töröld annak Item('phone', ...) hookját is az ox_inventory/modules/items/client.lua fájlból.

Az ak47_inventory minden tárgy saját bejegyzésében tárolja a használatot. Add hozzá ezeket:

-- 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 },

Az egyedi telefonok (Config.Item.unique = true) a telefonszámot a tárgyra teszik, így a tárgy átadásával a telefon is gazdát cserél. Ehhez ox_inventory, qb-inventory, qs-inventory, core_inventory vagy codem-inventory kell.