Documentation — NC Vehicle Jack

NC Vehicle Jack FREE v1.0.0 ajoute une mécanique immersive de levage de véhicule avec un cric, démontage physique des roues, récupération au sol puis remontage.

Fonctionnalités

• Standalone : aucun ESX ou QBCore requis
• Interactions avec ox_target
• Choix du côté gauche ou droit
• Cric physique visible sous le véhicule
• Levage et descente progressifs
• Démontage individuel des quatre roues
• Roue détachée et déposée au sol
• Récupération puis remontage de la roue
• Sécurité empêchant la descente si une roue est démontée
• Suppression automatique du cric après la descente

Tous les réglages accessibles au propriétaire du serveur sont dans shared/config.lua.

Placez le dossier de la ressource dans resources. Le script ne nécessite aucune base de données.

Dépendances obligatoires

• ox_lib
• ox_target

server.cfg

ensure ox_lib
ensure ox_target
ensure NC_Vehicle_Jack_FREE

Si vous renommez le dossier de la ressource, utilisez son nouveau nom dans server.cfg.

Le fichier shared/config.lua est déclaré dans escrow_ignore et reste modifiable.

La configuration se trouve dans shared/config.lua.

Où régler chaque fonctionnalité ?

• Mode debug → Config.Debug
• Modèle du cric → Config.JackProp
• Distance ox_target sur le véhicule → Config.TargetDistance
• Distance de recherche du véhicule → Config.InteractDistance
• Hauteur de levage → Config.LiftHeight
• Inclinaison du véhicule → Config.LiftRoll
• Vitesse de montée/descente → Config.LiftDuration
• Durée d'installation/retrait → Config.InstallDuration
• Position du cric → Config.JackOffsets
• Distance d'interaction des roues → Config.WheelTargetDistance
• Durée du démontage → Config.WheelRemoveDuration
• Configuration des roues/bones → Config.Wheels
• Durée du remontage → Config.WheelInstallDuration
• Distance pour récupérer une roue au sol → Config.WheelPickupDistance
• Hauteur de pose de la roue au sol → Config.WheelGroundOffset

Le modèle et les distances d'interaction sont configurés dans shared/config.lua.

Modèle du cric

Config.JackProp = `prop_carjack`

Remplacez cette valeur par un autre modèle GTA valide si vous souhaitez changer l'apparence du cric.

Distances

Config.TargetDistance = 2.5
Config.InteractDistance = 3.0

• TargetDistance : distance maximale des options ox_target sur le véhicule.
• InteractDistance : rayon utilisé pour retrouver le véhicule lors du choix gauche/droite.

Le comportement visuel du levage se règle avec trois paramètres.

Config.LiftHeight = 0.34
Config.LiftRoll = 5.5
Config.LiftDuration = 2200

• LiftHeight : hauteur utilisée pour lever visuellement le véhicule.
• LiftRoll : inclinaison en degrés. Le signe est appliqué automatiquement selon le côté choisi.
• LiftDuration : durée de la montée et de la descente en millisecondes.

Des valeurs trop élevées pour LiftHeight ou LiftRoll peuvent produire un rendu irréaliste ou provoquer des collisions avec certains véhicules.

La position du prop sous le véhicule se règle dans Config.JackOffsets.

Config.JackOffsets = {
    left  = vec3(-0.72, 0.0, -0.55),
    right = vec3( 0.72, 0.0, -0.55)
}

Les coordonnées sont des offsets relatifs au véhicule.

• X négatif : côté gauche.
• X positif : côté droit.
• Y : déplacement vers l'avant ou l'arrière du véhicule.
• Z : hauteur du prop.

Si le cric apparaît trop loin, trop haut ou sous le sol sur votre parc automobile, ajustez ces valeurs progressivement.

Les animations utilisent ox_lib et l'animation mécanique mini@repair / fixing_a_ped.

Installation / retrait

Config.InstallDuration = 2200

Valeur en millisecondes utilisée pendant l'installation du cric et les séquences associées.

Démontage d'une roue

Config.WheelRemoveDuration = 3500

Remontage d'une roue

Config.WheelInstallDuration = 3500

Augmentez ces valeurs pour un RP plus lent ou diminuez-les pour rendre les interventions plus rapides.

Les quatre roues prises en charge sont définies dans Config.Wheels.

Config.Wheels = {
    { bone = 'wheel_lf', index = 0, tyreIndex = 0, side = 'left',  label = 'Roue avant gauche' },
    { bone = 'wheel_lr', index = 2, tyreIndex = 4, side = 'left',  label = 'Roue arrière gauche' },
    { bone = 'wheel_rf', index = 1, tyreIndex = 1, side = 'right', label = 'Roue avant droite' },
    { bone = 'wheel_rr', index = 3, tyreIndex = 5, side = 'right', label = 'Roue arrière droite' }
}

