Configuration

Open config.lua and set at minimum:

Config.Framework = "auto"   -- or: "esx", "qbcore", "qbox", "standalone"
Config.Language  = "en"     -- en, es, fr, it, pt-br

---

Configuration

All options live in config.lua. Below is a full breakdown.

General

Config.Framework   = "auto"       -- Framework detection: auto | esx | qbcore | qbox | standalone
Config.Language    = "en"         -- UI language
Config.Prefix      = "char"       -- ESX only: identifier prefix (char1:<license>, char2:<license>, ...)
Config.DeleteCharacter = true     -- Allow players to delete their own characters
Config.BaseSlots   = 4            -- Base number of character slots per player
Config.DefaultSpawn = vector4(x, y, z, heading)  -- Fallback spawn if no other spawn is set

Relog Screenshots

Config.Upload.method     = "discord"      -- "discord" or "fivemanage"
Config.Upload.upload_url = "WEBHOOK_URL"  -- Discord webhook URL or FiveManage API key

Relog Command

Config.Relog = {
    enable      = true,
    commandName = "relog",    -- Command players use to relog (/relog)
    waitTime    = 10000,      -- Cooldown in milliseconds before relog is allowed
    instant     = false       -- true = no wait time enforced
}

Spawn Selector

Config.SpawnSelector = {
    enable = true,
    show = {
        always      = true,   -- Show every time a character is loaded
        onlyNewChar = true    -- Show only when creating a new character (if always = false)
    }
}

Spawn Points

Edit Config.SpawnPoints to add or remove spawn locations:

Config.SpawnPoints = {
    {
        label  = "Last Location",       -- Display name in UI
        coords = nil,                   -- nil = use character's last saved location
        image  = "https://...",         -- Preview image URL
    },
    {
        label  = "City Center",
        coords = vector4(x, y, z, h),
        image  = "https://...",
    },
}

Starter Items

Config.StarterItems = {
    enable = true,
    items  = {
        { name = "burger",      quantity = 1 },
        { name = "water_bottle", quantity = 1 },
    }
}

Admin Panel

Config.AdminPanel = {
    command    = "charpanel",           -- In-game command to open the panel
    permission = {                      -- Which groups can access the panel
        admin  = true,
        mod    = true,
        helper = true,
    }
}

QB Apartments

Config.UseQbAppartments = false   -- true = use QB/QBox apartment system for spawn

Character Showcase Positions

Config.PosPeds defines where each character slot is displayed on the character selection screen. See config_presets.lua for ready-made presets:

Config.PosPeds = {
    Presets.PosPeds.preset_lastPosition,   -- Character appears at their last location
    Presets.PosPeds.preset_fixedPos_1,     -- Fixed position at scene 1
    Presets.PosPeds.preset_fixedPos_2,
    Presets.PosPeds.preset_fixedPos_3,
}