Personnalisation

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.

Tout ce que vous pouvez modifier se trouve à deux endroits : config.lua pour le comportement, et le dossier bridge/ pour la façon dont la corde communique avec votre framework, votre target et votre interface texte. Les deux sont ouverts (listés dans escrow_ignore) ; client/client.lua et server.lua sont sous escrow.

---

Quel fichier décide de quoi

Fichier	Ce qu’il décide
config.lua	Framework, nom de l’item, système d’interaction, libellés, touches, distances, longueur et physique de la corde, marqueur, cooldown, limite de temps
bridge/server_bridge.lua	Récupération du framework, enregistrement de l’item rope comme utilisable, vérification de la présence de l’item chez le joueur
bridge/client_bridge.lua	Le texte 3D et le marqueur affichés en mode drawtext, ainsi que l’événement client qui sort ou range la corde
bridge/target.lua	Les options ox_target et qb-target, ainsi que le basculement automatique vers drawtext
bridge/README.md	Notes succinctes sur le bridge (en espagnol)
inventory/	Définitions d’items prêtes à l’emploi pour ox_inventory, QBCore et ESX
stream/	Le modèle de prop et la texture de la corde

Il n’y a pas de dossier locales/. Le seul texte visible par les joueurs réside dans les libellés de Config.Labels.

---

Framework et item

Option	Ce qu’elle fait	Défaut
Config.Framework	esx ou qbcore. Sur QBox, utilisez qbcore — QBox gère les ressources QBCore via sa compatibilité. Toute autre valeur arrête la ressource au démarrage	esx
Config.Item	L’item d’inventaire représentant la corde	rope

Interaction

Option	Ce qu’elle fait	Défaut
Config.InteractionSystem	ox_target, qb-target ou drawtext. Un target non démarré bascule sur drawtext jusqu’à ce qu’il se lance	ox_target
Config.Labels	Le texte de chaque action : grab (Traîner avec la corde), release (Libérer le joueur), attach (Attacher au véhicule), detach (Détacher du véhicule)	Anglais
Config.KeyLabels	Le nom des touches affiché en mode drawtext : Attach et Vehicle	E, Y
Config.ShowInteractionMarkers	Afficher un marqueur au-dessus du joueur ou du véhicule ciblable. Mode drawtext uniquement	true

Ce que fait chaque action :

Action	Qui peut la faire	Ce qui se passe
Traîner avec la corde	Vous, la corde en main, près d’un joueur à pied	Ce joueur est attaché à votre main
Libérer le joueur	La personne qui traîne	La corde est retirée et le joueur se relève
Attacher au véhicule	La personne qui traîne, près d’un véhicule	La corde passe de votre main à l’arrière du véhicule
Détacher du véhicule	La personne qui l’a attachée	La corde revient dans votre main, joueur toujours attaché
Libérer le joueur (sur le véhicule)	La personne qui l’a attachée	Le joueur est libéré directement depuis le véhicule

Touches

Les touches sont des numéros de contrôle FiveM. Les flèches fonctionnent dans tous les modes ; E et Y n’interviennent qu’en mode drawtext (avec un target, vous choisissez l’action dans le menu).

Option	Ce qu’elle fait	Défaut
Config.AttachKey	Attraper ou libérer un joueur	38 (E)
Config.AttachToVehicleKey	Attacher ou détacher d’un véhicule	246 (Y)
Config.AdjustLengthUpKey	Maintenir pour allonger la corde	172 (Flèche Haut)
Config.AdjustLengthDownKey	Maintenir pour raccourcir la corde	173 (Flèche Bas)

Si vous modifiez AttachKey ou AttachToVehicleKey, modifiez également Config.KeyLabels, sinon l’invite affichera l’ancienne touche.

Distances

Option	Ce qu’elle fait	Défaut
Config.MaxDetectionDistance	Distance max (m) pour pouvoir attraper un joueur. Également la distance de target pour les joueurs	2.0
Config.MaxVehicleAttachDistance	Distance max (m) pour pouvoir attacher la corde à un véhicule. Également la distance de target pour les véhicules	5.0
Config.MarkerVisibilityDistance	Présent dans config.lua, mais non lu par la version actuelle — l’invite s’affiche pour quiconque se trouve dans les deux distances ci-dessus	20.0

