Inventories

4. Items og inventories

Items er kun nødvendige på servere med framework. Filerne ligger i config/items/ og billederne i config/items/images/.

Hvad telefonen gør af sig selv. Ved opstart finder den ud af, hvilke items de funktioner, du har slået til, kræver (tabellen nedenfor), og derefter:

Opstartstjekket har én Items-linje: [OK], når alle items er der, eller [FAIL] med de manglende navne og løsningen nedenunder. phone:health udskriver den igen, når du har rettet noget.

Hvis et item mangler, starter telefonen stadig. Butikken slår æsker fra eller tager det item ud af salg, og konsollen nævner det item, der skal tilføjes.

Reserves stables. Fulde packs har ingen metadata, så op til 20 deler én plads. En pack, der tages af delvist brugt, bliver sit eget item med sin opladning i metadata (på ox_inventory, qb-inventory og qs-inventory), så den kræver en ledig plads. Uden item-metadata (standalone, ESX' standard-inventory) spores kun den pack, der er i brug, én pr. karakter pr. størrelse.

Med Config.Item.required = true (eller unikke telefoner) tjekker serveren telefon-item'et via dit inventory og afviser telefonforespørgsler fra en spiller uden det. Mister spilleren item'et, afsluttes spillerens opkald, også nødopkald, og telefonen lukkes.

At give en forseglet æske til en anden. På ox_inventory, qb-inventory og qs-inventory bærer æske-item'et selv den model og finish, der blev købt, så den, der åbner den, får den telefon. På alle andre inventories er æsken et almindeligt item, og modellen og finishen ligger i køberens egen købsregistrering: en æske, der gives væk, åbner som den nye ejers eget næste køb eller som standardmodellen og -finishen. Med Config.Store.boxPerFinish = true beholder æske-item'ets navn finishen, men ikke modellen.

Den præcise tekst at indsætte, til dit inventory

Du skal aldrig selv regne en item-indgang ud. Når et item mangler, udskriver opstartstjekket den præcise tekst til dit inventory under sin boks, og Settings > Server > Health Check viser den samme tekst med en Copy-knap. Indsæt den, genstart inventory og telefonen, og kør phone:health igen.

Hvordan hver ser ud, for 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);

ox_inventory's eget phone-item. ox_inventory leveres med en phone-indgang lavet til et andet telefonscript. Du behøver ikke ændre den: når den bruges, åbner den Pulse Phone. Opstartstjekket har en Phone item-linje, der fortæller, hvordan din indgang er koblet. Kun når den nævner et andet scripts export ([WARN], eller [FAIL] med påkrævede eller unikke telefoner), udskriver den erstatningsindgangen. Hvis det telefonscript, indgangen blev lavet til, stadig kører, åbner item'et i stedet det: Phone item-linjen nævner det; fjern det fra server.cfg.

Hvad du skal gøre for dit inventory

For de andre inventories i denne tabel gør telefonen selv items brugbare. ox_inventory bruger linjerne client = { export = 'phone....' }, der allerede er i dens fil.

ox_inventory: hvis du brugte en anden telefon før, så fjern også dens Item('phone', ...)-hook fra ox_inventory/modules/items/client.lua.

ak47_inventory styrer brugen af items i hvert items egen indgang. Tilføj disse:

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

Unikke telefoner (Config.Item.unique = true) lægger telefonnummeret på item'et, så når item'et gives videre, gives telefonen videre. De kræver ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory.