Inventarios

4. Items e inventarios

Los items solo hacen falta en servidores con framework. Los archivos están en config/items/ y las imágenes en config/items/images/.

Lo que hace el teléfono por sí solo. Al iniciar, determina qué items necesitan las funciones que tienes activadas (la tabla de abajo), y después:

La comprobación de inicio tiene una línea Items: [OK] cuando están todos los items, o [FAIL] con los nombres que faltan y la solución debajo. phone:health la vuelve a mostrar después de que arregles algo.

Si falta un item, el teléfono arranca igualmente. La tienda desactiva las cajas o retira ese item de la venta, y la consola nombra el item que hay que añadir.

Los Reserve se apilan. Los packs llenos no llevan metadata, así que hasta 20 comparten un hueco. Un pack que se quita a medio usar pasa a ser su propio item con su carga en la metadata (en ox_inventory, qb-inventory y qs-inventory), así que necesita un hueco libre. Sin metadata de items (standalone, el inventario por defecto de ESX) solo se sigue el pack en uso, uno por personaje y por tamaño.

Con Config.Item.required = true (o con teléfonos únicos) el servidor comprueba el item del teléfono a través de tu inventario y rechaza las peticiones del teléfono de un jugador que no lo tenga. Perder el item corta las llamadas de ese jugador, incluidas las de emergencia, y cierra el teléfono.

Dar una caja precintada a otra persona. En ox_inventory, qb-inventory y qs-inventory el propio item de la caja lleva el modelo y el acabado que se compraron, así que quien la abra recibe ese teléfono. En cualquier otro inventario la caja es un item simple, y el modelo y el acabado están en el registro de compra del comprador: una caja regalada se abre como la siguiente compra del nuevo dueño, o con el modelo y el acabado por defecto. Con Config.Store.boxPerFinish = true el nombre del item de la caja conserva el acabado, pero no el modelo.

El texto exacto que pegar, según tu inventario

Nunca tienes que escribir tú una entrada de item. Cuando falta un item, la comprobación de inicio muestra el texto exacto para tu inventario debajo de su recuadro, y Settings > Server > Health Check muestra el mismo texto con un botón Copy. Pégalo, reinicia el inventario y el teléfono, y vuelve a ejecutar phone:health.

Así es cada una, para el 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);

El item phone propio de ox_inventory. ox_inventory trae una entrada phone hecha para otro script de teléfono. No necesitas cambiarla: al usarla se abre Pulse Phone. La comprobación de inicio tiene una línea Phone item que indica cómo está conectada tu entrada. Solo cuando nombra el export de otro script ([WARN], o [FAIL] con teléfonos obligatorios o únicos) muestra la entrada de sustitución. Si el script de teléfono para el que se hizo esa entrada sigue en marcha, el item abre ese en su lugar: la línea Phone item lo nombra; quítalo de server.cfg.

Qué hacer según tu inventario

Para los demás inventarios de esta tabla, el teléfono hace que los items sean usables por sí mismo. ox_inventory usa las líneas client = { export = 'phone....' } que ya están en su archivo.

ox_inventory: si antes usabas otro teléfono, quita también su hook Item('phone', ...) de ox_inventory/modules/items/client.lua.

ak47_inventory guarda el uso de cada item en su propia entrada. Añade 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 },

Los teléfonos únicos (Config.Item.unique = true) ponen el número de teléfono en el item, así que entregar el item es entregar el teléfono. Necesitan ox_inventory, qb-inventory, qs-inventory, core_inventory o codem-inventory.