Inventários

4. Itens e inventários

Os itens só são precisos em servidores com framework. Os ficheiros estão em config/items/ e as imagens em config/items/images/.

O que o telemóvel faz sozinho. No arranque, determina de que itens precisam as funcionalidades que ativou (a tabela abaixo) e depois:

A verificação de arranque tem uma linha Items: [OK] quando todos os itens estão lá, ou [FAIL] com os nomes em falta e a solução por baixo. O phone:health mostra-a outra vez depois de corrigir algo.

Se faltar um item, o telemóvel arranca na mesma. A loja desliga as caixas ou retira esse item de venda, e a consola indica o item a adicionar.

Os Reserves empilham. As baterias cheias não têm metadados, por isso até 20 partilham uma ranhura. Uma bateria retirada a meio da carga passa a ser um item próprio com a carga nos metadados (no ox_inventory, qb-inventory e qs-inventory), por isso precisa de uma ranhura livre. Sem metadados de itens (standalone, o inventário padrão do ESX), só a bateria em uso é acompanhada, uma por personagem e por tamanho.

Com Config.Item.required = true (ou telemóveis únicos), o servidor verifica o item do telemóvel através do seu inventário e recusa os pedidos de um jogador que não o tenha. Perder o item termina as chamadas desse jogador, incluindo as de emergência, e fecha o telemóvel.

Dar uma caixa selada a outra pessoa. No ox_inventory, qb-inventory e qs-inventory, o próprio item da caixa guarda o modelo e o acabamento que foram comprados, por isso quem a abrir recebe esse telemóvel. Em todos os outros inventários, a caixa é um item simples e o modelo e o acabamento ficam no registo de compra do comprador: uma caixa oferecida abre como a próxima compra do novo dono, ou com o modelo e o acabamento padrão. Com Config.Store.boxPerFinish = true, o nome do item da caixa guarda o acabamento, mas não o modelo.

O texto exato a colar, para o seu inventário

Nunca tem de escrever uma entrada de item por si. Quando falta um item, a verificação de arranque mostra o texto exato para o seu inventário por baixo da caixa, e Settings > Server > Health Check mostra o mesmo texto com um botão Copiar. Cole-o, reinicie o inventário e o telemóvel, e corra phone:health outra vez.

Como fica cada um, para o 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);

O item phone do próprio ox_inventory. O ox_inventory traz uma entrada phone feita para outro script de telemóvel. Não precisa de a alterar: usá-la abre o Pulse Phone. A verificação de arranque tem uma linha Phone item que diz como a sua entrada está ligada. Só quando indica o export de outro script ([WARN], ou [FAIL] com telemóveis obrigatórios ou únicos) é que mostra a entrada de substituição. Se o script de telemóvel para o qual essa entrada foi feita ainda estiver a correr, o item abre esse em vez do Pulse: a linha Phone item indica-o; remova-o do server.cfg.

O que fazer para o seu inventário

Para os outros inventários desta tabela, o telemóvel torna os itens utilizáveis sozinho. O ox_inventory usa as linhas client = { export = 'phone....' } que já estão no seu ficheiro.

ox_inventory: se usou outro telemóvel antes, remova também o seu hook Item('phone', ...) de ox_inventory/modules/items/client.lua.

O ak47_inventory define o uso de cada item na sua própria entrada. Adicione estas:

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

Os telemóveis únicos (Config.Item.unique = true) guardam o número de telemóvel no item, por isso entregar o item entrega o telemóvel. Requerem ox_inventory, qb-inventory, qs-inventory, core_inventory ou codem-inventory.