• bone : bone GTA de la roue.
• index : index utilisé pour masquer/remettre la roue.
• tyreIndex : index GTA associé au pneu.
• side : côté qui doit être levé pour autoriser l'action.
• label : texte affiché dans l'interaction.

Ne modifiez les index/bones que si vous savez que votre véhicule utilise une configuration particulière.

Après démontage, la roue est représentée physiquement au sol et peut être récupérée via ox_target.

Config.WheelPickupDistance = 2.0
Config.WheelGroundOffset = 0.45

• WheelPickupDistance : distance maximale pour afficher/utiliser « Prendre la roue ».
• WheelGroundOffset : correction verticale appliquée lors de la création de la roue au sol.

Si une roue flotte ou traverse le sol avec certains véhicules, ajustez légèrement WheelGroundOffset.

1. Approchez-vous d'un véhicule complètement arrêté.
2. Avec ox_target, choisissez Installer le cric.
3. Sélectionnez le côté gauche ou droit.
4. Attendez la fin du levage.
5. Ciblez une roue située du côté levé puis choisissez Démonter.
6. Ciblez la roue déposée au sol puis choisissez Prendre la roue.
7. Ciblez le véhicule et utilisez Remonter sur la roue correspondante.
8. Lorsque toutes les roues sont remontées, choisissez Redescendre le véhicule.
9. Le cric est automatiquement supprimé à la fin de la descente.

Le joueur doit être hors du véhicule et celui-ci doit être complètement arrêté pour installer le cric.

Plusieurs protections sont intégrées directement au script.

• Impossible d'installer deux crics sur le même véhicule.
• Le véhicule doit être complètement arrêté.
• Le joueur doit sortir du véhicule avant l'installation.
• Une roue ne peut être démontée que du côté actuellement levé.
• Une roue déjà démontée ne peut pas être démontée une seconde fois.
• Le véhicule ne peut pas être redescendu tant qu'une roue est démontée.
• Le script tente d'obtenir le contrôle réseau du véhicule avant les modifications.
• Le cric est nettoyé automatiquement après la descente.

Dans la version 1.0.0, NC Vehicle Jack utilise directement les notifications de ox_lib.

lib.notify({
    title = 'NC Vehicle Jack',
    description = description,
    type = type or 'inform'
})

Il n'existe actuellement aucun paramètre de notification dans shared/config.lua. Le script n'a pas besoin d'okokNotify.

Une future migration vers le système de notifications NightCode pourra remplacer cette fonction sans modifier le fonctionnement du cric.

NC Vehicle Jack est standalone pour le framework.

• FiveM : compatible
• ESX : compatible, mais non requis
• QBCore : compatible, mais non requis
• Qbox : compatible en tant que ressource standalone
• ox_lib : obligatoire
• ox_target : obligatoire
• SQL : aucun

Le script travaille directement avec les entités GTA et ne nécessite ni métier, ni inventaire, ni table SQL.

« Le modèle de cric configuré est indisponible »

Vérifiez Config.JackProp dans shared/config.lua. Le modèle doit être valide sur le game build utilisé.

L'option Installer le cric n'apparaît pas

Vérifiez que ox_target est démarré avant la ressource et contrôlez Config.TargetDistance.

Le script ne trouve pas le véhicule après le choix du côté

Augmentez légèrement Config.InteractDistance.

Le cric est mal positionné

Ajustez Config.JackOffsets.left et Config.JackOffsets.right.

Le véhicule est trop ou pas assez incliné

Réglez Config.LiftRoll. Pour la hauteur, utilisez Config.LiftHeight.

Impossible de redescendre le véhicule

Vérifiez qu'aucune roue n'est encore démontée. Le script bloque volontairement la descente dans ce cas.

La roue est trop haute ou trop basse au sol

Ajustez Config.WheelGroundOffset.

Version 1.0.0

• Première version publique.
• Installation du cric via ox_target.
• Levage gauche/droite.
• Animations d'installation, démontage et remontage.
• Démontage physique des roues.
• Roue au sol et récupération.
• Remontage des roues.
• Protection contre la descente avec une roue démontée.
• Retrait automatique du cric.
• Configuration utilisateur dans shared/config.lua.

Si un problème persiste après avoir consulté le dépannage, ouvrez un ticket depuis votre espace client NightCode.

Informations utiles

• Version : NC Vehicle Jack FREE 1.0.0
• Version de ox_lib et ox_target
• Erreur complète de la console F8 ou FXServer
• Étapes permettant de reproduire le problème
• Partie concernée de shared/config.lua

Ne transmettez jamais de mot de passe, token ou accès serveur dans un canal public.