Fehlerbehebung

Reale Probleme bei der Nutzung, ungefähr in der Reihenfolge ihres Auftretens.

Eine Änderung an der Ressource bewirkt nichts

restart liest fxmanifest.lua nicht neu ein. Wenn du eine Datei hinzugefügt hast — zum Beispiel eine neue Sprachdatei —, führe zuerst refresh in der Server-Konsole aus und starte dann neu. Alles, was mit Kleidungsstücken zu tun hat, erfordert zwingend einen vollständigen Server-Neustart und keinen reinen Ressourcen-Neustart: GTA registriert Kleidung nur beim Booten des Servers.

`/clothdesigner` meldet fehlende Berechtigungen

Dir fehlt die in Config.OpenPermission hinterlegte ACE (mic_clothdesigner). Weise sie in der server.cfg deiner Gruppe oder deiner Kennung zu. Um Berechtigungsprobleme während Tests auszuschließen, setze Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” in der Konsole

Das Studio kann nicht in mic_cloth_addons schreiben. Mögliche Ursachen:

Die Dateisystem-Schreibberechtigung von mic_cloth_designer auf mic_cloth_addons fehlt;
Sie ist vorhanden, steht jedoch unterhalb der ensure-Befehle — sie muss vor dem Ressourcenstart stehen;
mic_cloth_addons läuft nicht oder startet nach dem Designer;
Ein Ordner wurde umbenannt oder die author-Zeile in einer der beiden fxmanifest.lua-Dateien wurde geändert.

Behebe die Ursache und starte den gesamten Server neu. Siehe Schritt 3 unter 🪛 Installation.

Das Studio öffnet sich, aber die Library ist leer oder Vorschaubilder laden nicht

Meist dieselbe Ursache wie oben: mic_cloth_addons läuft nicht oder das Studio kann nicht darauf zugreifen. Prüfe, ob es vor mic_cloth_designer startet. Beim allerersten Öffnen der Library werden Thumbnails gerendert und in html/previews/ gecacht; der erste Ladevorgang dauert daher etwas länger.

Ich habe auf Replace geklickt und sehe am Charakter noch das alte Design

Erwartetes Verhalten. GTA hält die Textur angezogener Kleidung im Client-Cache; ein Replace wird erst nach einem Reconnect sichtbar. Save (neue Textur) wird sofort angezeigt.

“Slot limit reached for this garment”

Jedes Kleidungsstück hat eine begrenzte Anzahl an Texturslots. Starte die Ressource neu, damit ungenutzte Slots komprimiert werden, lösche nicht mehr benötigte Entwürfe oder wechsle auf ein anderes Kleidungsstück.

Ein importiertes Kleidungsstück taucht nicht in der Library auf

Nach dem Import ist ein Server-Neustart erforderlich — mitunter zwei: Der erste Neustart importiert das Modell, der nächste registriert es in GTA.
Der Dateiname muss mit einem gültigen Komponenten-Präfix beginnen (jbib, lowr, feet, …) und in import/male/ oder import/female/ liegen, es sei denn, der Name beginnt bereits mit mp_m_ oder mp_f_.
Führe importaddons in der Server-Konsole aus: Zeilen mit ! markieren abgewiesene Dateien samt Begründung.

Ein importiertes Kleidungsstück ist unsichtbar oder bringt das Spiel zum Absturz

Fast immer die falsche Variante: _r für die meisten Hosen, _u für fast alles andere. Tausche das Suffix und importiere erneut. Zu große Dateien — über 6 MB entpackt oder mit eingebetteter Textur über ca. 3 MB — werden beim Import aus genau diesem Grund abgewiesen. Falls eine solche Datei bereits gestreamt wird und Clients crasht, entferne sie aus mic_cloth_addons/stream/.

Die KI generiert keine Texturen

Das Studio nennt den Grund; die Server-Konsole gibt die Rückmeldung des Anbieters samt Fehlercode aus:

Code	Bedeutung
`AI_NO_KEY`	Kein `GeminiAPIKey` in `shared/keys.lua` hinterlegt oder Key abgewiesen
`AI_DISABLED`	`Config.AI.Enabled` ist in `shared/keys.lua` deaktiviert
`AI_QUOTA`	Dein Google AI-Konto hat sein Kontingent aufgebraucht oder benötigt Abrechnung
`AI_RATELIMIT`	Zu viele Anfragen in kurzer Zeit — kurz warten
`AI_BUSY`	Eine Generierung läuft für diesen Spieler bereits
`AI_EMPTY_PROMPT`	Es wurde kein Beschreibungstext eingegeben
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	Der Anbieter lieferte eine unbrauchbare Antwort; Details stehen in der Konsole

Hinterlässt das Ergebnis weiße Stellen, füllt Fill white gaps diese mit der Hauptfarbe des Entwurfs.

Fehlende Bilder oder schnell wachsende Datenbank

Ohne ein FivemanageToken in shared/keys.lua wird jedes gerenderte Bild direkt in der Datenbank gespeichert, und ox_inventory-Items können ihr Design nicht als Bild anzeigen. Trage ein Fivemanage-Token ein.

Das Benutzen des Items bewirkt nichts

Ist cloth_design in deiner Item-Datei eingetragen, exakt passend zu Config.Items.Name?
Läuft der Server auf ESX, QBCore oder QBox? Items werden über das Framework registriert; ohne Framework gibt es keinen Item-Support. Bei QBox muss qbx_core vor mic_cloth_designer starten.
Bei Shop-Items: Wurde Save name geklickt und stimmt der Name in der Item-Datei exakt überein?
Wurde das Inventar nach dem Hinzufügen des Items neu gestartet?

Ein angezogenes Design verschwindet nach dem Reconnecten

Erwartetes Verhalten. Das Anziehen über ein Item gilt für die aktuelle Sitzung; es wird nicht dauerhaft im Erscheinungsbild des Charakters hinterlegt. Benutze das Item einfach erneut.

Ein heruntergeladenes Netzwerk-Design lässt sich nicht anwenden

Designs, die ein auf deinem Server noch nicht vorhandenes Kleidungsmodell voraussetzen, laden dieses Modell zuerst herunter. Starte den Server neu und importiere das Design danach noch einmal.

Alles wird auf Englisch angezeigt

Config.Locale in shared/config.lua steuert die Sprache (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Nach einer Änderung neu starten.

Die Konsole ist voll mit `[ClothDesigner]`-Ausgaben

Config.Debug ist standardmäßig aktiviert. Setze es in shared/config.lua auf false.