KS-Target

Installation

1. Décompressez l’archive livrée dans votre dossier resources/, sous le nom ks-target.
2. Importez le fichier install.sql fourni dans votre base de données.
3. Ajoutez ensure ks-target dans votre server.cfg, après oxmysql et qb-core.
4. Redémarrez votre serveur.

Configuration

Config.MaxDistance = 2.5      -- portée de détection, en mètres
Config.CursorFrequency = 5    -- fréquence de rafraîchissement du raycast (Hz)
Config.CompatMode = true      -- active la couche de compatibilité qb-target / ox_target

Réduisez CursorFrequency sur un serveur très chargé pour économiser des ressources ; l’effet sur la précision de visée reste négligeable en dessous de 10 Hz.

Déclarer une nouvelle interaction

Une zone ciblable se déclare avec la même syntaxe qu’ox_target, pour une migration immédiate :

exports['ks-target']:AddBoxZone('atm_1', vector3(-1040.9, -2745.6, 20.2), 1.0, 1.0, {
  options = {
    { label = "Retirer de l'argent", icon = "fa-solid fa-money-bill", action = function() end },
  },
})

Les zones existantes déclarées via qb-target ou ox_target sont automatiquement reprises si Config.CompatMode est actif — aucune migration n’est nécessaire pour vos scripts déjà en place.

Problèmes fréquents

Mes anciens scripts qb-target n’affichent plus les options. Vérifiez que Config.CompatMode est bien à true et que ks-target démarre après votre ancien script cible dans server.cfg — la couche de compatibilité intercepte ses exports au démarrage.

La visée à la souris ne se déclenche pas. Le curseur libre nécessite SetMouseCursorActiveThisFrame actif — vérifiez qu’aucun autre script ne capture le focus NUI en boucle (menu ouvert en permanence, par exemple).