Inventaires

4. Items et inventaires

Les items ne sont nécessaires que sur les serveurs avec framework. Les fichiers sont dans config/items/ et les images dans config/items/images/.

Ce que le téléphone fait tout seul. Au démarrage, il détermine de quels items ont besoin les fonctionnalités que vous avez activées (le tableau ci-dessous), puis :

La vérification au démarrage a une ligne Items : [OK] quand tous les items sont là, ou [FAIL] avec les noms manquants et la solution en dessous. phone:health l'affiche de nouveau après une correction.

Si un item manque, le téléphone démarre quand même. La boutique désactive les boîtes ou retire cet item de la vente, et la console nomme l'item à ajouter.

Les Reserves s'empilent. Les batteries pleines n'ont pas de métadonnées, donc jusqu'à 20 partagent un emplacement. Une batterie retirée en partie utilisée devient un item à part avec sa charge dans ses métadonnées (sur ox_inventory, qb-inventory et qs-inventory), elle a donc besoin d'un emplacement libre. Sans métadonnées d'items (standalone, inventaire ESX par défaut), seule la batterie en cours d'utilisation est suivie, une par personnage et par taille.

Avec Config.Item.required = true (ou les téléphones uniques), le serveur vérifie l'item téléphone via votre inventaire et refuse les requêtes téléphone d'un joueur qui ne l'a pas. Perdre l'item met fin aux appels de ce joueur, appels d'urgence compris, et ferme le téléphone.

Donner une boîte scellée à quelqu'un d'autre. Sur ox_inventory, qb-inventory et qs-inventory, l'item boîte porte lui-même le modèle et la finition achetés : la personne qui l'ouvre obtient ce téléphone. Sur tous les autres inventaires, la boîte est un item simple et le modèle et la finition sont stockés dans l'historique d'achat de l'acheteur : une boîte donnée s'ouvre comme le prochain achat du nouveau propriétaire, ou avec le modèle et la finition par défaut. Avec Config.Store.boxPerFinish = true, le nom de l'item boîte conserve la finition, mais pas le modèle.

Le texte exact à coller, pour votre inventaire

Vous n'avez jamais à rédiger vous-même une entrée d'item. Quand un item manque, la vérification au démarrage affiche le texte exact pour votre inventaire sous son encadré, et Settings > Server > Health Check affiche le même texte avec un bouton Copy. Collez-le, redémarrez l'inventaire et le téléphone, puis relancez phone:health.

À quoi ressemble chacun, pour la 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 propre à ox_inventory. ox_inventory fournit une entrée phone conçue pour un autre script de téléphone. Vous n'avez pas besoin de la modifier : l'utiliser ouvre Pulse Phone. La vérification au démarrage a une ligne Phone item qui indique comment votre entrée est branchée. C'est seulement quand elle nomme l'export d'un autre script ([WARN], ou [FAIL] avec les téléphones obligatoires ou uniques) qu'elle affiche l'entrée de remplacement. Si le script de téléphone pour lequel cette entrée a été conçue tourne encore, l'item ouvre celui-ci à la place : la ligne Phone item le nomme ; retirez-le de server.cfg.

Que faire pour votre inventaire

Pour les autres inventaires de ce tableau, le téléphone rend lui-même les items utilisables. ox_inventory utilise les lignes client = { export = 'phone....' } déjà présentes dans son fichier.

ox_inventory : si vous utilisiez un autre téléphone avant, retirez aussi son hook Item('phone', ...) de ox_inventory/modules/items/client.lua.

ak47_inventory définit l'utilisation de chaque item dans sa propre entrée. Ajoutez ceci :

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

Les téléphones uniques (Config.Item.unique = true) placent le numéro de téléphone sur l'item : donner l'item, c'est donner le téléphone. Ils nécessitent ox_inventory, qb-inventory, qs-inventory, core_inventory ou codem-inventory.