Kurulum

Yaklaşık beş dakika sürer ve sonunda tam bir sunucu yeniden başlatması gerekir. İnsanların hata yaptığı tek adım server.cfg içindeki satırların sırasıdır — 3. adımı iki kez okuyun.

Başlamadan önce

İhtiyacınız olanlar	Neden
oxmysql, çalışır durumda	Tasarımlar, eşyalar ve kombinler veritabanında saklanır
ox_lib	Stüdyonun callback’leri ve bildirimleri için
ESX, QBCore veya QBox (isteğe bağlı)	Sadece giyilebilir eşyalar için. Bunlar olmadan stüdyo standalone çalışır
ox_inventory (isteğe bağlı)	Çalışıyorsa eşyalar için öncelikli olarak tercih edilir
Gemini API anahtarı (isteğe bağlı)	Sadece yapay zeka oluşturucusu için — aistudio.google.com/apikey adresinde ücretsiz
Fivemanage token’ı (isteğe bağlı)	Tasarım ve eşya fotoğraflarını barındırır — fivemanage.com adresinde ücretsiz

1. Her iki klasörü de yerine yerleştirin

Paket iki kaynak (resource) içerir. İkisini de yan yana resources klasörünüze bırakın — örneğin resources/[mic]/mic_cloth_designer ve resources/[mic]/mic_cloth_addons.

2. Veritabanı — yapılacak bir şey yok

Tablolar ilk başlatmada kendiliğinden oluşturulur: tasarımlar için mic_cloth_designs ve mic_cloth_imported, eşyalar ve kombinler için mic_cloth_items.

İlk iki tabloyu elle oluşturmayı tercih edenler için mic_cloth_designs.sql dosyası mic_cloth_designer kök dizininde yer alır. Buna ihtiyacınız yoktur.

3. server.cfg — sıralama önemlidir

İki farklı yerde, iki ayrı satır grubu.

server.cfg dosyasının üst kısımlarında, tüm ensure satırlarının üzerinde:

