> For the complete documentation index, see [llms.txt](https://codeforge.gitbook.io/codeforge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codeforge.gitbook.io/codeforge/sleek-series/sleek-clothes-store.md). # SLEEK CLOTHES STORE {% embed url="" %} ## Forge Clothes Clothing store resource for FiveM — business management, NPC employees, outfit saving/sharing, uniform points, and modern UI. ### Features * Auto-detection of ESX / QBCore and skin handler * 13 pre-configured stores (1 mask shop, 9 general, 3 Ponsonbys) * Business system with worker/owner ranks and revenue split * NPC employees with passive income and happiness system * Supply/stock system * Outfit saving, loading, and sharing between players * Uniform points — job-restricted locker rooms with predefined outfits * Item blacklist — hide specific clothing variants per gender * Modern NUI with configurable colors, blur, and sounds * ox\_target / qb-target or classic marker + keypress * 9 banking integrations (ESX, QB, neon-boss, OKOK, FD, TGG, WASABI, CODEM, JUSTBANKING) * Discord webhooks, multi-language (EN/ES) ### Requirements | Dependency | Required | | -------------------------------------------------------------------------------------------------- | :----------------------------------: | | [oxmysql](https://github.com/overextended/oxmysql) (or mysql-async / ghmattimysql) | Yes | | ESX or QBCore | Yes | | A skin handler (illenium-appearance, rcore\_clothing, fivem-appearance, qb-clothing, or esx\_skin) | Yes | | neon-boss | Only if `Cfg.UseNeonBossMenu = true` | | ox\_target or qb-target | Only if `Cfg.UseTargetSystem = true` | ### Installation #### Step 1 — Place the resource Copy `forge-clothes` into your server's `resources/` directory. #### Step 2 — Database Import the SQL tables from `INSTALL SQL.sql`: ```sql CREATE TABLE `outfits` ( `id` INT(11) NOT NULL AUTO_INCREMENT, `identifier` LONGTEXT NULL DEFAULT NULL, `name` LONGTEXT NOT NULL, `outfit` LONGTEXT NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB; ``` The business table (`forge_clothestore_business`) is created automatically on first start. #### Step 3 — server.cfg ```cfg ensure oxmysql ensure es_extended # or qb-core ensure forge-clothes ``` #### Step 4 — Start your server The resource auto-detects your framework and skin handler. Edit `config/config.lua` to customize. ### Configuration All configuration lives in `config/config.lua`: ```lua Cfg.Locale = 'en' -- 'en' or 'es' Cfg.SQLWrapper = 'oxmysql' -- 'oxmysql', 'mysql-async', or 'ghmattimysql' Cfg.UseTargetSystem = false -- true = ox_target / qb-target Cfg.AllowOutfitSaving = true -- Let players save outfits Cfg.EnableOutfitSharing = true -- Let players share outfits ``` #### Auto-detection | What | How | | ------------ | ------------------------------------------------------------------------------------------------------ | | Framework | `es_extended` running → ESX, `qb-core` running → QB | | Skin Handler | First started wins: illenium-appearance → rcore\_clothing → fivem-appearance → qb-clothing → esx\_skin | ### Stores Stores are defined in the `Cfg.Stores` array. Ships with 13 pre-configured stores. #### Adding a new store Append an entry to `Cfg.Stores`: ```lua { label = 'My Custom Store', coords = vector3(100.0, 200.0, 30.0), npcModel = 's_f_y_shop_low', npcSpawnPoint = vector4(101.0, 201.0, 30.0, 180.0), blip = { use = true, sprite = 73, color = 5, name = 'map.clothing_store' }, marker = { use = true }, distance = { marker = 3.0, text = 2.0 }, whitelistItems = false, wardrobeInShop = { use = true, coords = vector3(102.0, 202.0, 30.0) }, isBusiness = false, assignedJob = '', societyKey = '', workerRanks = {}, ownerRanks = {}, managementPoint = nil, bossMenuPoint = nil, }, ``` #### Specialized stores (whitelist) Restrict a store to specific categories: ```lua whitelistItems = { 'Masks' }, -- Only masks whitelistItems = { 'Hats', 'Glasses' }, -- Only hats and glasses whitelistItems = false, -- Everything (default) ``` Names must match the `label` field in `Cfg.Items`. #### In-store wardrobe ```lua wardrobeInShop = { use = true, coords = vector3(x, y, z) }, -- With wardrobe wardrobeInShop = { use = false }, -- Without ``` ### Item Blacklist Hide specific clothing variants per gender using the `blackListed` field in `Cfg.Items`: ```lua { category = 'upper-body', label = 'Tops', type = 'clothes', id = 11, price = 300, blackListed = { ['male'] = { 55, 56, 220 }, -- Blocked drawable indices ['female'] = { 48, 49, 230 }, }, }, ``` To find drawable indices, open your appearance resource, navigate to the category, and note the variant numbers. ### Business System Any store can be a managed business with its own balance, NPCs, stock, and sales history. #### Enabling a business store Set the business fields: ```lua isBusiness = true, assignedJob = 'clothestore1', societyKey = 'clothestore1', workerRanks = { 0, 1 }, ownerRanks = { 2, 3 }, managementPoint = vector3(430.0, -800.0, 29.49), ``` The job must exist in your framework (ESX `jobs` table or QB `shared/jobs.lua`). #### Management panel Players with owner rank access the panel at `managementPoint` to: * View and track company balance * Hire and fire NPC employees * Purchase stock * Review sales history #### Payment routing **Built-in balance** (default): ```lua Cfg.UseBuiltinBalance = true ``` **External banking:** ```lua Cfg.UseBuiltinBalance = false Cfg.SocietyMethod = 'ESX' -- ESX, QB, FORGE, OKOK, FD, TGG, WASABI, CODEM, JUSTBANKING ``` #### Neon-Boss ```lua Cfg.UseNeonBossMenu = true ``` Routes all money through neon-boss. Each store's `societyKey` must match the plain job name (not `'society_'` prefix). ### NPC Employees Business stores can hire virtual clerks from a rotating pool via the management panel. ```lua Cfg.NPCPool = { { name = 'Jessica Monroe', ped = 'a_f_y_business_01', level = 2 }, { name = 'Marcus Delgado', ped = 'a_m_y_hipster_01', level = 1 }, -- Add more... } Cfg.MaxNPCEmployees = 3 Cfg.NPCRotationMinutes = 120 ``` #### Salaries ```lua Cfg.NPCSalaryPerLevel = 150 -- Salary = level × 150 Cfg.NPCSalaryIntervalMin = 60 -- Paid every 60 minutes ``` #### Passive income When `EnableExtraSales = true`, each NPC generates revenue: ``` Revenue = ExtraSaleBase × (Level ^ ExtraSaleLevelExp) × HappinessMod × TeamBonus ``` #### Happiness | Level | Modifier | Cause | | :-----: | :------: | -------------------------------------- | | 3 Happy | ×1.00 | Stock OK, salary paid | | 2 OK | ×0.75 | Stock running low | | 1 Sad | ×0.35 | Unpaid salary | | 0 Angry | ×0.00 | Unpaid + critical stock — NPC may quit | ### Stock System Business stores consume stock per sale. Owners restock via management panel. ```lua Cfg.DefaultSupplyMax = 100 -- Max stock capacity Cfg.SupplyPerSale = 1 -- Stock consumed per item sold Cfg.SupplyUnitPrice = 50 -- Cost per stock unit Cfg.SupplyBuyIncrement = 10 -- Units per partial purchase Cfg.SupplyAngerThreshold = 50 -- Below 50 → NPCs become sad Cfg.SupplyCriticalThreshold = 10 -- Below 10 → NPCs become angry ``` ### Uniform Points Job-restricted locker rooms where employees can equip predefined uniforms. ```lua Cfg.UniformPoints = { { label = 'LSPD Locker Room', coords = vector3(452.43, -992.79, 30.69), jobs = { 'police' }, ranks = {}, -- Empty = all ranks uniforms = { { label = 'Patrol Uniform', male = { { type = 'clothes', id = 11, index = 55, texture = 0 }, -- Top { type = 'clothes', id = 4, index = 35, texture = 0 }, -- Pants { type = 'clothes', id = 6, index = 25, texture = 0 }, -- Shoes { type = 'prop', id = 0, index = 46, texture = 0 }, -- Hat }, female = { ... }, }, }, }, } ``` | `type` | `id` reference | | --------- | --------------------------------------------------------------------------------------------------- | | `clothes` | 1=Masks, 3=Torso, 4=Legs, 5=Bags, 6=Shoes, 7=Accessories, 8=Undershirt, 9=Armor, 10=Decals, 11=Tops | | `prop` | 0=Hats, 1=Glasses, 2=Ears, 6=Watches, 7=Bracelets | Equipping a uniform saves the player's current clothes. "Restore Clothes" returns to the original outfit. ### Outfit Sharing Players can share their current outfit via command: ```lua Cfg.EnableOutfitSharing = true Cfg.OutfitSharingCommand = "shareoutfit" ``` A popup lists nearby players (< 3m, same ped gender) with mugshots. The receiver gets an Accept/Deny prompt. ### Camera | Control | Action | | ------------ | ------------------------------------------ | | Mouse drag | Adjust height | | Scroll wheel | Zoom in/out | | Pie-menu | Switch zone (face, chest, legs, full body) | Zone FOV and height are configurable in `Cfg.CamFov` and `Cfg.CamHeight`. ### UI Appearance Colors, effects, and animations: ```lua Cfg.EnableBlur = true -- Background blur Cfg.EnableUISounds = true -- Hover/click sounds Cfg.EnableBackground = true -- Dark overlay Cfg.EnableHandsUpUI = true -- Arms-up pose while browsing ``` Color customization in `Cfg.UISettings.colors`. ### Translations ```lua Cfg.Locale = 'en' -- 'en' or 'es' ``` All strings in `config/translation.lua`. Copy the `en` block to add a new language. ### Exports Server-side exports for other resources: ```lua local balance = exports['forge-clothes']:getCompanyMoney(storeKey) exports['forge-clothes']:addCompanyMoney(storeKey, amount) exports['forge-clothes']:removeCompanyMoney(storeKey, amount) ``` `storeKey` is the store's position in `Cfg.Stores` as a string (e.g. `"1"`, `"2"`). ### Skin Manager Compatibility Most skin managers include a built-in clothing shop. When forge-clothes is running, the skin manager should disable its own clothing blips/zones to avoid duplicates. #### Does my skin manager need modification? | Skin Manager | Needs Modification? | | ------------------------- | :-----------------------: | | esx\_skin / skinchanger | No — works out of the box | | illenium-appearance (ESX) | **Yes** | | illenium-appearance (QB) | **Yes** | | fivem-appearance (ESX) | **Yes** | | qb-clothing (QB) | **Yes** | #### Pre-modified downloads Don't want to modify it yourself? Use the version that already includes full forge compatibility: > These versions auto-detect all three forge scripts (tattoo, barber, clothes). When a forge script is running, the skin manager disables its own overlapping shop and calls the appropriate export after every appearance load. {% file src="/files/9tLCByjrvPEmV6AC1gvK" %} {% file src="/files/rOLLUBI4jeKmaruMou9T" %} {% file src="/files/NWNH1EesPDbFH4dpyvtD" %} {% file src="/files/R5jSa760X1zyWDbH9hTG" %} ### FAQ **How do I know a store's index / storeKey?** Position in `Cfg.Stores` starting from `"1"`. **Can I mix public and business stores?** Yes. Each store is independent — `isBusiness = false` for public, `true` for job-based. **What happens when stock runs out?** Players can't buy. NPCs can't generate extra sales. Owners must restock via the panel. **Do NPCs spawn in the world?** No — they're virtual employees managed through the panel. Only the shopkeeper NPC (`npcModel`) spawns. **How do I make someone a store owner?** Assign them the matching job at an owner-level rank (e.g. job `clothestore1` grade `2`). ### Support [Join our Discord](https://discord.gg/UTVssdrXRV) — installation help, bug reports, feature requests. ### License © CodeForge — All rights reserved.