Skip to content

Configuration

Konfiguration

Alle Optionen befinden sich in shared/config/general.lua.

Speicher

shared/config/general.lua
Config.Storage = 'json'   -- 'json' schreibt data/zones.json | 'db' nutzt oxmysql

Siehe Installation für die automatisch erstellte Datenbanktabelle.

Anti-Exploit-Limits

Der Server validiert jedes Speichern anhand dieser Obergrenzen und lehnt alles ab, was darüber liegt, oder begrenzt es entsprechend. Für strengere Server können diese Werte gesenkt werden.

shared/config/general.lua
Config.Limits = {
    maxZones     = 100,   -- Zonen insgesamt auf dem Server
    maxPoints    = 64,    -- Punkte pro Zone
    maxJobs      = 40,    -- Jobs pro Zone
    maxWeapons   = 250,   -- Einträge in Erlaubnis-/Blockierungslisten für Waffen
    maxLabelLen  = 64,    -- Max. Zeichen in einem Zonennamen
    saveCooldown = 1000,  -- ms zwischen Speichervorgängen pro Spieler
}

Prüfintervall

Gibt an, wie oft (in ms) der Client neu bewertet, in welchen Zonen sich der Spieler aktuell befindet.

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

HUD in der Zone

Das Glas-Badge, das angezeigt wird, während man sich in einer Zone befindet. Ob es überhaupt angezeigt wird, wird pro Zone durch die showHud-Regel entschieden — dies steuert lediglich seine Position und seinen Titel.

shared/config/general.lua
Config.Hud = {
    -- Einer von 9 Ankerpunkten:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = verwende den Namen der Zone
}

Bodenmarkierung

Wird gezeichnet, solange eine Zone mit groundMarker = true aktiv ist.

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

Betreten- / Verlassen-Effekte

Globaler Feinschliff, der über die regelspezifischen Einstellungen gelegt wird — ein farbiger Bildschirmblitz und ein Frontend-Sound beim Betreten und Verlassen.

shared/config/general.lua
Config.Effects = {
    enabled    = true,
    flash      = true,                 -- Farbiger Bildschirmblitz über das NUI
    sound      = true,                 -- Frontend-Blip beim Betreten / Verlassen
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

Benachrichtigungen

shared/config/general.lua
Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'
  • auto — Verwendet die Benachrichtigung des erkannten Frameworks.
  • ox — Erzwingt Benachrichtigungen über ox_lib.
  • framework — Verwendet das systemeigene Framework-System.
  • custom — Ruft deinen eigenen Hook in client/editable.lua auf.

Inventar (Quelle für Waffenliste)

Der Waffenauswahldialog zieht die Waffenliste inklusive der echten Icons direkt aus deinem Inventar, sodass Spieler genau die Bilder sehen, die sie in ihrer Tasche haben.

shared/config/general.lua
Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- Überschreibt den Ressourcennamen, falls dieser umbenannt wurde
Config.InventoryImagePath = nil    -- Überschreibt den Basis-Pfad für Bilder, z.B. 'nui://my_inv/html/images/'

auto erkennt ox_inventory, qb-inventory, esx_inventory, tgiann-inventory oder codem-inventory. WEAPON_UNARMED ist immer auswählbar.

Standardregeln

Config.DefaultRules ist der Regelsatz, der auf jede brandneue Zone angewendet wird. Siehe Zonenregeln für Details dazu, was die einzelnen Schlüssel bewirken.