Skip to content

Configuration

Configuration

Toutes les options se trouvent dans shared/config/general.lua.

Stockage

shared/config/general.lua
Config.Storage = 'json'   -- 'json' écrit data/zones.json | 'db' utilise oxmysql

Voir Installation pour la table de base de données créée automatiquement.

Limites anti-exploit

Le serveur valide chaque sauvegarde par rapport à ces plafonds et rejette ou ajuste tout ce qui les dépasse. Réduisez-les pour des serveurs plus stricts.

shared/config/general.lua
Config.Limits = {
    maxZones     = 100,   -- total des zones sur le serveur
    maxPoints    = 64,    -- points par zone
    maxJobs      = 40,    -- métiers par zone
    maxWeapons   = 250,   -- entrées dans les listes d'armes autorisées/bloquées
    maxLabelLen  = 64,    -- nombre max de caractères pour le nom d'une zone
    saveCooldown = 1000,  -- ms entre chaque sauvegarde par joueur
}

Intervalle de vérification

La fréquence (en ms) à laquelle le client réévalue dans quelles zones le joueur se trouve.

shared/config/general.lua
Config.CheckInterval = 300

HUD en zone

Le badge en verre qui apparaît lorsque l'on se trouve à l'intérieur d'une zone. Son affichage est déterminé par zone via la règle showHud — ceci contrôle uniquement son emplacement et son titre.

shared/config/general.lua
Config.Hud = {
    -- l'un des 9 points d'ancrage :
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = utilise le nom propre de la zone
}

Marqueur au sol

Affiché lorsqu'une zone avec groundMarker = true est active.

shared/config/general.lua
Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

Effets d'entrée / sortie

Des finitions globales superposées aux règles par zone — un flash coloré à l'écran et un son frontend lors de l'entrée et de la sortie.

shared/config/general.lua
Config.Effects = {
    enabled    = true,
    flash      = true,                 -- flash coloré à l'écran via la NUI
    sound      = true,                 -- bip frontend à l'entrée / sortie
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

Notifications

shared/config/general.lua
Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'
  • auto — utilise les notifications du framework détecté.
  • ox — force l'utilisation des notifications ox_lib.
  • framework — utilise le système propre au framework.
  • custom — appelle votre propre hook dans client/editable.lua.

Inventaire (source de la liste d'armes)

Le sélecteur d'armes récupère la liste des armes ainsi que leurs vraies icônes directement depuis votre inventaire, afin que les joueurs voient exactement les images qu'ils ont dans leur sac.

shared/config/general.lua
Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- remplace le nom de la ressource si elle a été renommée
Config.InventoryImagePath = nil    -- remplace le chemin de base des images, ex: 'nui://my_inv/html/images/'

auto détecte ox_inventory, qb-inventory, esx_inventory, tgiann-inventory ou codem-inventory. WEAPON_UNARMED est toujours sélectonnable.

Règles par défaut

Config.DefaultRules correspond à l'ensemble des règles appliquées à chaque nouvelle zone créée. Voir Règles de zone pour savoir ce que fait chaque clé.