atelier — the desktop app

atelier manages your drawables, shows them in real-time 3D and turns them into finished, in-game-ready add-ons — in the spirit of grzyClothTool, rebuilt from scratch as its own thing. You work in a workbench, check everything in the preview and export with a single click.

• Solo mode: fully local, no account or server — works completely offline.
• Targets: FiveM, singleplayer, RageMP and alt:V.
• Real binary YMTs, automatic 128-drawable splitting, texture optimization.
• Optional: a team cloud for building the same pack together.

Grab the latest version from the GitHub releases and pick one of the builds:

• Installer (.exe) — the standard route. Double- click, install, done.
• MSI — the alternative, e.g. for managed environments.
• Portable ZIP — no installation: unzip and launch atelier.exe. The app and sidecar are both included.

On first launch a short onboarding wizard walks you through setup. You can rerun it any time later from the settings.

1. 1
   Mode. Choose how you use atelier: Solo — fully local, no account and no server (everything runs offline) — or Team, to sign in and share packs via the cloud. You can switch the mode any time later in the settings.
2. 2
   Server address (team only). In team mode you enter the address of your atelier-api. atelier checks it live and turns green when an atelier-api is running there. The default for local testing is http://127.0.0.1:3095. In solo mode this step is skipped.
3. 3
   GTA V directory. Choose the folder of your GTA V installation. This lets the 3D preview show the real ped body. Optional — without a GTA path everything else still works.
4. 4
   Logs. Optionally enable a live log console that shows app and sidecar events. Handy when something goes wrong; otherwise you can leave it off.

Login goes through Discord. atelier briefly opens your browser, you confirm on Discord, and the app is signed in — there are no passwords.

1. 1
   Click “Sign in” in atelier.
2. 2
   Confirm with Discord in your browser. The login then returns to the app automatically.
3. 3
   Done — the app remembers your login and refreshes it in the background.

The workbench is your workspace — three columns plus a dockable preview:

Category tree (left)

Every component and prop slot with live counters. Warning badges flag problems early — such as missing LODs or too many or oversized textures.

Drawable list (center)

• Search and filter in real time, multi-select with Ctrl/Shift-click.
• Reorder via drag & drop — the order determines the build order.
• Context menu to duplicate, delete and group; identical YDD hashes are detected as duplicates.

Inspector (right)

Details for the selected drawable: label, gender, slot, add-on or replace mode, groups and flags like high heels and hair scale. Below it sits the textures panel with the a–z variants and their thumbnails.

The dockable preview shows your drawables in real time — in the dark feelgood look with a freely rotatable camera.

• Several drawables at once as a complete outfit, including texture variants to cycle through.
• Camera presets for full body, head, torso, legs and feet.
• Hair shrink & heel height adjustable live — so you can immediately see how much the hair shrinks or how high heels lift the ped.
• Ped body toggle (mp_m/mp_f) as soon as a GTA V path is set. Overlays show poly/vertex counts and LOD warnings.

Beyond clothing, atelier also builds tattoos — in their own Tattoos area (the icon in the top navigation). Tattoos are fixed-UV decals: you import an image and set zone, gender and type; the exact placement lives in the texture.

• Import — PNG, DDS or YTD via a button; works fully offline (no GTA path needed).
• Organize — by the six body zones (torso, head, left/right arm, left/right leg), with search, a grid and an inspector. Right-click to duplicate, change zone/gender, group and delete.
• Gender — one decal can serve both freemode peds (M/F); each gender gets its own overlay name.
• Build — produces a streamable FiveM pack: a YTD per decal, one shared overlay collection, an optional shop_tattoo.meta and a tattoos.json manifest your server reads at runtime.

“Build” exports your project as a finished resource. The dialog walks you through setup, validation and build in three steps.

1. 1
   Setup. Pick a target, set the DLC name (lowercase letters, digits and underscore only) and choose an output folder.
2. 2
   Validation. atelier checks the project and lists errors, warnings and hints — each with a jump to the affected drawable. Errors block the build, warnings don't.
3. 3
   Build. Progress runs live through the phases (files → YMT → packaging). At the end you open the output folder directly.

The targets at a glance

With a connected atelier-api you build the same pack together. In the workbench's cloud area you link your project to a cloud pack and sync states.

• Upload (push). Uploads only the files that are genuinely new (dedupe by hash) and commits a new revision.
• Download (pull). Fetches the current state; local changes are safeguarded beforehand.
• Cloud projects. Team packs appear on the home screen and can be cloned locally.
• Presence & locks. Avatars show who's online; soft locks keep you from getting in each other's way on the same drawable.

Settings

• Manage the server address, GTA V path and sidecar status.
• Turn live logs on or off.
• Rerun the onboarding wizard to go through the initial setup again.
• Admins find the Admin tab here, with the list of pending members and approve/lock actions.

The sidecar status (top right)

The little pill shows the state of the .NET sidecar: green = ready, orange = starting, red = unreachable. Parsing, preview and build all need a green sidecar.