mic_cloth_designer kaynağına command.refresh, command.ensure, command.start ve command.stop ACE izinlerini verin (dört adet add_ace resource.mic_cloth_designer … allow satırı) — siz bir kıyafeti dışa aktardıktan sonra stüdyo mic_cloth_addons kaynağını kendi kendine yeniden başlatır;
mic_cloth_designer kaynağının mic_cloth_addons içine yazmasına izin veren dosya sistemi iznini ekleyin (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
stüdyoyu kullanacak kişilere mic_clothdesigner ACE iznini verin — örneğin group.admin grubuna veya tek bir kişinin identifier.discord:… kimliğine.

Daha aşağıda, diğer kaynaklarınızla birlikte: önce ensure oxmysql, ardından ox_lib, sonra mic_cloth_addons ve en son mic_cloth_designer. Yukarıdaki izin bloğundan sonra geldiği sürece her ikisini de kapsayan bir ensure [mic] de çalışır.

Sadece denemek mi istiyorsunuz? shared/config.lua içinde Config.OpenPermission = false yapın, böylece herkes stüdyoyu açabilir — yazma izni yine de gereklidir.

4. Anahtarlarınız

mic_cloth_designer/shared/keys.lua dosyasını açın. Bu yalnızca sunucu tarafında çalışan bir dosyadır: içindeki hiçbir şey oyunculara gönderilmez. Kullandıklarınızı doldurun ve geri kalanları boş tırnak olarak bırakın.

Anahtar	Ne işe yarar	Gerekli mi
`GeminiAPIKey`	Yapay zeka doku oluşturucusu	Sadece YZ için. Boş = YZ aracı kapalıdır
`FivemanageToken`	Tasarım ve eşya fotoğraflarını barındırır	Önerilir. Boş = fotoğraflar veritabanında tutulur
`DiscordWebhook`	Her YZ üretimini tahmini maliyetiyle birlikte kaydeder	İsteğe bağlı
`ClothNetworkKey`	Boş bırakın. Cloth Network onsuz da çalışır	Hayır

5. Eşyalar

Tek bir genel eşya tüm tasarımları taşır: cloth_design (adı shared/config.lua içinde Config.Items.Name olarak geçer).

Eşya	Ne işe yarar
`cloth_design`	Üzerinde kayıtlı olan tasarımı giydirir; üzerinizdekileri geri giymek için tekrar kullanın

Tanımlamalar mic_cloth_designer/items/ içinde gelir:

Dosya	Hangi envanter için
`items/ox.lua`	ox_inventory — `ox_inventory/data/items.lua` içine eklenir
`items/qb.lua`	QBCore — `qb-core/shared/items.lua` içine eklenir

Bunun için hazır bir görsel gelmez: ox_inventory üzerinde her eşya kendi tasarımının render görselini gösterir. QBCore üzerinde varsayılan bir simge istiyorsanız qb-inventory/html/images/ içine bir cloth_design.png koyun. ox_inventory olmayan ESX üzerinde ise diğer eşyaları eklediğiniz gibi cloth_design adında bir eşya ekleyin.

Mağazalarda sattığınız tasarımlar daha sonra kendi eşya adlarını alır — bkz. 🎒 Eşyalar.

6. Framework

Değiştirilecek ekstra bir ayar yoktur. Eşya köprüsü (bridge) qb-core veya es_extended’ı kendisi bulur ve çalışıyorsa ox_inventory’yi kullanır. Sunucunuza uyması için shared/config.lua içindeki Config.Framework ayarını 'qb' veya 'esx' olarak ayarlayın.

QBox üzerinde köprü, QBCore uyumluluğu sayesinde sistemi algılar — qbx_core, qb-core sağlar — ve Config.Framework 'qb' olarak kalır: QBox, QBCore kaynaklarını uyumluluk katmanı üzerinden çalıştırır.

Standalone modu da çalışır. Framework olmadan stüdyo, 3D önizleme, YZ oluşturucu ve Cloth Network her zamanki gibi çalışır; açmak için yalnızca ACE izni gerekir. Config.Framework ayarını 'qb' olarak bırakın. Giyilebilir eşyalar ESX, QBCore veya QBox gerektiren tek kısımdır.

7. Tam yeniden başlatma ve ilk tasarım

Sadece kaynağı değil, tüm sunucuyu yeniden başlatın: GTA, kıyafet verilerini sunucu açılırken okur.

Oyunda /clothdesigner yazın.
Kütüphaneden (Library) bir kıyafet seçin, bir şeyler boyayın ve Save düğmesine basın.

Her şeyin çalıştığını şuradan anlayabilirsiniz: Stüdyo Kütüphane, 3D önizleme ve düzenleyici yan yana olacak şekilde açılır, Save düğmesi Saved yanıtını verir ve karakteriniz üzerinde tasarımınızın olduğu kıyafeti giyer.

Daha sonra tekrar giymek için onu bir eşyaya dönüştürün — bkz. 🎒 Eşyalar.

Şehrinizi oyunculara açmadan önce

shared/config.lua içinde Config.Debug ayarını kapatın. Varsayılan olarak açık gelir ve her adımı konsola yazdırır.
Config.GlobalContent ayarına karar verin. Açık olduğunda (varsayılan), stüdyoya girme izni olan herkes tüm tasarımları, eşyaları ve kombinleri görür ve düzenler.
shared/keys.lua dosyasını gizli tutun. Gemini anahtarınızı, Fivemanage token’ınızı ve webhook’unuzu barındırır. Dosyalarınızı birine vermeden önce içini boşaltın.
mic_clothdesigner iznine kimlerin sahip olduğunu kontrol edin. Bir Gemini anahtarı ayarlandığında, yapılan her YZ üretimi size faturalandırılır.