L'inventaire
Socle utilise ox_inventory pour l'inventaire, les coffres et les boîtes à gants. Les objets (nom, libellé, poids, image) sont déclarés dans les fichiers de données d'ox_inventory.
Beaucoup de réglages de Socle désignent un objet : l'objet requis pour un braquage, celui que donne une récolte, la récompense d'un butin… Si un réglage pointe vers un objet qui n'existe pas dans l'inventaire, l'action correspondante échoue en jeu.
La vérification automatique
La page Serveur › Santé du panel parcourt tous les réglages qui désignent un objet et signale ceux qui n'existent pas dans ox_inventory, avec un bouton Corriger vers le réglage concerné.
Deux façons de corriger :
- Changer le réglage pour un objet qui existe déjà ;
- Créer l'objet : le Créateur d'items du panel (Visuel › Créateur d'items) génère le bloc à coller dans les objets d'ox_inventory, en vérifiant que le nom est libre. Redémarre ensuite le serveur.
Objets utilisés par défaut
Les réglages livrés font référence à ces objets. Tu peux renommer ou remplacer n'importe lequel depuis le panel.
| Domaine | Objets |
|---|---|
| Véhicules, papiers, protection | vehicle_key, license_card, bproof_plates |
| Braquages : outils | bag_heist, thermite_bomb, hack_laptop, bolt_cutters, cutter |
| Braquages : butins | bijoux, watches, goldbar, golden_chalice, diamond, gold, paintingf, paintingg (et l'argent sale black_money) |
| Drogue | weed, weed_pooch, feuillechanvre, feuillecoca, acetone, cokepure, coke_pooch, methpure |
| Méthamphétamine | ingrédients meth_pills (pseudoéphédrine), ammonia, lithium ; produits meth_low, meth_mid, meth_high. Aussi déclarés dans les objets livrés : ethanol, meth_lab_kit (kit de cuisson) |
| Fermes | farm_bois, farm_planche |
| Pêche | cannes fishing_rod_one à fishing_rod_five, canneapeche, canneapechecarbonne ; appâts bait, simple_fish_bait, worm_fish_bait, illegal_fish_bait ; poissons (bass, trout, common_carp, sockeye_salmon…) |
| EMS | medikit, bandage, gauze, pills, defibrillator, pressure_monitor, radiography, scalpel, syringe, syrup, thermometer, tylenal |
| Magasins des PNJ | nourriture et boisson (bread, sandwich, water), phone, radio, lockpick, handcuffs, zipties, drill, laptop, matériel de plongée et de pêche, armes de base |
Objets des modules
Ces objets ont un usage : les utiliser depuis l'inventaire déclenche une action du module. Ils sont livrés dans le fichier d'objets d'ox_inventory. Le nom de l'objet se change dans la catégorie de réglages indiquée.
| Objet | Libellé livré | Module | À quoi il sert | Réglage |
|---|---|---|---|---|
speaker | Enceinte portable | Musique & enceintes | L'utiliser pose une enceinte au sol qui diffuse de la musique autour. Une seule enceinte posée par joueur par défaut. | soundsystem.speakerItem |
boosting_tablet | Tablette de boosting | Vol sur contrat (boosting) | Ouvre le menu des contrats de vol de véhicules. | boosting.accessItem |
evidence_bag | Sachet de preuve | Preuves & bodycam | Remis à l'enquêteur qui ramasse une douille ou du sang, avec ses détails (type, arme, série ou empreinte, lieu, date). Il se dépose au laboratoire pour analyse. | evidence.bagItem |
bleach | Eau de javel | Preuves & bodycam | Efface les preuves autour du joueur (3 m par défaut), consommé à chaque nettoyage réussi. | evidence.cleanItem |
bodycam | Bodycam | Preuves & bodycam | Active ou coupe la caméra-piéton d'un enquêteur en service : le serveur tient un journal horodaté (pas de vidéo). | evidence.bodycamItem |
pet_food | Croquettes | Animaux de compagnie | Nourrit son animal sorti. | pets.foodItem |
pet_leash | Laisse | Animaux de compagnie | Ouvre le menu de son animal. | pets.leashItem |
lockpick | Lockpick | Cambriolages & petits vols | Crocheter la porte d'une maison ou la portière d'un véhicule garé. En cas d'échec, il casse avec 35 % de chances par défaut. | burglary.houseTool, burglary.vehicleTool, burglary.toolBreakChance |
vehicle_key | Clé de véhicule | Clés de véhicule | Clé liée à une plaque (enregistrée dans l'objet) : elle permet de verrouiller ce véhicule (U). Remise par le garage, le garage d'entreprise, le démarreur forcé d'un véhicule volé, la livraison d'un contrat de boosting et /carkey ; reprise au retour d'un véhicule de location. Son nom est fixe : ne la renomme pas. | — |
license_card | Carte | Documents | Carte d'identité, permis ou carte de métier, imprimée par le PNJ de la mairie et affichée à l'écran quand on l'utilise. | licenses.item |
Ajouter un objet à la main
Si tu ne passes pas par le Créateur d'items, ajoute un bloc dans le fichier data/items.lua de la ressource ox_inventory, à l'intérieur du grand return { … }, puis redémarre le serveur. Format :
["pet_food"] = {
label = "Croquettes",
weight = 0.5,
stack = true,
close = true,
description = "Nourrit ton animal de compagnie.",
client = { image = "pet_food.png" },
},| Champ | Rôle |
|---|---|
["pet_food"] | Nom de l'objet : c'est lui que les réglages du panel attendent. |
label | Nom affiché dans l'inventaire. |
weight | Poids. |
stack | true : plusieurs exemplaires s'empilent ; false : un emplacement par exemplaire (utile quand chaque objet porte ses propres informations, comme une clé ou un sachet de preuve). |
close | true : l'inventaire se ferme quand on utilise l'objet. |
description | Texte d'aide affiché au survol. |
client = { image = "…" } | Image de l'objet, à placer dans web/images d'ox_inventory. Sans ce champ, ox_inventory cherche une image portant le nom de l'objet. |
Armes
Les armes vendues par les PNJ et utilisées par les braquages sont les armes standard de GTA (WEAPON_PISTOL, WEAPON_SMG, WEAPON_CARBINERIFLE, WEAPON_KNIFE…), déjà connues d'ox_inventory.