La corde

Option	Ce qu’elle fait	Défaut
Config.InitialRopeLength	Longueur (m) au début de la traction	3.0
Config.MinRopeLength	Longueur minimale accessible avec les flèches	1.0
Config.MaxRopeLength	Longueur maximale accessible avec les flèches	100.0
Config.RopeType	Type de corde du jeu	1
Config.RopeSlack	Présent dans config.lua, mais non lu par la version actuelle — le mou de la corde dépend de sa longueur	0.5
Config.RopePropModel	Le prop dans la main du joueur. Le modèle par défaut est streamé depuis stream/	prop_stag_do_rope

Marqueur (mode drawtext)

Option	Ce qu’elle fait	Défaut
Config.MarkerType	Type de marqueur du jeu	2
Config.MarkerHeightOffset	Hauteur (m) au-dessus du joueur où se placent l’invite et le marqueur	1.0
Config.MarkerScale	Taille du marqueur	0.3
Config.MarkerColor	Couleur du marqueur : rouge, vert, bleu et alpha	rouge, alpha 150

Règles pendant la traction

Option	Ce qu’elle fait	Défaut
Config.DragCooldown	Millisecondes d’attente entre deux actions de corde	1000
Config.DisableControls	Bloque toutes les commandes du joueur traîné. Désactivé, il peut agir tout en restant en ragdoll	true
Config.EnableMaxDragTime	Rompt la corde automatiquement après MaxDragTime	false
Config.MaxDragTime	Secondes avant la rupture de la corde, quand l’option ci-dessus est activée	100
Config.NeedItemToRelease	À pied, libérer nécessite la corde en main. Le propriétaire peut toujours libérer quelqu’un attaché à un véhicule	true

Le joueur traîné est en ragdoll, ne peut pas tirer et reste invincible jusqu’au retrait de la corde.

---

Langues

Il n’y a pas de fichier de langue dédié. Traduisez simplement les quatre chaînes dans Config.Labels, ainsi que Config.KeyLabels si vos joueurs utilisent une autre nomenclature de touches.

---

Le bridge

Le dossier bridge/ est ouvert afin que vous puissiez adapter la corde à une configuration non reconnue par défaut. La physique de la corde et les événements réseau demeurent dans les fichiers sous escrow et n’ont pas besoin d’être modifiés.

• server_bridge.lua — framework et inventaire. Récupère ESX ou QBCore, enregistre Config.Item comme item utilisable et répond à la question « ce joueur possède-t-il une corde ? » au démarrage d’une traction. Pour un framework ou un inventaire personnalisé ayant sa propre API, réécrivez Bridge.GetPlayer, Bridge.HasRope et Bridge.RegisterRopeItem. N’enregistrez l’item qu’à un seul endroit — deux intégrations enregistrant le même item s’exécuteraient deux fois.
• client_bridge.lua — texte et marqueur. Bridge.DrawText et Bridge.DrawMarker affichent l’invite drawtext à chaque frame visible. Remplacez-les pour utiliser votre propre texte 3D ou ressource de TextUI. Ce fichier écoute également l’événement client mic_drag:useRope, qui sort ou range la corde — déclenchez-le depuis le callback d’utilisation d’un inventaire personnalisé si vous n’utilisez pas le système d’items utilisables du framework.
• target.lua — menus target. Ajoute et retire les options globales sur les joueurs et véhicules pour ox_target et qb-target, et bascule sur drawtext si le target s’arrête. Un autre système de target s’ajouterait ici.

---

Pour les autres scripts

Export (client)	Valeur retournée
GetInteractionState	Une table : mode (l’interaction en cours), hasRope (corde en main), targetServerId (joueur traîné), vehicle (véhicule auquel la corde est attachée), beingDragged, busy

Cet export est en lecture seule : très utile pour un HUD, ou pour permettre à un autre script d’éviter d’interagir avec un joueur actuellement attaché à une corde.