Installation

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.

Cinq minutes, la plupart pour ajouter les items à votre inventaire.

---

Avant de commencer

Vous avez besoin	Pourquoi
ESX, QBCore ou QBox, démarré	Les quatre items utilisables sont enregistrés via votre framework
Un inventaire capable d’accueillir cinq nouveaux items	ox_inventory, qb-inventory ou celui d’ESX par défaut fonctionnent tous

---

1. Placez le dossier

Déposez mic_carbomb dans vos ressources, par exemple dans resources/[mic]/. Il n’y a aucune ressource de props associée.

---

2. Démarrez-le après votre framework

Dans server.cfg, placez ensure mic_carbomb en dessous de votre framework (es_extended, qb-core ou qbx_core) et de votre inventaire.

Cela a fonctionné lorsque la console du serveur n’affiche aucune ligne rouge venant de mic_carbomb au démarrage. Celle que vous ne voulez pas voir est : “Invalid framework specified in config.lua. Use ‘esx’ or ‘qbcore’.”

---

3. La base de données — rien de dédié

mic_carbomb conserve les bombes posées dans la mémoire du serveur, pas dans la base de données. La seule étape liée à la base de données concerne les lignes d’items ESX de l’étape 4, et uniquement si vous utilisez l’inventaire par défaut d’ESX.

---

4. Ajoutez les items

Item	Ce qu’il fait
car_bomb	Utilisez-le pour tenir une bombe, puis appuyez sur E près d’un véhicule pour la poser
phone_detonator	Ouvre le téléphone détonateur : vos bombes, faire exploser maintenant ou avec minuteur
bomb_detector	Sort le scanner ; réutilisez-le pour le ranger
bomb_defuser	Sort la boîte à outils ; appuyez sur E près d’un véhicule piégé pour désamorcer
defused_bomb	Non utilisable. Donné en retour après un désamorçage lorsque Config.ReturnDefusedBomb est activé

Les définitions prêtes à l’emploi sont fournies dans inventory_items/, et les icônes dans inventory_images/ :

Inventaire	Définitions (mic_carbomb/inventory_items/)	Où elles vont	Icônes
ox_inventory	ox_inventory.md	ox_inventory/data/items.lua	Copiez inventory_images/*.png vers ox_inventory/web/images/
QBCore / qb-inventory	qb_inventory.md	qb-core/shared/items.lua	Copiez-les vers qb-inventory/html/images/
Inventaire par défaut d’ESX	esx_sql_items.md	Exécutez l’instruction qu’il contient une fois sur votre base de données	—

Attention

QBCore : dans les entrées fournies, le champ name contient le label (Car Bomb, Phone Detonator…). Remplacez chaque name par sa clé — car_bomb, phone_detonator, bomb_detector, bomb_defuser, defused_bomb. QBCore trouve les items utilisables par ce nom, et avec le label à cet endroit, les items ne font rien lorsqu’ils sont utilisés.

Cela a fonctionné lorsque vous vous donnez un exemplaire de chaque et que les cinq s’affichent dans votre inventaire avec leur icône.

---

5. Indiquez votre framework

Ouvrez config.lua et définissez Config.Framework sur esx (par défaut) ou qbcore. Il n’y a pas de détection automatique. Sur QBox, choisissez qbcore : QBox exécute les ressources QBCore via sa couche de compatibilité.

Pendant que vous y êtes : Config.WebhookEnabled est activé par défaut avec une URL fictive. Collez votre webhook Discord dans Config.WebhookURL, ou réglez WebhookEnabled sur false.

---

6. Premier test

1. Faites apparaître un véhicule et sortez-en.
2. Utilisez car_bomb. Une bombe apparaît dans votre main. Approchez-vous du véhicule (à moins de 2 m) et appuyez sur E. L’animation de pose dure deux secondes et la bombe disparaît de votre main.
3. Utilisez bomb_detector et regardez vers le véhicule. Il bipe, et un blip rouge apparaît sur le véhicule.
4. Réutilisez bomb_detector pour le ranger. Éloignez-vous bien du véhicule, mais gardez-le en vue — le détonateur ne peut faire exploser qu’un véhicule qui est chargé autour de vous.
5. Utilisez phone_detonator. Le téléphone liste le modèle et la plaque du véhicule. Appuyez sur la touche verte.

Cela a fonctionné lorsque le véhicule explose et disparaît de la liste du téléphone.

Pour tester le désamorçage, posez une deuxième bombe, utilisez bomb_defuser, placez-vous à côté du véhicule et appuyez sur E. Cela a fonctionné lorsque l’animation de réparation se termine, les bips cessent, et un car_bomb vous est restitué.

---

Avant d’ouvrir votre ville

• Config.Framework correspond bien au framework que vous utilisez réellement (qbcore sur QBox).
• QBCore : le name de chaque item est identique à sa clé.
• Le webhook est une URL réelle ou est désactivé.
• config.lua est envoyé à tous les joueurs (c’est un script partagé). Quiconque fouille dans ses fichiers client peut lire l’URL du webhook. Utilisez un webhook pour un salon dont le spam ne vous dérange pas, ou laissez-le désactivé.
• Décidez du coût des items. Par défaut, la pose ne consomme pas la bombe (Config.RemoveItem est désactivé), donc un seul car_bomb permet au joueur de poser autant de bombes qu’il le souhaite.