Items

Note

💬 Besoin d’aide ? Le support, les mises à jour et les changelogs sont sur le Discord de Mic Scripts. Ouvrez un ticket avec votre ID de transaction Tebex et l’erreur console.

Un design peut devenir un objet manipulable par les joueurs de trois manières : un item de vêtement, une tenue (outfit) qui enfile plusieurs designs simultanément, ou un item de boutique disposant de son propre nom que n’importe quel magasin peut vendre. Ces trois options nécessitent l’activation de Config.Items.Enabled (activé par défaut) et la présence d’ESX, QBCore ou QBox. Sur un serveur standalone, l’atelier fonctionne, mais les designs ne peuvent pas être transformés en items.

---

L’item générique

Item	Ce qu’il fait
cloth_design	Équipe le design ou la tenue associé. Réutilisez-le pour remettre ce que vous portiez

Le nom se configure via Config.Items.Name dans shared/config.lua. Les définitions sont fournies dans items/ox.lua (ox_inventory) et items/qb.lua (QBCore) — copiez l’entrée dans le fichier d’items de votre inventaire et redémarrez ce dernier. L’item n’est pas empilable : chaque exemplaire porte son propre design.

Sur ox_inventory, chaque exemplaire affiche le nom du design et, lorsque Fivemanage héberge les images, le rendu du design comme icône. Sur QBCore, un fichier cloth_design.png placé dans qb-inventory/html/images/ lui procure une icône par défaut.

---

Créer un item de vêtement

1. Exportez d’abord le design — un item nécessite un design préalablement sauvegardé sur un vêtement.
2. Dans l’atelier, cliquez sur Create Clothing Item à partir du design et donnez-lui un nom.
3. Vous recevez un exemplaire, et il apparaît sous My Content → Items.

Depuis la liste d’Items, vous pouvez vous donner un autre exemplaire, le renommer ou le supprimer. Pour le donner à un joueur, donnez-vous l’item puis transférez-le-lui comme n’importe quel objet.

Créer une tenue (outfit)

Dans My Content → Outfits, sélectionnez plusieurs de vos vêtements personnalisés, nommez la tenue et créez-la. La tenue correspond à un unique item cloth_design qui les enfile tous ensemble, et les retire tous lors d’une seconde utilisation.

Note

L’équipement dure le temps de la session. Utiliser un item modifie temporairement l’apparence actuelle du personnage ; cela n’est pas sauvegardé de manière permanente dans son apparence de base et disparaît après une reconnexion. Utilisez l’item à nouveau pour le réenfiler.

---

Vendre un design dans une boutique

Tout item ou tenue créé peut être exporté sous forme de son propre item d’inventaire, de sorte qu’une boutique ignorant tout des métadonnées puisse malgré tout le commercialiser.

1. Ouvrez My Content → Items.
2. Cliquez sur </> sur l’item.
3. Choisissez un nom d’item — lettres minuscules, chiffres et underscores. Il ne doit pas être déjà pris par un autre item exporté.
4. Cliquez sur Save name.
5. Copiez le bloc de code généré par l’atelier dans ox_inventory/data/items.lua ou qb-core/shared/items.lua, puis redémarrez votre inventaire.
6. Pour l’icône, déposez <nom_item>.png dans ox_inventory/web/images/ ou qb-inventory/html/images/. L’item fonctionne également sans image.

Vendez-le désormais où bon vous semble. Son utilisation équipe automatiquement le design correspondant. Le lien est établi côté serveur par le nom de l’item et réenregistré à chaque démarrage, évitant toute reconfiguration manuelle après un reboot.

Attention

Si le design associé à un item de boutique est supprimé, l’item reste dans les inventaires, mais son utilisation indiquera simplement que le design n’existe plus.

---

Partagé ou par joueur

Avec Config.GlobalContent = true (par défaut), tous les créateurs ayant accès à l’atelier voient et gèrent les mêmes items et tenues. Avec false, chaque designer ne voit que ses propres créations.