Inventari

4. Item e inventari

Gli item servono solo sui server con framework. I file sono in config/items/ e le immagini in config/items/images/.

Cosa fa il telefono da solo. All'avvio calcola quali item servono alle funzioni che hai attivato (la tabella qui sotto), e poi:

Il controllo all'avvio ha una riga Items: [OK] quando ci sono tutti gli item, oppure [FAIL] con i nomi mancanti e la soluzione sotto. phone:health la ristampa dopo che hai sistemato qualcosa.

Se manca un item, il telefono si avvia lo stesso. Il negozio disattiva le scatole o toglie quell'item dalla vendita, e la console indica l'item da aggiungere.

I Reserve si impilano. Le batterie cariche non hanno metadata, quindi fino a 20 condividono uno slot. Una batteria tolta a metà carica diventa un item a sé con la sua carica nei metadata (su ox_inventory, qb-inventory e qs-inventory), quindi le serve uno slot libero. Senza metadata degli item (standalone, l'inventario ESX predefinito) viene tracciata solo la batteria in uso, una per personaggio per ogni taglia.

Con Config.Item.required = true (o con i telefoni unici) il server verifica l'item telefono tramite il tuo inventario e rifiuta le richieste del telefono da un giocatore che non ce l'ha. Perdere l'item chiude le chiamate di quel giocatore, comprese quelle di emergenza, e chiude il telefono.

Regalare una scatola sigillata a qualcun altro. Su ox_inventory, qb-inventory e qs-inventory l'item scatola contiene il modello e la finitura acquistati, quindi chi la apre riceve quel telefono. Su tutti gli altri inventari la scatola è un item semplice e modello e finitura stanno nel registro acquisti dell'acquirente: una scatola regalata si apre come il prossimo acquisto del nuovo proprietario, o con il modello e la finitura predefiniti. Con Config.Store.boxPerFinish = true il nome dell'item scatola mantiene la finitura, ma non il modello.

Il testo esatto da incollare, per il tuo inventario

Non devi mai ricavare da solo la voce di un item. Quando manca un item, il controllo all'avvio stampa il testo esatto per il tuo inventario sotto il suo riquadro, e Settings > Server > Health Check mostra lo stesso testo con un pulsante Copy. Incollalo, riavvia l'inventario e il telefono, ed esegui di nuovo phone:health.

Come appare ciascuna, per il 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);

L'item phone di ox_inventory. ox_inventory include una voce phone fatta per un altro script telefono. Non devi modificarla: usarla apre Pulse Phone. Il controllo all'avvio ha una riga Phone item che dice come è collegata la tua voce. Solo quando indica l'export di un altro script ([WARN], o [FAIL] con telefoni obbligatori o unici) stampa la voce sostitutiva. Se lo script telefono per cui era fatta quella voce è ancora attivo, l'item apre quello: la riga Phone item lo indica; rimuovilo da server.cfg.

Cosa fare per il tuo inventario

Per gli altri inventari di questa tabella, il telefono rende gli item usabili da solo. ox_inventory usa le righe client = { export = 'phone....' } già presenti nel suo file.

ox_inventory: se prima usavi un altro telefono, rimuovi anche il suo hook Item('phone', ...) da ox_inventory/modules/items/client.lua.

ak47_inventory gestisce l'uso degli item nella voce di ciascun item. Aggiungi queste:

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

I telefoni unici (Config.Item.unique = true) mettono il numero di telefono sull'item, quindi passare l'item significa passare il telefono. Richiedono ox_inventory, qb-inventory, qs-inventory, core_inventory o codem-inventory.