Installation
Cinq minutes. Un dossier, un item, une ligne dans config.lua.
Avant de commencer
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 5. Indiquez votre framework et votre interaction »Ouvrez config.lua :
Config.Framework—esx(par défaut) ouqbcore. Il n’y a pas d’auto-détection ; cette valeur doit correspondre. Sur QBox, choisissezqbcore: QBox fait tourner les ressources QBCore via sa couche de compatibilité.Config.InteractionSystem—ox_target(par défaut),qb-targetoudrawtext.
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
Section intitulée « 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
Section intitulée « Avant d’ouvrir votre serveur »Config.Frameworkcorrespond bien au framework que vous utilisez réellement (qbcoresur QBox).- QBCore : le
namede l’item est bienrope, en minuscules. - Les libellés dans
Config.Labelssont dans la langue de votre serveur — c’est le seul texte que les joueurs voient. Config.KeyLabelscorrespond toujours aux touches si vous avez modifiéConfig.AttachKeyouConfig.AttachToVehicleKey.- Décidez pour
Config.EnableMaxDragTime. Désactivé, la corde reste attachée jusqu’à ce que quelqu’un la détache.