atelier — die Desktop-App

atelier verwaltet deine Drawables, zeigt sie in Echtzeit-3D und baut daraus fertige, in- game-taugliche Addons — im Geiste von grzyClothTool, eigenständig neu gebaut. Du arbeitest in einer Werkbank, prüfst alles in der Vorschau und exportierst mit einem Klick.

• Ziele: FiveM, Singleplayer, RageMP und alt:V.
• Echte binäre YMTs, automatischer 128er-Split, Textur-Optimierung.
• Optional: Team-Cloud zum gemeinsamen Bauen am selben Pack.

Lade die neueste Version aus den GitHub-Releases und wähle eine der Varianten:

• Installer (.exe) — der Standardweg. Doppelklick, installieren, fertig.
• MSI — die Alternative, z. B. für verwaltete Umgebungen.
• Portable-ZIP — keine Installation: entpacken und atelier.exe starten. App und Sidecar sind enthalten.

Beim ersten Start führt dich ein kurzer Onboarding-Assistent durch die Einrichtung. Du kannst ihn später jederzeit in den Einstellungen erneut starten.

1. 1
   Server-Adresse. Trage die Adresse deiner atelier-api ein. atelier prüft sie live gegen den Server und zeigt grün, wenn dort eine atelier-api läuft. Standard für lokale Tests ist http://127.0.0.1:3095. Für ein Team trägst du die URL eurer gehosteten Instanz ein.
2. 2
   GTA-V-Verzeichnis. Wähle den Ordner deiner GTA-V-Installation. Damit kann die 3D-Vorschau den echten Ped-Body anzeigen. Optional — ohne GTA-Pfad funktioniert alles andere trotzdem.
3. 3
   Logs. Optional kannst du eine Live-Log-Konsole aktivieren, die App- und Sidecar-Ereignisse anzeigt. Praktisch bei Problemen, sonst kannst du es ausgelassen lassen.

Login läuft über Discord. atelier öffnet kurz deinen Browser, du bestätigst bei Discord, und die App ist angemeldet — Passwörter gibt es keine.

1. 1
   In atelier auf „Anmelden" klicken.
2. 2
   Im Browser bei Discord bestätigen. Danach kehrt der Login automatisch zur App zurück.
3. 3
   Fertig — die App merkt sich die Anmeldung und verlängert sie im Hintergrund.

Die Werkbank ist dein Arbeitsplatz — drei Spalten plus eine andockbare Vorschau:

Kategoriebaum (links)

Alle Component- und Prop-Slots mit Live-Zählern. Warn-Badges weisen dich früh auf Probleme hin — etwa fehlende LODs, zu viele oder zu große Texturen.

Drawable-Liste (Mitte)

• Suchen und filtern in Echtzeit, Mehrfachauswahl per Strg/Shift-Klick.
• Per Drag & Drop umsortieren — die Reihenfolge bestimmt die Build-Reihenfolge.
• Kontextmenü zum Duplizieren, Löschen und Gruppieren; gleiche YDD-Hashes werden als Duplikate erkannt.

Inspector (rechts)

Details zum ausgewählten Drawable: Label, Geschlecht, Slot, Addon- oder Replace-Modus, Gruppen und Flags wie High-Heels und Hair-Scale. Darunter das Texturen-Panel mit den a–z-Varianten samt Thumbnails.

Die andockbare Vorschau zeigt deine Drawables in Echtzeit — im dunklen feelgood-Look mit frei drehbarer Kamera.

• Mehrere Drawables gleichzeitig als komplettes Outfit, inklusive Textur-Varianten zum Durchschalten.
• Kamera-Presets für Gesamt, Kopf, Torso, Beine und Füße.
• Hair-Shrink & Heel-Height live verstellbar — so siehst du sofort, wie stark Haare schrumpfen oder wie hoch Absätze den Ped anheben.
• Ped-Body einblenden (mp_m/mp_f), sobald ein GTA-V-Pfad gesetzt ist. Overlays zeigen Poly-/Vertex-Zahlen und LOD-Warnungen.

Über „Bauen" exportierst du dein Projekt als fertige Ressource. Der Dialog führt in drei Schritten durch Setup, Validierung und Build.

1. 1
   Setup. Ziel wählen, DLC-Namen festlegen (nur Kleinbuchstaben, Ziffern, Unterstrich) und Ausgabeordner bestimmen.
2. 2
   Validierung. atelier prüft das Projekt und listet Fehler, Warnungen und Hinweise — jeweils mit Sprung zum betroffenen Drawable. Fehler blockieren den Build, Warnungen nicht.
3. 3
   Build. Der Fortschritt läuft live durch die Phasen (Dateien → YMT → Paketierung). Am Ende öffnest du den Ausgabeordner direkt.

Die Ziele im Überblick

Mit einer angebundenen atelier-api baut ihr gemeinsam am selben Pack. Im Cloud-Bereich der Werkbank verknüpfst du dein Projekt mit einem Cloud-Pack und synchronisierst Stände.

• Hochladen (Push). Lädt nur die wirklich neuen Dateien hoch (Dedupe per Hash) und committet eine neue Revision.
• Laden (Pull). Holt den aktuellen Stand; lokale Änderungen werden vorher abgesichert.
• Cloud-Projekte. Team-Packs erscheinen auf der Startseite und lassen sich lokal klonen.
• Presence & Locks. Avatare zeigen, wer online ist; sanfte Locks verhindern, dass ihr euch beim selben Drawable in die Quere kommt.

Einstellungen

• Server-Adresse, GTA-V-Pfad und Sidecar-Status verwalten.
• Live-Logs ein- oder ausschalten.
• Den Onboarding-Assistenten erneut ausführen, um die Ersteinrichtung neu durchzugehen.
• Admins finden hier den Admin-Tab mit der Liste wartender Mitglieder und Freischalten/Sperren.

Der Sidecar-Status (oben rechts)

Die kleine Pille zeigt den Zustand des .NET-Sidecars: grün = bereit, orange = startet, rot = nicht erreichbar. Parsing, Vorschau und Build brauchen einen grünen Sidecar.