Skip to content

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.

  • 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.

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.

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-appearance
ensure your-multicharacter
ensure your-clothing-shop
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 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.

  1. Installation: copy the resource, replace an existing appearance script, start it.
  2. Configuration: server settings, languages, peds.json and tattoos.json.
  3. Integration: resource name, start order and what to check for other scripts.
  4. Examples and troubleshooting: ready-made edits and fixes for common problems.

See also the list of all scripts.