Koja Scripts

Appearance

Koja Appearance: a drop-in redesign of illenium-appearance with a new editor, studio, shopkeepers, shop basket, wardrobe hub and clothing thumbnail capture.

Koja Appearance

Koja Appearance

Koja Appearance is a full redesign of 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

Captured clothing thumbnails

Every item gets a real thumbnail, captured in game.
AreaWhat is in it
EditorIcon 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
ToolbarBones 3D (clickable markers on the body), Freeze, Hands up, Studio, Admin Panel
StudioUI 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
ThumbnailsA real image for every clothing, prop, hair, beard and tattoo item, stored in the resource or on Fivemanage
ShopsShopkeeper peds for clothing, barber, tattoo and surgeon shops, with ox_target / qb-target or a floor marker
Shop basketPay per item with cash or bank. The server prices the basket itself and never trusts the client
Wardrobe hubOutfits, outfit codes, clothing rooms and boss managed outfits in one panel instead of the ox_lib menus
Clothing as itemsOptional ox_inventory items with an image, plus exports for any other inventory
Capture panelAdmin tool: green screen shots of every item, ghost shots, auto mode, names and prices
Quality of lifeMask clipping fix, god mode and frozen hunger / thirst while the menu is open
Languages16 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 provides 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

  1. Install it

    Installation — dependencies, folder name, server.cfg order and admin access.

  2. Configure it

    Configuration — every option in shared/koja_config.lua and shared/koja_shops.lua.

  3. Learn what it does

    Features — the editor, studio, shops, basket and wardrobe hub.

  4. Make the thumbnails

    Capture panel — photograph every clothing item and tattoo, set names and prices.

  5. Use it from your own code

    Exports & Commands — the new exports, every command and the events you can trigger.

In this section

Installation

Dependencies, folder name, start order and admin access.

Configuration

Every Config.Koja option, explained.

Features

Editor, studio, shops, basket, wardrobe hub and items.

Capture panel

Thumbnails for every clothing item and tattoo.

Exports & Commands

New exports, commands and the upstream API.

Database

The koja_appearance tables and the ESX skin backup.

Troubleshooting

Fixes for the problems people actually hit.

Credits

Based on illenium-appearance by iLLeniumStudios, built on fivem-appearance by snakewiz and contributors. Released under the MIT License; the original licence notice is kept in LICENSE.

Appearance · Koja Scripts