Aller au contenu

Personnalisation

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.


FichierCe qu’il décide
config.luaFramework, 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.luaRé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.luaLe texte 3D et le marqueur affichés en mode drawtext, ainsi que l’événement client qui sort ou range la corde
bridge/target.luaLes options ox_target et qb-target, ainsi que le basculement automatique vers drawtext
bridge/README.mdNotes 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.


OptionCe qu’elle faitDéfaut
Config.Frameworkesx ou qbcore. Sur QBox, utilisez qbcore — QBox gère les ressources QBCore via sa compatibilité. Toute autre valeur arrête la ressource au démarrageesx
Config.ItemL’item d’inventaire représentant la corderope
OptionCe qu’elle faitDéfaut
Config.InteractionSystemox_target, qb-target ou drawtext. Un target non démarré bascule sur drawtext jusqu’à ce qu’il se lanceox_target
Config.LabelsLe 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.KeyLabelsLe nom des touches affiché en mode drawtext : Attach et VehicleE, Y
Config.ShowInteractionMarkersAfficher un marqueur au-dessus du joueur ou du véhicule ciblable. Mode drawtext uniquementtrue

Ce que fait chaque action :

ActionQui peut la faireCe qui se passe
Traîner avec la cordeVous, la corde en main, près d’un joueur à piedCe joueur est attaché à votre main
Libérer le joueurLa personne qui traîneLa corde est retirée et le joueur se relève
Attacher au véhiculeLa personne qui traîne, près d’un véhiculeLa corde passe de votre main à l’arrière du véhicule
Détacher du véhiculeLa personne qui l’a attachéeLa corde revient dans votre main, joueur toujours attaché
Libérer le joueur (sur le véhicule)La personne qui l’a attachéeLe 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).

OptionCe qu’elle faitDéfaut
Config.AttachKeyAttraper ou libérer un joueur38 (E)
Config.AttachToVehicleKeyAttacher ou détacher d’un véhicule246 (Y)
Config.AdjustLengthUpKeyMaintenir pour allonger la corde172 (Flèche Haut)
Config.AdjustLengthDownKeyMaintenir pour raccourcir la corde173 (Flèche Bas)

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

OptionCe qu’elle faitDéfaut
Config.MaxDetectionDistanceDistance max (m) pour pouvoir attraper un joueur. Également la distance de target pour les joueurs2.0
Config.MaxVehicleAttachDistanceDistance max (m) pour pouvoir attacher la corde à un véhicule. Également la distance de target pour les véhicules5.0
Config.MarkerVisibilityDistancePrésent dans config.lua, mais non lu par la version actuelle — l’invite s’affiche pour quiconque se trouve dans les deux distances ci-dessus20.0
OptionCe qu’elle faitDéfaut
Config.InitialRopeLengthLongueur (m) au début de la traction3.0
Config.MinRopeLengthLongueur minimale accessible avec les flèches1.0
Config.MaxRopeLengthLongueur maximale accessible avec les flèches100.0
Config.RopeTypeType de corde du jeu1
Config.RopeSlackPrésent dans config.lua, mais non lu par la version actuelle — le mou de la corde dépend de sa longueur0.5
Config.RopePropModelLe prop dans la main du joueur. Le modèle par défaut est streamé depuis stream/prop_stag_do_rope
OptionCe qu’elle faitDéfaut
Config.MarkerTypeType de marqueur du jeu2
Config.MarkerHeightOffsetHauteur (m) au-dessus du joueur où se placent l’invite et le marqueur1.0
Config.MarkerScaleTaille du marqueur0.3
Config.MarkerColorCouleur du marqueur : rouge, vert, bleu et alpharouge, alpha 150
OptionCe qu’elle faitDéfaut
Config.DragCooldownMillisecondes d’attente entre deux actions de corde1000
Config.DisableControlsBloque toutes les commandes du joueur traîné. Désactivé, il peut agir tout en restant en ragdolltrue
Config.EnableMaxDragTimeRompt la corde automatiquement après MaxDragTimefalse
Config.MaxDragTimeSecondes avant la rupture de la corde, quand l’option ci-dessus est activée100
Config.NeedItemToReleaseÀ pied, libérer nécessite la corde en main. Le propriétaire peut toujours libérer quelqu’un attaché à un véhiculetrue

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