Configuration

Tout ce qu'un propriétaire de serveur est censé modifier se trouve dans config.lua, et le fichier est commenté section par section. Les permissions, la durée et les limites sont abordées sur Permissions & Duration ; le webhook possède sa propre page. Cette page couvre le reste.

Général

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… vide pour désactiver
Config.ClearCommand = 'statusclear'
Config.Debug        = false

Texte en jeu

Ce que les autres joueurs voient flotter sur le ped.

Option	Défaut	Utilité
`Config.Text.ViewDistance`	`6.0`	Rien n'est affiché au-delà de cette distance, en mètres.
`Config.Text.ScanInterval`	`800`	Fréquence (ms) à laquelle le client scanne les joueurs proches transportant des notes. Une valeur plus élevée est plus performante mais met plus de temps à apparaître.
`Config.Text.Size`	`0.34`	Échelle de base ; le script s'adapte également à la distance de la caméra.
`Config.Text.Font`	`4`	ID de police GTA — 0 chalet, 1 sign, 2 slab, 4 chalet comprime, 7 pricedown.
`Config.Text.Outline`	`true`	Contour sombre derrière le texte pour qu'il reste lisible sur n'importe quelle surface.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	Limites pour que le texte ne devienne jamais illisible ou comiquement grand.
`Config.Text.Alpha`	`225`	Opacité du texte, 0–255.
`Config.Text.ColorBySeverity`	`true`	Teinter le texte avec la couleur de gravité. `false` = toujours blanc.
`Config.Text.White`	`255, 255, 255`	Couleur utilisée lorsque la teinte de gravité est désactivée ou inconnue.
`Config.Text.OnlyWhileAiming`	`false`	Affiche uniquement lorsque l'observateur maintient la touche de visée.

Caméra

Le panneau s'ouvre sur une interface transparente et la caméra du jeu fait le travail.

Option	Défaut	Utilité
`Config.Camera.AutoFrame`	`true`	Mesure le ped de la tête aux pieds et le cadre automatiquement. Recommandé — fonctionne sur n'importe quel modèle de ped.
`Config.Camera.Fill`	`0.88`	Pourcentage de la hauteur de l'écran occupé par le corps lorsque `AutoFrame` est activé.
`Config.Camera.VerticalNudge`	`0.0`	Ajustement précis en mètres. Une valeur positive déplace le personnage vers le bas de l'écran.
`Config.Camera.Distance`	`3.35`	Distance par rapport au ped — utilisé uniquement lorsque `AutoFrame` est `false`.
`Config.Camera.Height`	`0.95`	Hauteur visuelle de la caméra — utilisé uniquement lorsque `AutoFrame` est `false`.
`Config.Camera.SideOffset`	`0.45`	Pousse le ped vers la gauche pour que le panneau ne le recouvre jamais. `0` le centre.
`Config.Camera.Fov`	`34.0`	Une valeur plus basse donne un effet d'objectif portrait avec moins de distorsion.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	Limites de zoom et pas d'incrémentation par pression de bouton.
`Config.Camera.RotateSensitivity`	`0.6`	Degrés de rotation du ped par pixel de glissement de souris.
`Config.Camera.FreezePlayer`	`true`	Geler le ped pendant que le panneau est ouvert.
`Config.Camera.HideRadar`	`true`	Masquer la minicarte pendant que le panneau est ouvert.
`Config.Camera.HotspotRefresh`	`30`	Fréquence (ms) à laquelle les positions des os sont envoyées à l'interface. Augmenter à 50–60 sur les serveurs très fréquentés.

ℹ

Lorsque AutoFrame est activé, les limites de zoom sont calculées à partir du cadrage mesuré plutôt qu'à partir de ZoomMin / ZoomMax, de sorte que les boutons réagissent toujours de manière logique quelle que soit la taille du ped.

Interface

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- n'importe quelle couleur CSS
    Watermark     = true,       -- filigrane "Status" dessiné à la main derrière le personnage
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

Types et gravités

Ce sont deux listes simples. L'interface s'adapte à tout ce que vous y mettez ; les libellés proviennent des fichiers de langue.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- libellé : type_injury
    { id = 'bandage', icon = 'plus'     },
    { id = 'note',    icon = 'message'  },
}

Config.Severities = {
    { id = 'minor',    color = { r = 143, g = 214, b = 171 } },
    { id = 'moderate', color = { r = 195, g = 201, b = 209 } },
    { id = 'severe',   color = { r = 255, g = 154, b = 157 } },
}

icon est un nom d'icône lucide rendu par l'interface. L'ajout d'une entrée nécessite une ligne correspondante type_<id> ou sev_<id> dans chaque fichier de langue.

Parties du corps

Seize régions sont incluses par défaut, chacune étant ancrée à un os de ped GTA.

config.lua

{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },

Champ	Signification
`bone`	L'index de l'os du ped sur lequel l'annotation est ancrée.
`offset`	Éloigne le texte en jeu flottant de l'os afin qu'il ne se retrouve pas à l'intérieur du modèle. Augmentez `z` si le texte traverse les vêtements. Cela ne déplace pas le marqueur cliquable.
`marker`	Optionnel. Déplace uniquement le marqueur cliquable dans le panneau. Si vous l'omettez, le marqueur se placera exactement sur l'os, ce qui convient dans presque tous les cas.

La suppression d'une entrée masque cette région partout. L'ajout d'une entrée nécessite un index d'os valide et une ligne correspondante bp_<id> dans chaque fichier de langue.

Avancé

config.lua

Config.Table = 'bupa_syncstatus'  -- créé automatiquement au premier démarrage

⚠

Les tables de correspondance situées au bas de config.lua (Config.BodyPartMap, Config.TypeMap, Config.SeverityMap) sont générées à partir des listes ci-dessus au démarrage. Ne les modifiez pas manuellement.

PreviousPermissions & Duration Next Discord Logging