Aller au contenu

Installation

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


Vous avez besoinPourquoi
ESX, QBCore ou QBox, en cours d’exécutionL’item de corde est enregistré via votre framework
Un inventaire capable de gérer un item ropeox_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

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.


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”.


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.


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

ItemCe qu’il fait
ropeUtilisez-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 :

InventaireFichier dans mic_drag/inventory/Où le placer
ox_inventoryox_inventory.mdAjoutez l’entrée dans ox_inventory/data/items.lua
QBCore / qb-inventoryqb_inventory.mdAjoutez l’entrée dans qb-core/shared/items.lua
Inventaire ESX par défautesx_inventory.sqlImportez-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é.


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.


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

  1. Utilisez l’item rope. La corde apparaît dans votre main droite.
  2. 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.
  3. Éloignez-vous. Il vous suit au bout de la corde. Maintenez Flèche Haut / Flèche Bas pour modifier la longueur.
  4. 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.


  • 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.