ai-inventory
Inventaire en grille avec tailles d’objets, emplacements rapides, objets au sol, stockages, coffres et boîtes à gants, magasins, fabrication et armes. Répond aux API d’ox_inventory et de qb-inventory.
ai-inventory est un inventaire en grille : chaque objet occupe un certain nombre de cases (un téléphone 1x1, un fusil 4x2) et peut être tourné pendant qu’on le fait glisser. Il contient les objets du joueur, le sol, les stockages, les coffres et boîtes à gants des véhicules, les magasins et les établis de fabrication, et les armes sous forme d’objets.
Ce qu’il fait en jeu
- La grille. Chaque inventaire a le même nombre de colonnes ; seuls les lignes et la limite de poids diffèrent. Les objets ont une taille en cases et un poids ; l’inventaire refuse ce qui ne rentre pas ou est trop lourd.
- L’écran (F2) : les vêtements du personnage sur deux colonnes autour du personnage, les cinq emplacements rapides, la grille du joueur, et le second inventaire (sol, coffre, stockage, magasin, établi) à droite. Cliquer sur un vêtement le retire ou le remet.
- Emplacements rapides. Cinq emplacements à part (pas des cases de la grille). Les touches 1 à 5 les utilisent ; TAB les affiche sous forme de barre en bas.
- Utiliser des objets. Double clic, ou le menu de l’objet. La nourriture et les boissons jouent une animation, remplissent la faim et la soif (ai-hud) et sont consommées. Le serveur vérifie que l’objet est toujours là après l’animation.
- Donner, jeter, diviser. Le menu de l’objet le donne au joueur le plus proche, le jette au sol ou divise une pile.
- Objets au sol. Les objets jetés reposent dans un sac au sol. Jeter à côté de votre propre sac l’ajoute à celui-ci. Les sacs disparaissent après quelques minutes sans être touchés.
- Coffres et boîtes à gants. F2 à l’arrière d’un véhicule ouvre son coffre (quand il est déverrouillé) ; à l’intérieur d’un véhicule, sa boîte à gants. Le coffre d’un véhicule possédé reste avec le véhicule, quelle que soit la plaque qu’il porte ; le coffre de tout autre véhicule est temporaire.
- Stockages. Des rangements à des endroits fixes, partagés ou un par personnage, ouverts à tous ou à certains métiers et gangs.
- Magasins. Des lieux avec des produits et des prix, un blip sur la carte et un PNJ facultatif, payés en liquide puis par la banque (selon le réglage).
- Établis de fabrication. Des recettes qui transforment des matériaux en objets en quelques secondes.
- Armes. Les armes sont des objets avec un numéro de série. Les munitions sont un objet ; R recharge à partir de celui-ci. Les accessoires (lampe, silencieux...) sont des objets qui se montent sur l’arme tenue. La roue des armes de GTA est désactivée par défaut : les armes viennent des emplacements rapides.
- Raretés. Les objets peuvent appartenir à une rareté dont la couleur teinte leur case.
- Armes venant d’ailleurs. Une arme qui n’a pas été donnée par ai-inventory est retirée au joueur.
Installation
La recipe txAdmin d’AI Core l’installe. À la main : placez le dossier dans resources/[ai]/ et ajoutez ensure ai-inventory à server.cfg après ensure ai-core. Il nécessite ai-core et la base de données :
add_convar_permission ai-inventory read mysql_connection_stringLa table ai_inventory_inventories est créée au premier démarrage. Les images des objets vont dans le dossier dist/web/images de la ressource (les images d’ox_inventory sont livrées avec).
Retirez ox_inventory et qb-inventory : ai-inventory répond à leurs noms.
Réglages du panneau
Ouvrez le panneau d’administration (F10) et choisissez Inventory.
Onglet Items
Chaque objet qui existe dans le jeu. Chaque objet est un enregistrement ; sa clé (water, lockpick) est le nom d’objet qu’utilisent les scripts. Le script est livré avec 242 objets (repris des listes d’ox_inventory).
Item : le nom que voient les joueurs et le type d’objet.
| Réglage | Ce qu’il change | Valeurs | Défaut pour un nouvel objet |
|---|---|---|---|
| Name | Le nom que voient les joueurs. | jusqu’à 48 caractères | |
| Description | Une ligne sous le nom. | jusqu’à 240 caractères | |
| Kind | Item (objet), Weapon (tenue en main à l’utilisation), Ammo (recharge l’arme tenue), Attachment (se monte sur l’arme tenue). | Item / Weapon / Ammo / Attachment | Item |
| Rarity | Teinte la case de l’objet avec la couleur d’une rareté (onglet Rarities). Vide : une case simple. | une rareté | aucune |
| Picture | Nom de fichier dans le dossier d’images (water.png) ou un lien https complet. Vide affiche une icône. | jusqu’à 200 caractères | |
| Other names | Les noms qu’utilisent d’autres scripts pour cet objet (par exemple pistol_ammo), pour qu’ils fonctionnent toujours. | jusqu’à 30 noms |
Size and weight : combien de cases occupe l’objet et son poids.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Width | Cases de gauche à droite. Les joueurs peuvent tourner un objet pendant qu’ils le font glisser. | 1 à 8 cases | 1 |
| Height | Cases de haut en bas. | 1 à 8 cases | 1 |
| Weight | Grammes par unité (1000 g = 1 kg). | 0 à 1 000 000 g | 100 |
| Stack size | Nombre maximum d’unités dans une pile. 1 rend chaque unité séparée, pour les objets qui ont leurs propres données. | 1 à 100 000 | 10 |
Using : ce qui se passe quand un joueur utilise l’objet.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Can be used | Désactivé : l’utiliser ne fait rien sauf si un script gère cet objet. | activé / désactivé | désactivé |
| Used up per use | Unités retirées à chaque utilisation. 0 le conserve. | 0 à 1000 | 0 |
| Close the inventory | Ferme l’écran d’inventaire quand l’objet est utilisé. | activé / désactivé | désactivé |
| Animation | Jouée pendant l’utilisation. | None / Eat / Drink / Bandage / Put on armour | None |
| Use time | Durée de l’animation avant que l’objet fasse effet. | 0 à 60 000 ms | |
| Hunger | Ajouté à la faim du joueur à l’utilisation (une valeur négative la baisse). Nécessite un HUD qui suit les besoins. | -100 à 100 | |
| Thirst | Ajouté à la soif. | -100 à 100 | |
| Stress | Ajouté au stress. | -100 à 100 |
Weapon : uniquement pour les armes et les accessoires.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Ammo item | Nom de l’objet que l’arme charge (par exemple ammo-9). | un nom d’objet | |
| Thrown | Grenades et assimilés : la quantité de la pile sert de munitions. | activé / désactivé | désactivé |
| Attachment hashes | Les noms de composants GTA que peut être cet accessoire (COMPONENT_AT_PI_FLSH) ; le premier qu’accepte l’arme tenue est utilisé. | jusqu’à 20 noms |
Supprimer un objet : les joueurs qui l’ont gardent une pile que personne ne peut utiliser.
Onglet Rarities
Les groupes de couleur auxquels appartiennent les objets. Livrées : Common, Uncommon, Rare, Epic, Legendary, Medical, Special.
| Réglage | Ce qu’il change | Valeurs |
|---|---|---|
| Name | Le nom de la rareté. | jusqu’à 32 caractères |
| Colour | La case de chaque objet de cette rareté en est teintée. | une couleur |
Supprimer une rareté : ses objets perdent leur couleur.
Onglet Shops
Les lieux où les joueurs achètent des objets. Le script est livré avec 45 magasins (24/7, LTD, Rob's Liquor, quincailleries, Ammu-Nation et autres, plus des magasins de métier pour la police et les EMS).
Shop : où se trouve le magasin et qui peut y acheter.
| Réglage | Ce qu’il change | Valeurs | Défaut pour un nouveau magasin |
|---|---|---|---|
| Shop name | Le nom que voient les joueurs. | jusqu’à 48 caractères | |
| Place | Placez-vous là où les joueurs doivent l’ouvrir et utilisez votre position. | un point | |
| Reach | À quelle distance un joueur doit être pour l’ouvrir. | 0,5 à 30 m | 2 |
| Jobs | Seuls les membres de ces métiers peuvent l’utiliser. Laissez les métiers et les gangs vides pour tout le monde. | noms de métiers | vide |
| Gangs | Les membres de ces gangs peuvent aussi l’utiliser. | noms de gangs | vide |
| Only on duty | Les membres d’un métier doivent être en service dans ce métier. | activé / désactivé | désactivé |
| Map blip | Affiche le magasin sur la carte. | activé / désactivé | activé |
| Blip look | Image, couleur et taille du blip (quand le blip est activé). | sprite, couleur, taille | |
| Paid from | Comptes d’argent essayés dans l’ordre. | jusqu’à 5 comptes | cash, bank |
Products : les objets que vend le magasin et leur prix à l’unité. Jusqu’à 100 lignes, chacune un Item et un Price (0 à 100 000 000 $).
NPC : un vendeur qui se tient au magasin. Model (vide pour aucun, visible à moins de 50 m), What it does (une animation d’attente), Where it stands (emplacement au sol et direction ; sans cela, il se tient sur le point du magasin).
Onglet Stashes
Des rangements à des endroits fixes. Livré : un Police Locker.
| Réglage | Ce qu’il change | Valeurs | Défaut pour un nouveau stockage |
|---|---|---|---|
| Stash name | Le nom que voient les joueurs. | jusqu’à 48 caractères | |
| Place | L’endroit où les joueurs l’ouvrent. | un point | |
| Reach | À quelle distance un joueur doit être. | 0,5 à 30 m | 1.5 |
| Jobs, Gangs, Only on duty | Qui peut l’ouvrir (comme pour les magasins). | tout le monde | |
| One per character | Activé : chaque personnage a son propre contenu. Désactivé : tous ceux qui peuvent l’ouvrir en partagent un seul. | activé / désactivé | désactivé |
| Rows | Lignes de cases ; la largeur est le réglage Columns. | 1 à 50 | 6 |
| Weight limit | Grammes. 0 signifie aucune limite. | 0 à 10 000 000 g | 100 000 |
Supprimer un stockage : les objets qui y sont rangés restent dans la base de données.
Onglet Crafting
Les établis où les joueurs transforment des matériaux en objets. Livré : un Workbench.
Bench : Bench name, Place, Reach (1,5 m par défaut), Jobs, Gangs, Only on duty, comme pour les magasins.
Recipes : jusqu’à 50 lignes.
| Réglage | Ce qu’il change | Valeurs | Défaut pour une nouvelle ligne |
|---|---|---|---|
| Makes | L’objet fabriqué. | un nom d’objet | lockpick |
| Amount | Combien sont fabriqués. | 1 à 1000 | 1 |
| Time | Le temps que cela prend. | 0 à 600 s | 5 |
| Materials | Ce qu’il utilise, sous la forme item:count séparés par des virgules : scrapmetal:3, paperbag:1. | jusqu’à 400 caractères | scrapmetal:3 |
Onglet Settings
La taille des inventaires.
| Carte | Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|---|
| Grid | Columns | Cases par ligne dans chaque inventaire. Les objets qui ne rentrent plus vont dans des cases libres ; un inventaire trop plein pour cela reçoit des lignes supplémentaires. | 6 à 14 | 8 |
| Grid | No GTA weapon wheel | La roue des armes de GTA et le changement d’arme à la molette restent désactivés : les armes se prennent dans les emplacements rapides (1-5). | activé / désactivé | activé |
| Player inventory | Rows | Ce qu’un personnage peut porter, en lignes. | 1 à 50 | 20 |
| Player inventory | Weight limit | Grammes ; 0 = aucune limite. | 0 à 10 000 000 g | 40 000 |
| Ground | Rows | La taille d’un sac au sol. | 1 à 50 | 6 |
| Ground | Weight limit | Grammes ; 0 = aucune limite. | 0 à 10 000 000 g | 1 000 000 |
| Ground | Disappears after | Les objets au sol disparaissent quand personne n’y a touché pendant ce temps. | 1 à 240 min | 15 |
| Ground | Bags per player | Combien de sacs un personnage peut avoir au sol en même temps. | 1 à 100 | 10 |
| Trunk | Rows | Le coffre de chaque véhicule. | 1 à 50 | 5 |
| Trunk | Weight limit | Grammes ; 0 = aucune limite. | 0 à 10 000 000 g | 80 000 |
| Glovebox | Rows | La boîte à gants de chaque véhicule. | 1 à 50 | 2 |
| Glovebox | Weight limit | Grammes ; 0 = aucune limite. | 0 à 10 000 000 g | 10 000 |
Un changement de colonnes, de lignes ou de poids atteint immédiatement les écrans ouverts.
Commandes
Aucune qui lui soit propre. Les administrateurs donnent et retirent des objets avec les outils d’objets d’ai-admin.
Raccourcis clavier
| Touche par défaut | Ce qu’elle fait | Nom dans les réglages de GTA |
|---|---|---|
| F2 | Ouvre l’inventaire (avec le sol, le coffre ou la boîte à gants à côté de vous) ou le ferme | Open the inventory |
| TAB | Affiche ou masque la barre d’emplacements rapides | Show / hide the quick slots bar |
| 1 à 5 | Utilise l’objet de cet emplacement rapide | Use the item in quick slot 1 (to 5) |
| R | Recharge l’arme tenue à partir d’un objet de munitions | Reload the weapon |
Dans l’écran : faites glisser pour déplacer, tournez l’objet pendant le glissement, double clic pour utiliser, clic droit pour le menu de l’objet, Échap ou F2 pour fermer.
Fonctionne avec d’autres scripts
- Remplace ox_inventory (
provide, API d’ox_inventory 2.44) et qb-inventory (provide, API 2.0) : leurs exports répondent, donc les scripts ox et QB donnent, retirent et vérifient des objets ici. Voir la page développeur pour ce qui est pris en charge et ce qui ne l’est pas. - La couche inventaire d’AI Core. Chaque script
ai-*et le pont ESX / QB donnent et retirent des objets via AI Core, qui appelle ai-inventory. - Vous pouvez le remplacer. AI Core a des adaptateurs pour d’autres inventaires (tgiann-inventory, codem-inventory, core_inventory, origen_inventory, jaksam_inventory et plus), chacun avec ses propres limites. Un inventaire pris en charge rend ai-inventory inutile : AI Core vous indique dans la console de le retirer. Voir Compatibilité.
Limites connues
- Une seule utilisation à la fois par joueur.
- Un nouveau sac au sol est limité à un par seconde par joueur, aux Bags per player du panneau, et à 50 par zone de la carte. Les résultats de fabrication et les objets jetés par des scripts échappent à ces limites.
- Les objets ne peuvent pas être jetés depuis l’intérieur d’un véhicule.
- Les hooks d’ox_inventory,
RegisterShopdans la forme d’ox, et la confiscation ne sont pas pris en charge (les magasins viennent du panneau ou duRegisterShoppropre à ai-inventory).
ai-appearance pour les développeurs
Les exports client d’ai-appearance, la forme d’une tenue de métier et les events qu’il utilise avec l’écran des personnages d’AI Core.
ai-inventory pour les développeurs
Les exports serveur et client d’ai-inventory, les objets utilisables, les magasins de script, l’event usedItem, et les API d’ox_inventory et de qb-inventory auxquelles il répond.