Installation

Cinq minutes. Un dossier, un item, une ligne dans config.lua.

Avant de commencer

Vous avez besoin	Pourquoi
ESX, QBCore ou QBox, en cours d’exécution	L’item de corde est enregistré via votre framework
Un inventaire capable de gérer un item `rope`	ox_inventory, qb-inventory ou l’inventaire ESX par défaut fonctionnent tous
ox_target ou qb-target (optionnel)	Uniquement si vous souhaitez le menu target plutôt que le texte 3D

1. Mettez le dossier en place

Déposez mic_drag dans vos ressources, par exemple dans resources/[mic]/. Conservez bien le dossier stream/ fourni avec : il contient le prop de la corde (prop_stag_do_rope) et sa texture ; sans lui, la corde n’apparaîtra jamais dans la main du joueur.

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

Dans server.cfg, placez ensure mic_drag en dessous de votre framework (es_extended, qb-core ou qbx_core) et sous votre inventaire. Si vous utilisez un target, démarrez-le également avant mic_drag — bien que la corde détectera automatiquement le target s’il démarre plus tard.

Vérification : la console serveur n’affiche aucune ligne rouge venant de mic_drag au démarrage. Celle à éviter absolument est “Config.Framework must be esx or qbcore”.

3. La base de données — rien de spécifique

mic_drag ne stocke rien. La seule étape de base de données est l’insertion de l’item ESX à l’étape 4, et uniquement si vous utilisez l’inventaire ESX par défaut.

4. Ajoutez l’item de corde

Le nom de l’item est rope (défini par Config.Item).

Item	Ce qu’il fait
`rope`	Utilisez-le pour prendre la corde en main ou la ranger. Nécessaire dans l’inventaire pour commencer à traîner. Jamais consommé

Les définitions prêtes à l’emploi sont fournies dans le dossier inventory/ de la ressource :

Inventaire	Fichier dans `mic_drag/inventory/`	Où le placer
ox_inventory	`ox_inventory.md`	Ajoutez l’entrée dans `ox_inventory/data/items.lua`
QBCore / qb-inventory	`qb_inventory.md`	Ajoutez l’entrée dans `qb-core/shared/items.lua`
Inventaire ESX par défaut	`esx_inventory.sql`	Importez-le une fois dans votre base de données

Aucune image d’item n’est fournie avec la ressource. Si votre inventaire affiche une icône vide, déposez n’importe quelle image rope.png dans le dossier d’images de votre inventaire (ox_inventory/web/images/ ou qb-inventory/html/images/).

Vérification : donnez-vous un rope et constatez qu’il apparaît dans votre inventaire avec son libellé.

5. Indiquez votre framework et votre interaction

Ouvrez config.lua :

Config.Framework — esx (par défaut) ou qbcore. Il n’y a pas d’auto-détection ; cette valeur doit correspondre. Sur QBox, choisissez qbcore : QBox fait tourner les ressources QBCore via sa couche de compatibilité.
Config.InteractionSystem — ox_target (par défaut), qb-target ou drawtext.

Si vous choisissez un target qui n’est pas démarré, vous verrez “ox_target is not started; using drawtext until it starts” dans la console client (F8) et la corde fonctionnera en attendant avec le texte 3D.

6. Premier test

Vous avez besoin d’un second joueur pour ce test — la corde ne peut attraper que des joueurs.

Utilisez l’item rope. La corde apparaît dans votre main droite.
Approchez-vous de l’autre joueur (à moins de 2 m). Avec un target, regardez-le et choisissez Drag with rope. Avec drawtext, appuyez sur E lorsque l’invite s’affiche.
Éloignez-vous. Il vous suit au bout de la corde. Maintenez Flèche Haut / Flèche Bas pour modifier la longueur.
Tenez-vous près d’une voiture et choisissez Tie to vehicle (ou appuyez sur Y avec drawtext). Roulez.

Vérification : l’autre joueur est en ragdoll au bout d’une corde bien visible, et la corde passe de votre main à l’arrière du véhicule quand vous l’attachez.

Avant d’ouvrir votre serveur

Config.Framework correspond bien au framework que vous utilisez réellement (qbcore sur QBox).
QBCore : le name de l’item est bien rope, en minuscules.
Les libellés dans Config.Labels sont dans la langue de votre serveur — c’est le seul texte que les joueurs voient.
Config.KeyLabels correspond toujours aux touches si vous avez modifié Config.AttachKey ou Config.AttachToVehicleKey.
Décidez pour Config.EnableMaxDragTime. Désactivé, la corde reste attachée jusqu’à ce que quelqu’un la détache.