Configuration

Tout se règle dans config.lua, qui reste ouvert et modifiable. Les joueurs choisissent eux-mêmes leur style de carte et leur mode jour / nuit en jeu ; les clés ci-dessous fixent ce qui est proposé et les valeurs par défaut.

Général

Clé	Défaut	Description
`Config.Locale`	`'en'`	Langue du panneau, un nom de fichier de `locales/`. `en` et `fr` sont fournis.
`Config.Debug`	`false`	Affiche des diagnostics dans la console F8.
`Config.ServerName`	`''`	Ligne sous le nom du quartier, en haut à gauche. Vide = masquée.
`Config.ScanInterval`	`10000`	Fréquence de mise à jour de la liste des lieux, en ms.
`Config.ShowUnnamed`	`false`	Liste aussi les blips sans nom, sous le nom de leur catégorie.
`Config.Colors`	`accent '255 255 255'`, `surface '15 15 18'`	Couleurs du panneau tant que le thème hz_lib n'est pas chargé (`'r g b'`).

Une autre langue : copiez locales/en.lua dans un nouveau fichier (par exemple locales/de.lua), traduisez les textes et mettez Config.Locale = 'de'. Les lignes manquantes reprennent l'anglais.

Zoom et GPS

Clé	Défaut	Description
`Config.ZoomOut`	`1.5`	Jusqu'où la carte du menu pause dézoome. Le jeu s'arrête à `2.73` ; plus bas, on va plus loin (`1.0` montre tout l'État). `false` garde la limite du jeu.
`Config.Gps.Enabled`	`true`	`false` garde le tracé et le repère violets du jeu.
`Config.Gps.route`	`'246 118 168'`	Couleur du tracé (`'r g b'`).
`Config.Gps.light`	`'252 160 196'`	Teinte claire du repère.
`Config.Gps.dark`	`'123 59 84'`	Teinte foncée du repère.

Carte de nuit

Clé	Défaut	Description
`Config.Night.Enabled`	`true`	`false` garde la carte de jour en permanence. Le choix Jour / nuit disparaît, et `stream/night` peut être supprimé.
`Config.Night.From`	`20`	Heure du jeu où la carte de nuit commence (0 à 23).
`Config.Night.To`	`6`	Heure où elle s'arrête.
`Config.Night.Default`	`'auto'`	Ce qu'ont les joueurs avant de choisir : `'auto'` (les heures ci-dessus), `'day'` ou `'night'`.

Styles de carte

Config.Themes = {
    Default = 'atlas',
    Choices = { 'atlas', 'satellite', 'native' },
}

Clé	Description
`Default`	Style des joueurs qui n'en ont jamais choisi.
`Choices`	Styles proposés en bas du panneau des lieux. Un seul choix masque le sélecteur.

Sans 'satellite', vous pouvez supprimer stream/satellite ; sans 'native', le dossier stream/native. Plus de détails dans Styles de carte et carte de nuit.

Catégories

Le panneau des lieux range les blips par catégories, dans cet ordre :

Config.Categories = {
    { id = 'services', sprites = {}, match = { 'police_station', 'hospital', 'fire_station' } },
    { id = 'jobs', sprites = { 477, 513 }, match = { 'garbage', 'taxi', 'tow_truck' } },
    { id = 'shops', ... },
    { id = 'vehicles', ... },
    { id = 'leisure', ... },
}

Champ	Description
`id`	Clé de la catégorie. Son titre vient de la langue (`services` s'affiche Services publics).
`sprites`	Numéros d'icônes de blip qui vont dans cette catégorie.
`match`	Morceaux du nom d'icône du jeu (liste complète dans `web/data/blips.json`).
`label`	Titre optionnel qui remplace la traduction.

Les blips qui ne correspondent à rien vont dans Autres.

Pour déplacer un blip par son nom exact, utilisez Config.Overrides :

Config.Overrides = {
    ['Mechanic'] = 'vehicles',
}

Barre de touches

Config.Keys règle les touches affichées en bas de la carte plein écran, avec leurs libellés clavier et manette. controls donne les contrôles du jeu derrière chaque action, back la même action en sens inverse. Une action sans controls est une action que la carte fait déjà d'elle-même.

Action	Clavier	Manette
Changer d'onglet	`Q` / `E`	`LB` / `RB`
Poser un repère	`ENTRÉE`	`A`
Parcourir les lieux	`▲` `▼`	`▲` `▼`
Passer d'un point à l'autre d'un lieu	`◀` `▶`	`◀` `▶`
Zoom	`PGUP` + `PGDN`	`LT` + `RT`
Masquer / afficher un type	`T`	`X`
Quitter	`ÉCHAP`	`B`

Cayo Perico

Cayo Perico ne se règle pas dans config.lua. Pour masquer l'île, ouvrez fxmanifest.lua et commentez sa ligne :

    -- 'client/cayo.lua', -- Cayo Perico on the map. Comment this line out to hide the island.