Installation

Etwa fünf Minuten, und ein vollständiger Server-Neustart zum Abschluss. Der häufigste Fehler liegt in der Reihenfolge der Zeilen in der server.cfg — lies Schritt 3 lieber zweimal.

Vor der Installation

Du benötigst	Warum
oxmysql, aktiv	Designs, Items und Outfits werden in der Datenbank gespeichert
ox_lib	Callbacks und Benachrichtigungen des Studios
ESX, QBCore oder QBox (optional)	Nur für tragbare Gegenstände. Ohne Framework läuft das Studio als Standalone
ox_inventory (optional)	Wird für Items bevorzugt, sofern aktiv
Ein Gemini API-Key (optional)	Nur für den KI-Texturgenerator — kostenlos auf aistudio.google.com/apikey
Ein Fivemanage-Token (optional)	Hostet Bilder von Designs und Items — kostenlos auf fivemanage.com

1. Beide Ordner einfügen

Das Paket besteht aus zwei Ressourcen. Lege beide nebeneinander in deinen resources-Ordner — beispielsweise in resources/[mic]/mic_cloth_designer und resources/[mic]/mic_cloth_addons.

2. Die Datenbank — nichts zu tun

Die Tabellen legen sich beim ersten Start automatisch an: mic_cloth_designs und mic_cloth_imported für Designs, mic_cloth_items für Items und Outfits.

mic_cloth_designs.sql liegt im Hauptverzeichnis von mic_cloth_designer bei, falls jemand die ersten beiden Tabellen manuell anlegen möchte. Du brauchst die Datei nicht.

3. server.cfg — die Reihenfolge zählt

Zwei getrennte Zeilengruppen an zwei verschiedenen Stellen.

Weit oben in der server.cfg, vor jedem ensure:

Gib der Ressource mic_cloth_designer die ACEs command.refresh, command.ensure, command.start und command.stop (vier Zeilen add_ace resource.mic_cloth_designer … allow) — das Studio startet mic_cloth_addons nach dem Export eines Kleidungsstücks selbst neu;
Füge die Dateisystem-Berechtigung hinzu, die mic_cloth_designer das Schreiben in mic_cloth_addons gestattet (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
Weise allen, die das Studio nutzen dürfen, die ACE mic_clothdesigner zu — etwa an group.admin oder an eine spezifische identifier.discord:….

Weiter unten bei deinen anderen Ressourcen: ensure oxmysql, danach ox_lib, danach mic_cloth_addons, danach mic_cloth_designer. Ein ensure [mic], das beide Ordner abdeckt, funktioniert ebenfalls, sofern es nach dem oberen Berechtigungsblock steht.

Möchtest du es nur kurz ausprobieren? Setze Config.OpenPermission = false in shared/config.lua, damit jeder das Studio öffnen kann — die Dateisystem-Schreibberechtigung bleibt dennoch zwingend erforderlich.

4. API-Schlüssel eintragen

Öffne mic_cloth_designer/shared/keys.lua. Dies ist eine reine Serverdatei: Keine Information daraus wird jemals an einen Client gesendet. Fülle die genutzten Werte aus und belasse ungenutzte Einträge als leere Anführungszeichen.

Schlüssel	Funktion	Erforderlich
`GeminiAPIKey`	Der KI-Texturgenerator	Nur für KI. Leer = das KI-Tool ist deaktiviert
`FivemanageToken`	Hostet Vorschaubilder von Designs und Items	Empfohlen. Leer = Bilder werden in der Datenbank gespeichert
`DiscordWebhook`	Protokolliert jede KI-Generierung samt Kosten	Optional
`ClothNetworkKey`	Leer lassen. Das Cloth Network läuft ohne Key	Nein

5. Items

Ein einziges generisches Item deckt jedes Design ab: cloth_design (Name definiert in Config.Items.Name in shared/config.lua).

Item	Funktion
`cloth_design`	Zieht das hinterlegte Design an; erneute Benutzung stellt alte Kleidung wieder her

Definitionen liegen in mic_cloth_designer/items/:

Datei	Für
`items/ox.lua`	ox_inventory — gehört in `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — gehört in `qb-core/shared/items.lua`

Es wird kein allgemeines Bild mitgeliefert: In ox_inventory zeigt jedes Item das gerenderte Bild des jeweiligen Designs. Bei QBCore kannst du ein Standard-Icon cloth_design.png in qb-inventory/html/images/ hinterlegen. Auf ESX ohne ox_inventory erstelle ein Item mit dem Namen cloth_design auf die übliche Weise.

In Shops verkaufte Designs erhalten später eigene Item-Namen — siehe 🎒 Items.

6. Framework

Keine manuelle Umschaltung nötig. Die Item-Bridge erkennt qb-core oder es_extended automatisch und nutzt ox_inventory, sofern aktiv. Setze Config.Framework in shared/config.lua passend zu deinem Server auf 'qb' oder 'esx'.

Auf QBox wird die Anbindung über die QBCore-Kompatibilität realisiert — qbx_core liefert qb-core — und Config.Framework verbleibt auf 'qb': QBox führt QBCore-Ressourcen über seinen Kompatibilitätslayer aus.

Standalone wird ebenfalls unterstützt. Ohne Framework funktionieren das Studio, die 3D-Vorschau, der KI-Generator und das Cloth Network wie gewohnt; lediglich die ACE-Berechtigung wird zum Öffnen verlangt. Belasse Config.Framework auf 'qb'. Die tragbaren Gegenstände sind der einzige Bestandteil, der ESX, QBCore oder QBox voraussetzt.

7. Vollständiger Neustart und das erste Design

Starte den gesamten Server neu, nicht nur die Ressource: GTA liest Kleidungsdaten beim Booten des Servers ein.

Gib im Spiel /clothdesigner ein.
Wähle ein Kleidungsstück aus der Library, bemale es und klicke auf Save.

Es hat geklappt, wenn sich das Studio mit Library, 3D-Vorschau und Editor nebeneinander öffnet, Save mit Saved bestätigt und dein Charakter die Kleidung mit deinem Design trägt.

Um es später erneut anzuziehen, wandle es in ein Item um — siehe 🎒 Items.

Vor der Servereröffnung

Schalte Config.Debug aus in shared/config.lua. Es ist standardmäßig aktiviert und gibt jeden Einzelschritt in der Konsole aus.
Entscheide über Config.GlobalContent. Aktiviert (Standard), sieht und bearbeitet jeder berechtigte Designer alle Entwürfe, Items und Outfits gemeinsam.
Halte shared/keys.lua geheim. Sie enthält deinen Gemini-Key, Fivemanage-Token und Webhook. Leere die Datei vor einer Weitergabe deines Codes.
Prüfe, wer mic_clothdesigner besitzt. Mit eingetragenem Gemini-Key wird jede KI-Generierung über dein Konto abgerechnet.