General Settings

Character slots, UI options, skin script integration, and social media configuration.

Core Settings

Option	Default	Description
Config.Slots	3	Default character slots per player
Config.UseSpawnSelector	false	Show the built-in spawn selector screen (details)
Config.CustomSpawnSelector	false	Hand off to your own spawn selector resource (details)
Config.UseQBHouses	false	Use qb-apartments for spawns
Config.DefaultSpawn	vector4(-269, -955, 31, 205)	Default spawn coordinates
Config.YoutubeApiKey	API key	YouTube API key for music player
Config.SlotButton	true	Show the buy slot button
Config.DeleteButton	true	Show the delete character button
Config.DarkMode	false	Default to dark mode
Config.Debug	true	Enable debug logging
Config.LoadingTime	5000	How long (ms) the loading screen is shown before character select opens
Config.LoadingLogo	""	Image URL shown inside the loading spinner (your server logo). Empty = default icon

Default Character Settings

Defaults applied to characters that haven't customized their select screen yet:

lua

Config.DefaultSettings = {
    camera = 0,     -- Camera animation id (0 = Idle, 1 = Slide In, 2 = Slide In Left, 3 = Slide In Right)
    background = 0, -- Background id (see Config.Backgrounds)
    pose = 0,       -- Pose id (see Config.Poses)
}

Social Media Links

lua

Config.Socials = {
    youtube = "https://www.youtube.com/",
    website = "https://your-website.com/",
    discord = "https://discord.gg/",
}

Skin Script Configuration

Configure which skin/appearance menu opens after character creation:

lua

Config.SkinMenus = {
    skinchanger = "skinchanger",
    illeniumappearance = "illenium-appearance",
    fivemappearance = "fivem-appearance",
    qbclothing = "qb-clothing",
    blappearance = "bl_appearance",
}

Starter Items

Items given to newly created characters:

lua

Config.StarterItems = {
    phone = 1,
    id_card = 1,
}

Backgrounds, Poses & Filters

Backgrounds

lua

Config.Backgrounds = {
    { name = "Beach", coords = vector4(...), ... },
    { name = "Forest", coords = vector4(...), ... },
    { name = "City", coords = vector4(...), ... },
}

Poses

lua

Config.Poses = {
    { name = "Normal", dict = "anim_dict", anim = "anim_name" },
    { name = "Smoke", dict = "anim_dict", anim = "anim_name", prop = "prop_name", ... },
    { name = "Dance", dict = "anim_dict", anim = "anim_name" },
}

Camera Filters

12 built-in filters using GTA animpostfx effects, each with a preview image.