Dépannage

Les problèmes pouvant survenir avec la corde, et où chercher la solution.

Une modification de la ressource n’a rien changé

La commande restart ne relit pas le fichier fxmanifest.lua. Après avoir mis à jour mic_drag vers une nouvelle version ou ajouté un fichier, exécutez d’abord refresh dans la console serveur, puis restart mic_drag. Les modifications apportées à config.lua ne nécessitent quant à elles qu’un simple redémarrage (restart).

La ressource s’arrête au démarrage avec “Config.Framework must be esx or qbcore”

Config.Framework dans config.lua a une valeur différente de esx ou qbcore. Il n’y a pas d’auto-détection — définissez-le sur le framework que vous utilisez. S’il est déjà correctement configuré, c’est que mic_drag démarre avant votre framework : déplacez ensure mic_drag en dessous de celui-ci dans votre server.cfg.

Sur QBox, la valeur attendue est qbcore — QBox gère les ressources QBCore via sa couche de compatibilité — et qbx_core doit impérativement démarrer avant mic_drag.

Utiliser l’item ne fait rien

Dans l’ordre des vérifications :

L’item n’est pas enregistré. La corde enregistre Config.Item via le gestionnaire d’items utilisables de votre framework. Si votre inventaire utilise ses propres callbacks d’items à la place, déclenchez mic_drag:useRope depuis celui-ci (voir « Le bridge » dans Personnalisation).
Nom de l’item sous QBCore. L’entrée fournie par défaut pour QBCore a un name défini sur Rope. Il doit être en minuscules : rope, identique à la clé de l’item et à Config.Item.
Le prop ne se charge pas. Le prop de la corde est streamé depuis stream/. Si ce dossier n’a pas été transféré sur le serveur, la corde n’apparaîtra jamais dans votre main.
Vous êtes vous-même en train d’être traîné. Aucun item ne peut être utilisé lorsqu’on est au bout d’une corde.

La corde est dans ma main mais je ne peux attraper personne

La corde ne peut attraper que des joueurs — pas les PNJ, et pas vous-même.
La cible doit être à pied, vivante et située dans la limite de Config.MaxDetectionDistance (2 m par défaut). Vous devez également être à pied.
Le serveur vérifie que vous possédez toujours l’item dans votre inventaire au moment où la traction commence. Si l’item a quitté votre inventaire alors que le prop était sorti, l’action est refusée.
Vous ne pouvez traîner qu’une seule personne à la fois, et une personne déjà attachée à une corde ne peut pas être attrapée une seconde fois.

Regardez la console client (F8). Le message “ox_target is not started; using drawtext until it starts” signifie que le système de target configuré dans Config.InteractionSystem n’est pas démarré — la corde utilise en attendant le texte 3D et la touche E. Vérifiez que le nom est exactement ox_target ou qb-target ; toute autre valeur affichera “Unknown InteractionSystem” et basculera sur drawtext.

Impossible d’attacher la corde à une voiture

Vous devez être en train de traîner quelqu’un, corde en main, à une distance inférieure à Config.MaxVehicleAttachDistance du véhicule (5 m par défaut). Le véhicule doit être un véhicule synchronisé sur le réseau — les véhicules purement locaux / côté client sont refusés.

L’invite affiche la mauvaise touche

Vous avez modifié Config.AttachKey ou Config.AttachToVehicleKey, mais pas Config.KeyLabels. Les libellés ne sont que de simples textes ; mettez-les à jour pour qu’ils correspondent.

La corde s’est détachée toute seule

Config.EnableMaxDragTime est activé et le délai de Config.MaxDragTime secondes s’est écoulé. La corde se détache également si l’un des deux joueurs déconnecte, si le véhicule auquel elle est attachée est supprimé, ou si le joueur traîné s’éloigne trop de celui qui le tire.

Le joueur traîné peut toujours bouger sa caméra ou appuyer sur des touches

Config.DisableControls est désactivé (false). Passez-le à true pour bloquer tous les contrôles lorsqu’un joueur se trouve au bout de la corde.