Updating Clothing Creator means replacing one folder. Everything you made — designs, published clothing, imported templates, settings — lives in your database and in qs-clothing-data, and neither of them is part of a download.
What Lives Where#
Everything Clothing Creator puts on your server, and what to do with each piece when a new version comes out:
Piece | What it is | On an update |
|---|---|---|
| The resource itself. | Replace it. |
| Your uploads, the textures of every published piece, and your imported templates. | Keep it exactly where it is. Never delete, move or replace it. |
| Generated from your database and qs-clothing-data on every start. | Leave them. Deleting them loses nothing — the next start writes them again. |
The | Designs, published items, settings and history. | Keep them. New columns are added by the resource itself. |
Files you edited |
| Carry your changes over into the new version. |
Settings changed in game survive every update untouched: they live in
qs_clothing_settings, not in a file. A new version only changes the defaults of settings you never touched.
Updating Step by Step#
Back up
Export the whole database with HeidiSQL, phpMyAdmin or your host's panel, and copy the
qs-clothing-datafolder somewhere safe.Download the new version
From the CFX Portal → Granted Assets, exactly as on the first install.
Save the files you edited
Copy
config/config.lua,custom/config.lua,server/webhooks.luaand any bridge or locale you changed out of the old folder.Stop the server
The new version writes the clothing declarations again on its first start, and a start with nobody online is the moment the game takes them. Restarting only qs-clothing-designer under players works too, but any change to the declarations then waits until the server is empty.
Replace qs-clothing-designer
Delete the old
qs-clothing-designerfolder and drop the new one in the same place. Do not touchqs-clothing-data. Then put your values back into the new files — compare rather than overwrite, a new version may add lines.Start the server
A quiet console means a healthy update. Every published collection is rebuilt from qs-clothing-data with the new version on its own — nothing has to be published again.
After the Update#
Open /clothingdesigner → Admin. The capacity of every collection, the items waiting for a restart and your published items are all there. An item listed under Needs re-publishing lost its texture file from qs-clothing-data/items: open its design from Saved Designs and publish it again. Every other item keeps publishing normally in the meantime.
When a newer version is available, the console says so once at start:
[qs-clothing-designer] Update available: 1.0.2 -> 1.0.3Moving to Another Server#
Take three things with you: the database, the qs-clothing-data folder and qs-clothing-designer. Leave qs-clothing-meta and qs-clothing-assets behind if you like — the first start on the new machine writes both again from the other two. Add the same add_ace lines to the new server.cfg.
Uninstalling#
Clean up server.cfg
Remove the three
ensurelines and the fiveadd_ace resource.qs-clothing-designerlines.Delete the resources
Delete
qs-clothing-designer,qs-clothing-metaandqs-clothing-assets. Deleteqs-clothing-dataonly if you do not want to keep the clothes.Drop the tables (optional)
Run
[sql]/clean.sqlon your database. It deletes every design, published item and setting.
Published clothing leaves the game with the resources: a player wearing a published piece is left without it the next time their outfit loads. Keep the database and qs-clothing-data, and a later reinstall brings every piece back exactly as it was.