Özelleştirme

Ayarladığınız her şeyi iki dosya barındırır ve aralarındaki ayrım tek bir soruya dayanır: bir oyuncu bunu okusa sorun olur muydu? shared/config.lua her istemciye (client) gönderilir. shared/keys.lua ise yalnızca sunucu betiği olarak yüklenir ve sunucudan dışarı asla çıkmaz.

Hangi dosya neyi belirler

Aksi belirtilmedikçe tüm dosya yolları mic_cloth_designer içindedir.

Nerede	Neyi belirler	Düzenlemeye açık mı
`shared/config.lua`	Komut, tuş ataması, izin, dil, ortak veya oyuncuya özel kütüphane, çözünürlük, eşya, debug	Evet
`shared/keys.lua`	Anahtarlarınız ve token’larınız, YZ ayarları, fotoğraf barındırma, tasarlanabilir bileşenler listesi — sadece sunucu	Evet
`locales/*.lua`	Stüdyodaki ve bildirimlerindeki her metin; `locales/locale.lua` çözümleyicidir	Evet
`items/ox.lua`, `items/qb.lua`	ox_inventory ve QBCore için `cloth_design` eşya tanımı	Evet
`html/`	Stüdyonun arayüzü; `html/patterns/` baskıları, `html/previews/` önbelleğe alınmış kıyafet küçük resimlerini tutar	Escrow yok, ancak betikler karmaşıklaştırılmış (obfuscated) olarak gelir
`base/addon_templates/`	Stüdyonun yeni kıyafetler oluşturmak için kullandığı şablonlar. Olduğu gibi bırakın	Evet
`client/`, `server/`, `bridge/`	Mantık, dosya yazıcı, köprüler (bridges)	Escrow’lu
`mic_cloth_addons/import/`	Kendi `.ydd` kıyafetlerinizi bıraktığınız yer	Evet
`mic_cloth_addons/stream/`, `metas/`, `fxmanifest.lua`	Oluşturulan kıyafetler. Stüdyo tarafından yeniden yazılır — elle düzenlemeyin	Otomatik oluşturulur

Açık dosyalar, fxmanifest.lua içindeki escrow_ignore listesinde yer alan dosyalardır.

shared/config.lua

Seçenek	Ne işe yarar	Varsayılan
`Config.Framework`	`'esx'` veya `'qb'`. Sunucunuza uyacak şekilde ayarlayın; eşya köprüsü de framework’ü kendisi algılar. QBCore, QBox (QBCore uyumluluğu üzerinden) ve standalone bir sunucuda `'qb'` kullanın	`'qb'`
`Config.Locale`	Stüdyonun ve bildirimlerinin dili	`'en'`
`Config.Command`	Stüdyoyu açan komut	`clothdesigner`
`Config.Keybind`	Stüdyoyu açan tuş, örneğin `'F7'`. Tuş olmaması için `false`. Oyuncular FiveM tuş ayarlarından bunu değiştirebilir	`false`
`Config.OpenPermission`	Bir oyuncunun stüdyoyu açmak için ihtiyaç duyduğu ACE izni. `false` herkesin girmesine izin verir	`mic_clothdesigner`
`Config.GlobalContent`	`true`: içeri girmesine izin verilen herkes tek bir tasarım, eşya ve kombin kütüphanesini paylaşır. `false`: her tasarımcı yalnızca kendininkileri görür	`true`
`Config.TextureResolution`	Varsayılan doku boyutu: `256`, `512` veya `1024`. Düzenleyicideki açılır menü bunu tasarım başına değiştirir ve YZ buna uyar	`512`
`Config.MaxDesignsPerPlayer`	Kaydedilen tasarımlar için üst sınır. Dosyada mevcuttur ancak mevcut sürüm tarafından uygulanmaz	`50`
`Config.Items.Enabled`	Giyilebilir eşyaları, kombinleri ve mağaza eşyalarını açar veya kapatır	`true`
`Config.Items.Name`	Bir tasarımı taşıyan genel eşya	`cloth_design`
`Config.Items.Label`	Referans için tutulur. Her eşya kendi tasarımının adıyla gösterilir	`Clothing Design`
`Config.Debug`	Stüdyonun ne yaptığını konsola yazdırır. Açık olarak gelir — aktif bir sunucuda kapatın	`true`

shared/keys.lua

Anahtarlarınız

Anahtar	Ne işe yarar
`GeminiAPIKey`	YZ oluşturucuyu açar. Boş = YZ yok
`FivemanageToken`	Tasarım ve eşya fotoğraflarını Fivemanage’a yükler ve yalnızca bağlantıyı saklar. Boş = fotoğraflar veritabanında tutulur, bu da veritabanını daha hızlı büyütür
`DiscordWebhook`	Her YZ üretimini istem (prompt) ve tahmini maliyetle birlikte paylaşır. Boş = kapalı
`ClothNetworkKey`	Boş bırakın. Cloth Network üzerinde paylaşım yapmak ek ayar gerektirmeden çalışır

Yapay zeka oluşturucu — `Config.AI`

Önceden ayarlanmıştır. Bilmeye değer olan seçenek, maliyet ile kalite arasındaki dengeyi belirleyen Model seçeneğidir.

