MAIN SETTINGS#

Debug Mode#

config/main.lua
Copy
Config.Debug = false

Enable debug mode to see additional console output for troubleshooting.

Face Settings#

Configure the limits for face customization sliders:

config/main.lua
Copy
Config.FaceSettings = {
    face = { min = 0, max = 45 },   -- Face 1 (Father)
    face2 = { min = 0, max = 45 },  -- Face 2 (Mother)
    race = { min = 0, max = 45 }    -- Race/ethnicity
}

Clothes Toggle Functions#

Configure what happens when players toggle clothes on/off in the menu:

config/main.lua
Copy
Config.ChangeClothesState = {
    Cap = function(ped)
        ClearPedProp(ped, 0)  -- Remove hat
    end,
    Glasses = function(ped)
        ClearPedProp(ped, 1)  -- Remove glasses
    end,
    Closet = function(ped)
        -- Remove shirt/jacket
        SetPedComponentVariation(ped, 11, 15, 0, 2)
        SetPedComponentVariation(ped, 8, 15, 0, 2)
        SetPedComponentVariation(ped, 3, 15, 0, 2)
    end,
    Shoe = function(ped)
        SetPedComponentVariation(ped, 6, 34, 0, 2)  -- Remove shoes
    end
}

These functions are called when players click the clothes on/off toggles in the UI.

Clothes Download Command#

Enable or disable the clothes preview download command:

config/main.lua
Copy
Config.ClothesDownload = {
    enable = true,
    command = 'downloadclothes'
}

Routing Bucket#

Isolate players during character creation to prevent interaction with the world:

config/main.lua
Copy
Config.Bucket = {
    Enable_on_First_Character = true,
    BucketEnable_Command = 'onex-creation:server:ChangeRoutingBucket',
    BucketDisable_Command = 'onex-creation:server:ResetRoutingBucket'
}

Camera Offsets#

Configure camera positions for different viewing angles:

config/main.lua
Copy
Config.CameraOffsets = {
    [1] = { x = 0.0, y = 0.9, z = 0.65 },   -- Face view
    [2] = { x = 0.0, y = 1.8, z = 0.2 },    -- Full body
    [3] = { x = 0.0, y = 1.2, z = -0.5 },   -- Lower body
    [4] = { x = 0.5, y = 0.8, z = 0.3 },    -- Side view
    [5] = { x = -0.5, y = 0.8, z = 0.3 }    -- Other side
}

Utility Commands#

Enable or disable utility commands and set their names:

config/main.lua
Copy
Config.UitilityCommands = {
    admin_creation = {
        active = true,
        command = 'acreation'
    },
    Refreshskin = {
        active = true,
        command = 'refreshskin'
    },
    Propfix = {
        active = true,
        command = 'propfix'
    }
}

Image Scale Tree#

Configure preview image scaling and positioning for each category:

config/main.lua
Copy
Config.ImageScaleTree = {
    face_skin = { scale = 1.0, offsetX = 0, offsetY = 0 },
    mask = { scale = 1.2, offsetX = 0, offsetY = -10 },
    hair = { scale = 1.1, offsetX = 0, offsetY = -5 },
    torso = { scale = 0.8, offsetX = 0, offsetY = 20 },
    pants = { scale = 0.7, offsetX = 0, offsetY = 40 },
    shoes = { scale = 0.9, offsetX = 0, offsetY = 50 },
    -- ... more categories
}

Auto Camera Change#

Automatically switch camera angles when changing categories:

config/main.lua
Copy
Config.AutoCameraChange = {
    Enable = true,
    CategoryCameras = {
        face_skin = 1,
        mask = 1,
        hair = 1,
        torso = 2,
        pants = 3,
        shoes = 3,
        hat = 1,
        glass = 1,
        -- ... more mappings
    }
}

Legacy Face Data#

Preserve old face data format for existing characters:

config/main.lua
Copy
Config.Stay_on_Old_Face_for_old_characters = true

Next Steps#