# nova\_creator

NOVA Framework character creator. Full appearance customization system with clothing, barber, and tattoo editing.

## Features

* **Parents** — Select mother and father for facial blending
* **Face Features** — 20 facial feature sliders (nose width, chin shape, etc.)
* **Head Overlays** — Blemishes, facial hair, eyebrows, aging, makeup, etc.
* **Hair & Eyes** — Hair style, color, highlights, eye color
* **Clothing** — Full component editing (tops, pants, shoes, hats, glasses, etc.)
* **Tattoos** — Apply tattoos to torso, arms, legs, head
* **Camera System** — Face, chest, legs, feet camera views

## Configuration

Edit `config.lua`:

```lua
CreatorConfig = {
    DefaultSpawn = vector4(-74.64, -818.89, 326.18, 0.0),

    CameraOffsets = {
        face = { offset = vector3(0.0, 0.6, 0.65), fov = 35.0 },
        chest = { offset = vector3(0.0, 1.2, 0.2), fov = 40.0 },
        legs = { offset = vector3(0.0, 1.5, -0.5), fov = 45.0 },
        feet = { offset = vector3(0.0, 1.0, -0.8), fov = 45.0 },
    },

    ClothingCategories = {
        { id = 'tops', label = 'Tops', component = 11 },
        { id = 'undershirt', label = 'Undershirt', component = 8 },
        { id = 'pants', label = 'Pants', component = 4 },
        { id = 'shoes', label = 'Shoes', component = 6 },
        -- More categories...
    },
}
```

### Key Configuration

| Option                | Type    | Description                                     |
| --------------------- | ------- | ----------------------------------------------- |
| `DefaultSpawn`        | vector4 | Spawn position during character creation        |
| `CameraOffsets`       | table   | Camera positions for each body section          |
| `Fathers` / `Mothers` | table   | Parent face presets                             |
| `FacialFeatures`      | table   | Face feature slider definitions                 |
| `HeadOverlays`        | table   | Overlay definitions (facial hair, makeup, etc.) |
| `ClothingCategories`  | table   | Clothing component mappings                     |
| `TattooItems`         | table   | Available tattoos by zone                       |
| `BeautyCategories`    | table   | Barber/beauty categories                        |

## How It Works

1. Called during character creation flow (from `nova_multicharacter` or `nova_multichar`)
2. Player model is set and camera enters creator mode
3. NUI opens with tabs for each customization category
4. Changes are applied in real-time on the player model
5. On confirm, appearance data is saved to the database via `nova_core`

## Dependencies

* **nova\_core** — Player data, skin saving
* **oxmysql** — Persistence

## Notes

* Appearance data is persisted in the database
* Supports both male and female ped models
* Tattoos are organized by body zone (torso, left arm, right arm, left leg, right leg, head)
* The NUI uses a dark theme consistent with other NOVA scripts