Character Creation

Included in the utility library is a selections of functions which can be used for creating character creation scripts, clothing stores, multi characters etc.

These functions are available client side only.

Functions

utils.character_creation.get_clothing_and_prop_values = get_clothing_and_prop_values
utils.character_creation.set_ped_appearance = set_ped_appearance
utils.character_creation.update_ped_data = update_ped_data
utils.character_creation.change_player_ped = change_player_ped
utils.character_creation.rotate_ped = rotate_ped
utils.character_creation.load_character_model = load_character_model

get_clothing_and_prop_values

The following is used to retrieve the max values for clothing and props based on the players current ped model.

This is handled through the included shared data file default_ped_styles.

local sex = 'male' -- or 'female'
local values = utils.character_creation.get_clothing_and_prop_values(sex)

if values then
    utils.tables.print_table(values)
end

set_ped_appearance

The following can be used to set the peds appearance to the clothing values stored in the utils shared styles.

This one functions handles everything from clothing to tattoos.

utils.character_creation.set_ped_appearance(PlayerPedId(), utils.shared.style.male)

update_ped_data

The following can be used to update specific ped appearence data.

utils.character_creation.update_ped_data('male', 'genetics', 'heritage', {mother = 5, father = 10})

change_player_ped

The following can be used to change the players ped between the two mp freemode peds.

utils.character_creation.change_player_ped('male')

rotate_ped

The following can be used to rotate the player ped by 45 degrees in either direction, a full 180, or reset back to original.

This is useful for camera controls whilst creating characters

utils.character_creation.rotate_ped('rotate_ped_right')  -- Rotates the ped 45 degrees to the right
utils.character_creation.rotate_ped('rotate_ped_left')   -- Rotates the ped 45 degrees to the left
utils.character_creation.rotate_ped('rotate_ped_180')    -- Rotates the ped 180 degrees
utils.character_creation.rotate_ped('rotate_ped_reset')  -- Resets the ped to its original heading

load_character_model

The following can be used to load in the character model with the appearence settings within the shared data section.

utils.character_creation.load_character_model(data)