# Koja Appearance

![Koja Appearance](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/appearance/banner.5c1ea46716.webp)

Koja Appearance is a full redesign of [illenium-appearance](https://github.com/iLLeniumStudios/illenium-appearance).
It replaces the whole UI with a new React menu and adds a clothing shop basket, shopkeepers, a studio, a wardrobe hub and an admin tool that photographs every clothing item — while the illenium-appearance core underneath stays the same.

It is a drop-in replacement: every upstream export, event, command, outfit, zone, tattoo and database table keeps working, so scripts written for illenium-appearance do not need any change.

This section covers version **1.0.0** of the resource.

## What you get

:::frame{caption="Every item gets a real thumbnail, captured in game."}
![Captured clothing thumbnails](https://pub-57d6558d0e204696b4cdeee5d172e561.r2.dev/appearance/thumbnails-carousel.a905055920.gif)
:::

| Area | What is in it |
| --- | --- |
| Editor | Icon rail (Ped, Inheritance, Face features, Appearance, Hair, Clothes, Props, Tattoos), image tile grid with price badges, category strip with a camera per category, scroll to zoom and drag to rotate |
| Toolbar | **Bones 3D** (clickable markers on the body), **Freeze**, **Hands up**, **Studio**, **Admin Panel** |
| Studio | UI theme, studio locations with an optional private routing bucket, poses, studio light, item view, backdrop, turntable, camera angles, time and weather, photo mode, before / after compare |
| Thumbnails | A real image for every clothing, prop, hair, beard and tattoo item, stored in the resource or on Fivemanage |
| Shops | Shopkeeper peds for clothing, barber, tattoo and surgeon shops, with ox_target / qb-target or a floor marker |
| Shop basket | Pay per item with cash or bank. The server prices the basket itself and never trusts the client |
| Wardrobe hub | Outfits, outfit codes, clothing rooms and boss managed outfits in one panel instead of the ox_lib menus |
| Clothing as items | Optional ox_inventory items with an image, plus exports for any other inventory |
| Capture panel | Admin tool: green screen shots of every item, ghost shots, auto mode, names and prices |
| Quality of life | Mask clipping fix, god mode and frozen hunger / thirst while the menu is open |
| Languages | 16 languages: ar, bg, cs, de, en, es-ES, fr, hu, id, it, nl, pl, pt-BR, ro-RO, zh-CN, zh-TW |

## Quick facts

- **Resource name:** keep the folder name `illenium-appearance` so every script calling `exports['illenium-appearance']` keeps working.
- **Frameworks:** ESX, QBCore, QBox and ox_core — the same bridges as illenium-appearance.
- **Requires:** `ox_lib` and `oxmysql`. `screenshot-basic` only for the Capture panel.
- **ESX:** replaces `esx_skin` and `skinchanger` (it `provide`s both) and converts old skins on start.
- **Database:** three `koja_appearance_*` tables, created on start. The upstream tables are unchanged.
- **UI:** shipped prebuilt in `web/dist`. You only need Node and pnpm to change it.

## Start here

:::steps

### Install it

[Installation](/new/appearance/installation) — dependencies, folder name, `server.cfg` order and admin access.

### Configure it

[Configuration](/new/appearance/configuration) — every option in `shared/koja_config.lua` and `shared/koja_shops.lua`.

### Learn what it does

[Features](/new/appearance/features) — the editor, studio, shops, basket and wardrobe hub.

### Make the thumbnails

[Capture panel](/new/appearance/capture-panel) — photograph every clothing item and tattoo, set names and prices.

### Use it from your own code

[Exports & Commands](/new/appearance/exports-and-commands) — the new exports, every command and the events you can trigger.

:::

## In this section

::::cards{cols="2"}
:::card{title="Installation" href="/new/appearance/installation" icon="download"}
Dependencies, folder name, start order and admin access.
:::
:::card{title="Configuration" href="/new/appearance/configuration" icon="settings"}
Every Config.Koja option, explained.
:::
:::card{title="Features" href="/new/appearance/features" icon="sparkles"}
Editor, studio, shops, basket, wardrobe hub and items.
:::
:::card{title="Capture panel" href="/new/appearance/capture-panel" icon="camera"}
Thumbnails for every clothing item and tattoo.
:::
:::card{title="Exports & Commands" href="/new/appearance/exports-and-commands" icon="terminal"}
New exports, commands and the upstream API.
:::
:::card{title="Database" href="/new/appearance/database" icon="database"}
The koja_appearance tables and the ESX skin backup.
:::
:::card{title="Troubleshooting" href="/new/appearance/troubleshooting" icon="bug"}
Fixes for the problems people actually hit.
:::
::::

## Credits

Based on [illenium-appearance](https://github.com/iLLeniumStudios/illenium-appearance) by iLLeniumStudios, built on [fivem-appearance](https://github.com/pedr0fontoura/fivem-appearance) by snakewiz and contributors.
Released under the MIT License; the original licence notice is kept in `LICENSE`.