Installation

Cinq minutes. Aucun fichier SQL, aucun réglage de framework : une permission et un redémarrage.

Avant de commencer

Vous avez besoin de	Pourquoi
ESX, QBCore ou QBox	Les items utilisables, les jobs, les notifications et le statut proviennent du framework
oxmysql	Les configurations des items sont stockées dans une table nommée `mic_itemcreator`
Un inventaire gérant les items utilisables du framework	C’est ainsi que l’utilisation de l’item parvient jusqu’à cette ressource
ox_lib, ox_target / qb-target, screenshot-basic	Optionnels ; voir Personnalisation

1. Mettre le dossier en place

Téléchargez mic_itemcreator depuis vos assets accordés Cfx.re et déposez le dossier dans vos ressources, par exemple resources/[mic]/mic_itemcreator.

2. Démarrer le script après ses dépendances

Dans server.cfg, ensure mic_itemcreator se place en dessous d’oxmysql, de votre framework (es_extended, qb-core ou qbx_core) et de votre inventaire.

Le framework est détecté en recherchant une ressource es_extended ou qb-core déjà démarrée, l’ordre est donc crucial : démarré trop tôt, il ne trouvera ni l’un ni l’autre. QBox est détecté via sa compatibilité QBCore — qbx_core fournissant qb-core — il n’y a donc rien à configurer.

3. La base de données — rien à faire

Lors de son premier démarrage, la ressource crée automatiquement la table mic_itemcreator (une ligne par item configuré), et ajoute toute colonne qu’une ancienne version n’avait pas. Il n’y a aucun fichier SQL à importer.

Cela fonctionne si la table mic_itemcreator est présente dans votre base de données après le premier démarrage.

4. Items

L’Item Creator n’ajoute pas d’items à votre inventaire — il attribue des actions aux items que vous possédez déjà. Chaque item que vous configurez doit au préalable exister dans votre inventaire.

Aucune définition d’item ni image n’est fournie avec. Pour les nouveaux items, l’outil Registry Tool du menu rédige la définition pour vous : choisissez OX, QBCORE ou ESX SQL, remplissez les champs, puis copiez le résultat dans ox_inventory/data/items.lua, qb-core/shared/items.lua ou votre table items d’ESX. Les images vont dans le dossier d’images propre à votre inventaire, nommées d’après l’item.

Le menu est verrouillé derrière la permission ACE mic_itemcreator.open. Accordez-la dans votre server.cfg avec une ligne add_ace — à une personne spécifique, par exemple add_ace identifier.discord:VOTRE_ID_DISCORD mic_itemcreator.open allow, ou à un groupe, par exemple add_ace group.admin mic_itemcreator.open allow.

La permission est vérifiée lors de votre connexion. Vous l’avez accordée alors que vous étiez déjà connecté ? Reconnectez-vous.

Cela fonctionne si la commande /itemcreator ouvre le menu sur le tableau de bord. Sans la permission, vous recevrez la notification « pas de permission ».

6. Premier test

/itemcreator → Usable Items, puis choisissez un item existant dans votre inventaire, par exemple water.
Ajoutez une fonctionnalité Notification avec un message, et une fonctionnalité Food/Thirst avec de la soif.
Ouvrez les paramètres de l’item, activez Remove on Use avec 1, puis enregistrez.
Donnez-vous l’item (le menu dispose d’un bouton pour cela, un à la fois) et utilisez-le depuis votre inventaire.

Cela fonctionne si la notification s’affiche, votre barre de soif augmente et un exemplaire de l’item est retiré de votre inventaire.

Avant d’ouvrir votre ville

Seules les personnes de confiance doivent avoir mic_itemcreator.open. Elle permet de faire faire n’importe quoi à n’importe quel item, y compris faire apparaître des véhicules, exécuter des commandes et conférer des super-pouvoirs.
Chaque item configuré doit exister dans votre inventaire, avec l’orthographe exacte.
Vérifiez que Config.ImageInventoryPath pointe bien vers le dossier d’images de votre inventaire, sans quoi le menu n’affichera aucune illustration.
Informez vos joueurs de la touche d’annulation — X par défaut — qui interrompt les animations, scénarios, styles de marche, vitesse, super-pouvoirs et props lancés par un item.