Seçenek	Ne işe yarar	Varsayılan
`Enabled`	Anahtar ne olursa olsun YZ’yi açar veya kapatır	`true`
`Provider`	`'gemini'` veya DALL·E için `'openai'` (bu durumda `GeminiAPIKey` içindeki anahtar OpenAI için kullanılır)	`'gemini'`
`Model`	`gemini-3.1-flash-lite-image` en ucuzu, `gemini-3.1-flash-image` dengeli olanı, `gemini-3-pro-image` en pahalısıdır	`gemini-3.1-flash-image`
`GeminiImageSize`	Yedek çıktı boyutu. Normalde kullanılmaz: düzenleyicinin çözünürlüğü bunu belirler	`512px`
`ImageSize`	Yalnızca OpenAI için çıktı boyutu	`1024x1024`
`AspectRatio`	Dokular karedir	`1:1`
`Pricing`	Milyon girdi ve çıktı token’ı başına USD maliyeti; yalnızca Discord kaydındaki maliyet tahmini için kullanılır	`0.50` / `60.00`

Her oyuncu için aynı anda bir üretim çalışır ve aralarında kısa bir bekleme süresi (cooldown) vardır.

Fotoğraf barındırma — `Config.Fivemanage`

Enabled ve yukarıdaki token. Fotoğraflar her tasarımın 3D render görüntüsüdür; kütüphanede, eşyalarda (ox_inventory bunu eşyanın görseli olarak gösterir) ve ağ kartlarında kullanılır.

Tasarlanabilir bileşenler — `Config.Components`

Stüdyonun tasarım yapabileceği on iki GTA kıyafet yuvası — baş, maske, saç, kollar, bacaklar, eldivenler, ayakkabılar, aksesuar, çantalar, yelek, çıkartmalar (decals) ve üstler — her biri kıyafetlerinin kullandığı dosya önekiyle birlikte yer alır. İstemciden değiştirilememesi için sunucu tarafında bulunur. Olduğu gibi bırakın.

İzinler

İzin	Nerede	Neye izin verir
`Config.OpenPermission` içindeki ACE (`mic_clothdesigner`)	`server.cfg` — bir gruba veya tek bir kimliğe	Stüdyoyu açma ve içindeki her işlem. Her seferinde sunucuda kontrol edilir
`resource.mic_cloth_designer` için `command.refresh`, `command.ensure`, `command.start`, `command.stop`	`server.cfg` üst kısmı	Stüdyonun dışa aktarma sonrasında `mic_cloth_addons` kaynağını yeniden yüklemesini sağlar
`mic_cloth_designer` kaynağından `mic_cloth_addons` kaynağına dosya sistemi yazma izni	`server.cfg` üst kısmı	Kıyafetleri kaydedebilmesini sağlar
`importaddons`	Sunucu konsolu	Kısıtlı komut: konsol veya bunun için ACE iznine sahip bir yönetici

Komutlar

Komut	Kim	Ne işe yarar
`/clothdesigner`	ACE iznine sahip oyuncular	Stüdyoyu açar. Adı `Config.Command` ile belirlenir
`importaddons`	Sunucu konsolu	`mic_cloth_addons/import/` içinde bekleyen `.ydd` dosyalarını tasarlanabilir kıyafetlere dönüştürür. Bkz. 👕 Kıyafetler

Diller

locales/ içinde on bir dil gelir: en, es, fr, de, it, pt, pl, ru, tr, nl, cs. Config.Locale ayarını yapın ve yeniden başlatın. Bir dilde eksik olan bir metin İngilizce olarak gösterilir.

Yeni bir dil eklemek için:

locales/en.lua dosyasını locales/<code>.lua olarak kopyalayın ve Locales['en'] kısmını kendi kodunuzla değiştirin.
Anahtarları (keys) asla değiştirmeyin, yalnızca değerleri (values) çevirin ve tüm %s ifadelerini koruyun.
Dosyayı fxmanifest.lua içindeki shared_scripts listesine locales/locale.lua’dan önce ekleyin — çözümleyicinin tüm dillerden sonra yüklenmesi gerekir. Ardından refresh yapın.
Config.Locale ayarını yeni koda ayarlayın.

Arayüz, İngilizce metinlerin sizinkilerle değiştirilmesiyle çevrilir; bu nedenle en.lua içindeki İngilizce değerlerin olduğu gibi kalması gerekir.

Köprü (Bridge)

Her iki köprü dosyası da escrow’ludur; ne bekleyeceğinizi bilmeniz için yaptıkları işlemler şunlardır:

Dosya	Ne içindir
`bridge/server_bridge.lua`	`qb-core` veya `es_extended`’ı algılar, kullanılabilir eşyaları kaydeder (ox_inventory’nin tanıdığı ESX `RegisterUsableItem` / QBCore `CreateUseableItem`) ve tasarımları eklenmiş olarak eşyaları verir — çalışıyorsa ox_inventory üzerinden, aksi halde framework üzerinden
`client/bridge.lua`	Bildirimler. Stüdyonun içinde kendi bildirim kutuları (toasts); dışında ise çalışıyorsa ox_lib notify, yoksa ESX veya QBCore, en son GTA bildirim akışı

Oyuncular, framework ne olursa olsun license: kimlikleriyle tanımlanır.