Configuration — ns-combatlog
All options live in config.lua (stays editable under escrow). Locales: locales/en.lua, locales/tr.lua.
| Option | Default | Description |
|---|---|---|
Config.Framework | 'auto' | 'auto', 'qbox', 'qbcore', 'esx', 'standalone' |
Config.Locale | 'en' | Active language; missing keys fall back to Config.FallbackLocale |
Config.Debug | false | Debug console output (category combatlog) |
Config.UseOxLib | true | ox_lib notifications when it is started |
Config.Combatlog.duration | 180 | Seconds a "?" stays |
Config.Combatlog.maxEntries | 50 | Oldest marker is removed above this count |
Config.Combatlog.onlyLoadedCharacters | true | Ignore players who quit from the character / spawn screen |
Config.Combatlog.reasonMaxLength | 160 | Characters of the quit reason kept |
Config.Combatlog.timeFormat | '%H:%M:%S' | os.date format of the quit time (server clock) |
Config.Fields.* | see file | serverId, playerName, characterName, citizenId, discord, dropType, reason, time on; license, steam off. A field set to false is never sent to clients |
Config.Marker.type | 32 | GTA marker type (32 = question mark) |
Config.Marker.scale / color | 0.6 / amber | Size and RGBA colour |
Config.Marker.zOffset | 0.0 | Metres above the last position (body centre) |
Config.Marker.bob / rotate | true / true | Float up and down / spin |
Config.Marker.drawDistance | 25.0 | Metres within which the "?" is drawn |
Config.Marker.infoDistance | 2.0 | Metres within which the info card opens |
Config.Copy.key / label | 38 / 'E' | Copy key (control index) and the key name on the card |
Config.Copy.cooldown | 1000 | Milliseconds between two copies |
Config.Commands.test / clear | 'combatlogtest' / 'combatlogclear' | Admin command names (empty string disables one) |
Config.Security.* | see file | RPC flood bucket and rate limits |
Config.Admin.ace | 'ns-combatlog.admin' | ACE for admin commands; useFrameworkAdmin also accepts framework admins |
Config.Notifications.* | 'auto' | Provider, duration, position, custom function |
Config.Standalone.isAdmin | false | Admin check when no framework is used |
Admin
/combatlogtest— a test "?" at your own position, filled with your own details (marked "test" on the card)./combatlogclear— removes every "?" (also from the server console).
Hooks for other resources
AddEventHandler('ns-combatlog:hook:securityFlag', function(src, reason, detail) end) — every suspicious request.