Inventories

4. Items og inventories

Items trengs bare på servere med framework. Filene ligger i config/items/ og bildene i config/items/images/.

Hva telefonen gjør av seg selv. Ved oppstart finner den ut hvilke items funksjonene du har slått på trenger (tabellen nedenfor), og deretter:

Oppstartssjekken har én Items-linje: [OK] når alle itemene er der, eller [FAIL] med de manglende navnene og løsningen under. phone:health skriver den ut igjen etter at du har rettet noe.

Hvis et item mangler, starter telefonen likevel. Butikken slår av eskene eller tar det itemet ut av salg, og konsollen navngir itemet som skal legges til.

Reserver stables. Fulle pakker har ingen metadata, så opptil 20 deler én plass. En pakke som tas av delvis brukt blir sitt eget item med ladningen i metadataene (på ox_inventory, qb-inventory og qs-inventory), så den trenger en ledig plass. Uten item-metadata (standalone, standard ESX-inventory) spores bare pakken i bruk, én per karakter per størrelse.

Med Config.Item.required = true (eller unike telefoner) sjekker serveren telefon-itemet via inventoryet ditt og avviser telefonforespørsler fra en spiller uten det. Mister spilleren itemet, avsluttes samtalene, nødsamtaler inkludert, og telefonen lukkes.

Gi en forseglet eske til noen andre. På ox_inventory, qb-inventory og qs-inventory bærer selve eske-itemet modellen og utførelsen som ble kjøpt, så den som åpner den får den telefonen. På alle andre inventories er esken et vanlig item, og modellen og utførelsen ligger i kjøperens egen kjøpsoppføring: en eske som gis bort åpnes som den nye eierens eget neste kjøp, eller som standardmodell og -utførelse. Med Config.Store.boxPerFinish = true beholder eske-itemets navn utførelsen, men ikke modellen.

Nøyaktig tekst å lime inn, for ditt inventory

Du trenger aldri å finne ut av en item-oppføring selv. Når et item mangler, skriver oppstartssjekken ut nøyaktig tekst for ditt inventory under boksen, og Settings > Server > Health Check viser den samme teksten med en Copy-knapp. Lim den inn, start inventoryet og telefonen på nytt, og kjør phone:health igjen.

Slik ser hver av dem ut, 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 sitt eget phone-item. ox_inventory leveres med en phone-oppføring laget for et annet telefonscript. Du trenger ikke endre den: bruker du den, åpnes Pulse Phone. Oppstartssjekken har en Phone item-linje som sier hvordan oppføringen din er koblet. Bare når den navngir et annet scripts export ([WARN], eller [FAIL] med påkrevde eller unike telefoner) skriver den ut erstatningsoppføringen. Hvis telefonscriptet den oppføringen ble laget for fortsatt kjører, åpner itemet det i stedet: Phone item-linjen navngir det; fjern det fra server.cfg.

Hva du gjør for ditt inventory

For de andre inventoryene i denne tabellen gjør telefonen itemene brukbare selv. ox_inventory bruker client = { export = 'phone....' }-linjene som allerede er i filen.

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

ak47_inventory har bruk av items i hvert items egen oppføring. Legg til 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 },

Unike telefoner (Config.Item.unique = true) legger telefonnummeret på itemet, så å gi bort itemet er å gi bort telefonen. De krever ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory.