Clothingstore

Clothing store with live preview: players change their clothes, save looks as outfits for cash and share them with others. With the clothing bag they can put on their outfits on the go, too. On top of that there is a barber shop and a tattoo studio with their own locations, blips and menus.

Features

• Live preview with a camera on the matching body part. Dragging rotates the character, the mouse wheel zooms.
• 14 categories with Variant and Style.
• Outfits per character: save them for a fixed price, wear, rename, share and delete them.
• Shared: wear other players' outfits for free (the 100 newest).
• Clothing bag (item clothbag): put it down on the ground and wear your own outfits there.
• Everyone sees the bag and can use it.
• Only the owner can pick it up. If the owner is offline, anyone can pick it up.
• Bags that were put down stay even after a restart.
• /clearbags clears all bags that were put down.
• Barber shop with live preview and a camera on the head:
• all hairstyles and variants of the character model, all hair colors with highlights
• beard, eyebrows, chest hair, makeup, blush and lipstick with style, opacity and color (beard and chest hair only for male characters)
• You pay per changed category. Cancelling restores the old look.
• Tattoo studio with all GTA tattoos including DLCs, read directly from the game:
• sorted by head, torso, arms and legs, with search and the Mine filter
• preview on the character, get inked and remove for a fixed price
• saved per character and automatically re-applied after logging in, respawning and every skin change
• Barber shop and tattoo studio take cash first, the rest from the bank.

Installation

1. Put the off_clothingstore folder into your resources folder.
2. Add to your server.cfg, after oxmysql, ESX and skinchanger:

ensure oxmysql
ensure es_extended
ensure skinchanger
ensure esx_skin
ensure off_clothingstore

1. Remove esx_clotheshop or other clothing stores at the same locations.

On the first start the script automatically creates:

• the tables off_clothing_outfits, off_clothing_bags and off_clothing_tattoos
• the item clothbag in the items table, if it is missing

Configuration

config/settings/config.lua

config/settings/config.categories.lua – Categories

Only these categories appear in the store and only they are saved in outfits, in the order of the file.

{ icon = 'shoes', label = 'Schuhe', variant = 'shoes_1', color = 'shoes_2', camOffset = vec3(0, 0.9, -0.8) },

config/settings/config.bag.lua – Clothing bag

With enabled = false bags that were put down stay in the database. They come back as soon as the bag is turned on again.

config/settings/config.lua – Barber shop and tattoo studio

Both have their own locations and blips, the circle (marker) is the same as for the store.

barber = {
  enabled = true,
  price = 150,
  blip = { enabled = true, sprite = 71, color = 0, scale = 0.8 },
  locations = { vec3(-814.3, -183.8, 36.6), ... },
},

Payment takes cash first, the rest from the bank. Prices only exist on the server, the client cannot change them. Tattoos are saved in the off_clothing_tattoos table, at most 100 per character.

config/functions.lua

This is where you connect your own scripts.

The server version sends the message directly via ESX. If you use your own notify script, adjust both Notify functions.

Languages

All texts are in config/locales/<language>.json, currency and number format under ui (currency, intl). For your own language, copy a file, translate it and set serverInfo.locale. Placeholders like %d and {price} must stay in. The category names are in config/settings/config.categories.lua (label). The names of the barber categories and body zones are under ui.barber.groups and ui.tattoo.zones, the tattoo names come from GTA in the game language.

In game

Store

Press E in the circle in front of the store, EXIT or ESC closes it.

• Clothing: change items and save them as an outfit.
• Saved: wear, rename, share and delete your own outfits.
• Shared: wear other players' outfits.

Clothing bag

• Put down: use the clothbag item in your inventory, the bag is put down on the ground in front of you. This doesn't work in a vehicle, while dead or in another dimension.
• Above the bag you see [E] Use. The owner also sees [H] Pick up. If the owner is offline, everyone sees [H] Pick up.
• E opens a list of your saved outfits on the left. Wear puts the outfit on, the list stays open. ESC or EXIT closes it, and so does walking away.
• H puts the bag back into your inventory. You can change the key in the FiveM key bindings.

Barber shop

Press E in the circle in front of the barber shop. Hat and mask are taken off for the preview, the camera shows the head.

• Pick the category at the top: Hair, Beard, Eyebrows, Chest hair, Makeup, Blush or Lipstick.
• Change Style and Variant with the arrows or by clicking the number, Opacity with the slider, Color and Highlights in the color palette.
• Dragging rotates the character, the mouse wheel zooms.
• Pay shows the costs (price × changed categories) and saves the look. Cancel, EXIT or ESC resets everything that isn't paid yet.

Tattoo studio

Press E in the circle in front of the studio. The character is undressed for the preview, the clothes come back when you leave.

• Pick the zone at the top, the camera moves there. The number shows inked / all tattoos of the zone.
• Clicking a tattoo previews it on the character, another click hides it. Search tattoo filters by name, Mine only shows inked ones.
• Ink buys the tattoo, Remove takes off an inked tattoo for the removal price.
• Done, EXIT or ESC closes the studio.

Commands

Console

On start the script checks the setup and reports errors and hints in the server console. If everything is fine, it says “started successfully” there. If this message is missing, read the errors above it, fix them and restart. If the clothbag item is newly created, the console reports that as well. If the barber shop or tattoo studio is on but has no locations, a warning appears.

Common issues