GhiaccioScripts

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

OptionDefaultDescription
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.KeybindfalseA key such as 'F10', or false for none
Config.DebugfalseExtra logging

#Permissions

lua
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

OptionDefaultDescription
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

OptionDefaultDescription
Config.HotReloadfalseExperimental, does not work on build 3258. Keep off
Config.HotDebounceMs3000Delay 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

OptionDefaultDescription
Config.Storage'json''json' (files in data/) or 'oxmysql' (table gwe_kv, created automatically)
Config.Backups20Rotating backups of overrides.json
Config.HistoryMax500Snapshots kept in the history

#Limits and rate limit

lua
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

OptionDefaultDescription
Config.LogRejectionstrueAlso log rejected requests (validation, permissions, rate limit)
Config.Webhook''Deprecated here: it is visible to every client. Use ServerConfig.Webhook or the convar below
cfg
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.