Kivo Appearance
Kivo Appearance is a customization menu for FiveM. It handles GTA V player and ped customization in one place: ped model, inheritance, face features, hair and head overlays, clothes, props and tattoos.
This documentation covers the version declared in fxmanifest.lua, 1.3.0.
Features
Section titled “Features”- Ped model. A Model dropdown filled from
peds.json. You decide which models players can pick. - Inheritance. Face and skin are set from a Father and a Mother choice with a Mix value for each.
- Face features. Nose, eyebrows, cheeks, eyes and mouth, jaw, chin and neck.
- Appearance. Hair (style, color, highlight and an optional fade), blemishes, beard, eyebrows, ageing, make up, blush, complexion, sun damage, lipstick, moles and freckles, chest hair, body blemishes and eye color.
- Clothes. Drawable and texture for mask, hands, legs, bags and parachute, shoes, scarf and chains, shirt, body armor, decals and jackets.
- Props. Drawable and texture for hats and helmets, glasses, ear, watches and bracelets.
- Tattoos. One selector per body zone. Selecting an entry previews it on the ped. Apply keeps it and Delete removes it. The list comes from
tattoos.json. - Confirmation dialogs. Saving and exiting each ask the player to confirm with Yes or No.
- Languages. Seven languages are included and you can add more by copying a language file.
- Editable lists. Peds, tattoos and every piece of menu text are plain JSON files. No code editing is needed.
While the menu is open, the player stands still, cannot take damage and has the radar hidden. The camera moves in front of the character.
Requirements
Section titled “Requirements”| Item | Details |
|---|---|
| Game | GTA V (game 'gta5'), fx_version 'cerulean' |
| Other resources | None declared in fxmanifest.lua |
| Database | None. There is no SQL file to import. |
| Framework | Not required by this resource |
| Scripts in the resource | One client script and the menu page. There is no server script. |
Because the resource has no server script, it does not save anything to a database by itself. Saving and loading a character’s appearance is handled by the script that opens the menu.
Start order
Section titled “Start order”Kivo Appearance has no dependencies, so it can start at any point. Start it before the scripts that open the menu (multicharacter, identity creator, clothing shops, jobs), so it is already running when they need it.
ensure kivo-appearanceensure your-multicharacterensure your-clothing-shopLanguages included
Section titled “Languages included”| File | Language |
|---|---|
en.json |
English (default) |
fr.json |
French |
de.json |
German |
es-ES.json |
Spanish (Spain) |
pt-BR.json |
Portuguese (Brazil) |
cs.json |
Czech |
fa-IR.json |
Persian |
What you can customize
Section titled “What you can customize”| What | Where | Page |
|---|---|---|
| Menu language | fivem-appearance:locale setting in server.cfg |
Configuration |
| Automatic hair fade | fivem-appearance:automaticFade setting in server.cfg |
Configuration |
| Menu text | locales/*.json |
Configuration |
| Selectable ped models | peds.json |
Configuration |
| Selectable tattoos | tattoos.json |
Configuration |
There is no config.lua file.
- Installation: copy the resource, replace an existing appearance script, start it.
- Configuration: server settings, languages,
peds.jsonandtattoos.json. - Integration: resource name, start order and what to check for other scripts.
- Examples and troubleshooting: ready-made edits and fixes for common problems.
See also the list of all scripts.
