fivem-appearance
A flexible player customization script for FiveM.
This resource was designed to manage all GTA V player/ped customization in only one place, with an opinionated way to handle the data.
Features
- Freemode Ped full customization (Head blend, Face features, Head overlays, Components and Props)
- Exports API to get and set every part of player/ped appearance
- Built-in customization feature.
Preview
Images
Download
Source Code
Documentation
All client exports can be found here.
If you prefer, you can disable all the customization interface and use just the API.
This resource is configurable through convars. Keep in mind that you will need to use setr to set these convars.
- fivem-appearance:customization: 1 or 0, default 1, toggle the built-in customization interface and customization exports.
-
fivem-appearance:locale: the name of one file inside
locales/, default en, choose the locale file for the customization interface.
config.cfg example:
setr fivem-appearance:customization 1
setr fivem-appearance:locale "en"
ensure fivem-appearance
Examples
To use with your “clothes store” script, you could use something like
-- Client
exports['fivem-appearance']:startPlayerCustomization(function (appearance)
if (appearance) then
TriggerServerEvent('saveCharacterCustomization', JSON.encode(appearance))
end
end)
Loading your character
RegisterNetEvent('loadCharacterAppearance')
AddEventHandler('loadCharacterAppearance', function (encodedAppearance)
local appearance = JSON.decode(encodedAppearance)
exports['fivem-appearance']:setPlayerAppearance(appearance)
end)
Todo
- Tattoos
Disclaimer
This is a development resource. In order for something to happen you will need to consume the exports.
Also, there are some features missing that i’m working on, like tattoos. If there is something that you would like to add, feel free to contribute to the project on Github.
It’s my first public release here, so consider it as a test.
UPDATES
- v1.1.0: Added customization config options, now you can choose wich options will be available inside customization.
.
