Weapon Editor
Configuration
Every option of config.lua and config_server.lua.
config.lua is plain text and sent to clients: never put secrets in it. Server-only values go in config_server.lua.
#General
| Option | Default | Description |
|---|---|---|
Config.Locale | 'it' | 'it' or 'en' |
Config.Framework | 'auto' | 'auto', 'esx', 'qbcore', 'qbox', 'standalone' |
Config.Command | 'weaponeditor' | Command that opens the editor; <command>_close is the emergency exit |
Config.Keybind | false | A key such as 'F10', or false for none |
Config.Debug | false | Extra logging |
#Permissions
Config.Permissions = {
acePrefix = 'ghiaccio_weaponeditor',
-- framework group -> level
groups = {
-- admin = 'admin', god = 'admin',
},
-- job -> { minGrade, level }. Jobs can give at most 'edit' (LIVE fields only), never 'hot' or 'admin'.
jobs = {
-- armaiolo = { minGrade = 3, level = 'edit' },
},
}Config.AllowedLicenses (v1) is deprecated: prefer add_ace identifier.license:... ghiaccio_weaponeditor.admin allow.
#Reference data
| Option | Default | Description |
|---|---|---|
Config.Reference | { owner = false, vanilla = true } | vanilla = GTA V vanilla metas. Leave owner = false (that pack is not part of the sold version) |
Config.ExtraMetaFiles | {} | List weapon meta files by hand when the server cannot list folders (io.popen unavailable) |
Config.ExtraWeapons | {} | Extra weapons missing from the data: { name = 'WEAPON_XXX', label = 'Name', category = 'pistol' } (LIVE fields only) |
Weapon resources running on the server (data_file WEAPONINFO_FILE[_PATCH]) are scanned at start and with /gwe_rescan, and win over vanilla data.
#Hot reload and patch
| Option | Default | Description |
|---|---|---|
Config.HotReload | false | Experimental, does not work on build 3258. Keep off |
Config.HotDebounceMs | 3000 | Delay before the patch resource is restarted (only with HotReload) |
Config.PatchResource | 'ghiaccio_weaponeditor_patch' | Name of the patch resource |
Config.PatchFile | 'weapons_gwe.meta' | Generated weapons meta |
Config.PatchComponentsFile | 'weaponcomponents_gwe.meta' | Generated components meta |
#Storage
| Option | Default | Description |
|---|---|---|
Config.Storage | 'json' | 'json' (files in data/) or 'oxmysql' (table gwe_kv, created automatically) |
Config.Backups | 20 | Rotating backups of overrides.json |
Config.HistoryMax | 500 | Snapshots kept in the history |
#Limits and rate limit
Config.Limits = {
maxImportBytes = 262144, -- 256 KB
maxPresetName = 48,
maxBatchWeapons = 64,
maxCompare = 4,
maxPresets = 100, -- total saved presets
maxPresetsPerAuthor = 20, -- admins have no per-author cap
}
Config.RateLimit = { burst = 12, perSecond = 4 } -- token bucket per player
Config.KillHealth = 120 -- UI reference for "shots to kill"#Logging and webhook
| Option | Default | Description |
|---|---|---|
Config.LogRejections | true | Also log rejected requests (validation, permissions, rate limit) |
Config.Webhook | '' | Deprecated here: it is visible to every client. Use ServerConfig.Webhook or the convar below |
set gwe_webhook "https://discord.com/api/webhooks/..."Audit log: data/logs/audit_YYYY-MM.log. Rejections go to data/logs/rejects_YYYY-MM.log with a per-player cap and never to the webhook. No automatic bans.
#Version check
Config.VersionCheck = { enabled = false, url = '' } is a stub: it makes no request until you enable it.
#Reference: where data is stored
Everything lives in data/ (overrides.json, history/, presets/, backups/, logs/) or in oxmysql (gwe_kv). The server is the single source of truth.