FEATURES#

Character Creation#

Heritage System#

Create unique characters with the dual-parent heritage system:

• Face 1 & Face 2 Selection - Choose from 45 different faces for each parent
• Shape Mix - Blend between parent face shapes (0-100%)
• Skin Mix - Blend between parent skin tones (0-100%)
• Third Mix - Advanced blending option for fine-tuning

Face Features#

20 individual face sliders for precise facial customization:

Overlays#

12 overlay types with full customization:

Clothing System#

Collection-Based Architecture#

Component Categories:

Prop Categories:

Texture Variants#

Each clothing item supports multiple textures, allowing for color and pattern variations without adding new drawables.

Shop System#

Zone-Based Shops#

Pre-Configured Locations:

Shop Types#

Interaction Types#

Supports multiple interaction methods:

• onex-interaction (midcontext) - Default modern interaction
• onex-interaction (leftinteraction) - Alternative left-side menu
• Keybind - Direct E key interaction in zones

Outfit System#

Save & Manage Outfits#

Features:

• Save Outfits - Store current appearance with custom name
• Update Outfits - Modify existing saved outfits
• Delete Outfits - Remove unwanted outfits
• Share Codes - 5-character codes for outfit sharing
• Import Outfits - Apply outfits from share codes

Job Uniforms#

Configure job-specific uniforms with grade restrictions:

config/shop.lua
Copy
Shop.JobOutfits = {
    ["police"] = {
        label = "Police Department",
        outfits = {
            { label = "Patrol Uniform", minGrade = 0, outfit = {...} },
            { label = "SWAT Gear", minGrade = 5, outfit = {...} },
        }
    }
}

Persistence:

• Uniforms persist across reconnects when Shop.PersistUniforms = true
• Automatic restoration on player spawn

Pricing System#

Dynamic Pricing#

Price Components:

Special Features:

• Scheduled Sales - Time-based discounts
• Bundle Deals - Multi-item discount packages
• Free Mode - everythingFree = true for testing

Tattoo System#

Full Body Tattoos#

5 body zones with complete GTA Online tattoo collection:

Features:

• Multiple tattoos per zone
• Real-time preview
• Per-tattoo pricing

Migration System#

Seamless Automatic Migration#

onex-creation features a fully automatic migration system that detects and converts player data from other clothing scripts seamlessly during the loading screen. Players won't even notice the transition - their existing outfits and appearance data are preserved automatically.

How It Works:

1. Player joins the server
2. System auto-detects existing skin/clothing data format
3. Data is seamlessly converted to onex-creation format
4. Player loads in with their existing appearance intact

Supported Formats:

Screenshot Studio#

Automated Preview Generation#

Generate clothing preview images for your UI:

Features:

• Per-component camera settings
• Environment control (weather, time)
• Parallel scanning for speed
• Configurable output sizes

Studio Settings:

• Weather: EXTRASUNNY (default)
• Time: 12:00 (noon)
• Customizable camera offsets
• Safe capture delay: 100ms

Permission System#

Advanced Blacklist/Whitelist#

Control item availability with multiple layers:

Example:

config/permissions.lua
Copy
GlobalBlackListClothes = {
    male = {
        mask = { 1, 5, 10 },  -- Blacklist mask IDs
        torso = { 15, 20 }
    }
}

Next Steps#