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