UGC doğrulama sistemi | Dokümantasyon - Roblox Yaratıcı Merkezi

UGC doğrulama sistemi, avatar varlıklarının Marketplace'e yüklenip yayımlanmadan önce platform gereksinimlerini karşılayıp karşılamadığını kontrol eden Roblox'un teknik mekanizmasıdır. Bu süreç, avatar gövdeleri, kozmetikler, giysiler ve aksesuarların platformda tutarlı bir şekilde davranmasını sağlar.

UGC doğrulama sistemi her seferinde çalışır:

Studio aracılığıyla Marketplace'e bir avatar varlığı yüklemeye çalıştığınızda.
Deneyim içinde avatar varlık oluşturma için AvatarCreationService API'lerini çağırdığınızda.

Bu süreçte, UGC doğrulama sistemi varlığınızı kontrol edip türüne özgü doğrulama kategorilerinde gereksinimleri karşılayıp karşılamadığını inceler. Bu gereksinimlerin kapsamlı bir listesini görmek için Gövde spesifikasyonları, Dinamik baş spesifikasyonları, Makyaj spesifikasyonları, Rijit aksesuar spesifikasyonları ve Katmanlı aksesuar spesifikasyonları sayfalarına bakın.

Bir avatar varlığı doğrulamayı geçtiğinde, yükleme ücreti ödeyerek yükleme sürecine devam edebilir, varlığı moderasyona sunabilir ve Marketplace'te satışa çıkarabilirsiniz veya oyuncu, deneyim içinde oluşturduğu avatar varlığını satın almaya devam edebilir.

Bir avatar varlığı doğrulamayı geçmediğinde, siz veya oyuncu, niçin doğrulamayı geçemediğine dair bilgi veren hata mesajları alırsınız. Sorun gidermede yardımcı olmak için, UGC doğrulama görselleştirme araçları ile varlıkları düzeltmek veya iyileştirmek için varlığa özgü görsel rehberler sağlayan kontroller içerir.

Marketplace için kullanmayı planlamadığınız varlıklar, yalnızca oyun içi kullanım için olanlar, doğrulama sürecini geçmek zorunda değildir. Yine de, doğrulama süreci, özel gövdeler ve aksesuarlar için sorun gidermede ve hata ayıklamada faydalı olabilir.

Doğrulama kategorileri

UGC doğrulama sistemi doğrulamayı birkaç yüksek düzey kategorisine organize eder. Bu kategoriler ve doğruladıkları alanlar hakkında bilgi almak için aşağıdaki tabloyu inceleyin.

Kategori	Ne doğrular
Şematik	Varlığın nesne hiyerarşisi Alt türler, etiketler ve özelliklerin doğru yapılandırılıp yapılandırılmadığı Varlığın yasaklı scriptler içerip içermediği
Ağ geometri	Üçgen bütçeleri Sınır kutusu boyutları Toplam yüzey alanı sınırları Varlığın merkezinin orijinde olup olmadığı ve herhangi bir eksen boyunca çok ince olup olmadığı Varlığın geometrisinin su geçirmez olup olmadığı ve N-köşeler, tepe renkleri veya sıfır alan üçgenleri içerip içermediği
Doku / malzemeler	Maksimum çözünürlük Geçerli UV haritaları SurfaceAppearance nesneleri için PBR doku doğrulama Varlığın geçersiz tepe renkleri içerip içermediği
Rigging / Skinning	Gövdeler ve katmanlı aksesuarlar skinning verisi içermelidir Rijit aksesuarlar skinning verisi içermemelidir Skin ağırlık sayısı tepe sayısı ile eşleşmelidir
İç ve dış kafes	Tüm gövde parçaları tam gövde doğrulama için kafesler içermelidir Kafesler su geçirmez olmalıdır Kafes ağı mesh'ine yakın olmalıdır Render mesh dış kafesin içinde olmalıdır Kafes UV’leri Roblox tarafından sağlanan kafes şablonları ile eşleşmelidir
Ekler	Tüm eklerin ekleme noktası için doğru adlandırmaya sahip olması gerekir Konum ve oryantasyon kontrolleri
Dinamik baş	En az 17 FACS pozları Kafes kilit noktası baş mesh'ine projekte edilmelidir Yüz animasyon tespiti: kilit noktalar göz kırpma, ağız açma ve mutlu/ üzgün yüz ifadeleri için hareket etmelidir
Güvenlik / moderasyon	Varlık yaratıcı doğrulaması, yasaklı sınıf adları, proxy attribute anti-spoofing

Görselleştirme kontrolleri

UGC doğrulama sistemi, henüz Marketplace'e hazır olmayan avatar varlıklarını tanımlamanıza, anlamanıza, teşhis etmenize ve düzeltmenize yardımcı olmak için, isteğe bağlı görselleştirme araçları içerir. Aktifken, görselleştirme kontrolleri, uyumsuz varlıklar için doğrulama hataları ve uyumlu varlıkların iyileştirilebilecek kalite değerlendirmeleri hakkında bilgi sağlar.

Kırmızı simgeler, hangi alanların doğrulama için başarısız olduğunu gösterir ve sarı uyarılar, iyileştirme alanlarını belirtir.

Bir hata veya uyarıyı seçtiğinizde, görsel unsurlar görüntü alanında hatayı veya uyarıyı anlamaya yardımcı olmak için görüntülenir.

UGC doğrulama sisteminin görselleştirme araçlarına erişmek için önce beta özelliğini etkinleştirmeniz gerekir. Seçenekli görselleştirme kontrollerini etkinleştirmek ve kullanmak için:

Studio'da Dosya > Beta Özellikleri'ne gidin.
UGC Doğrulamasını Görselleştirin seçeneğini etkinleştirin.
Studio'yu yeniden başlatın, sonra mezzaninde, özel bir sekme eklemek için artı simgesine tıklayın. Yeni bir sekme görüntülenir.
Özel sekmenizde, Araç Ekle butonuna tıklayın. Araç Ekle pop-up penceresi görüntülenir.
Araç çubuğunuza eklemek için UGC Doğrulamasını etkinleştirin, ardından pencereyi kapatın.
Özel sekmenize geri dönün ve UGC Doğrulaması butonunu seçerek eklentiyi çalıştırın. UGC Doğrulama penceresi görüntülenecektir.
Keşfetici penceresinde bir karakter gövdesini, dinamik başı, rijit aksesuarı veya katmanlı aksesuarı seçin, sonra UGC Doğrulama penceresine geri dönün ve Doğrulamayı Çalıştır butonuna tıklayın. Bir pop-up pencere görüntülenecektir.
Pop-up penceresinde:
1. Seçtiğiniz avatar varlığının türünü onaylayın. Örneğin, eğer Enum.AccessoryType.Pants katmanlı aksesuarı seçtiyseniz, açılır menüyü kullanarak PantsAccessory'yi seçin.
2. Doğrulamayı Çalıştır butonuna tıklayın.

Doğrulama servisi arka planda çalışacak ve varlığınızın durumuna bağlı olarak UGC Doğrulama penceresinde hata ve/veya uyarılar olarak sonuçları bildirecektir. Her görsel doğrulama kontrolü hakkında bilgi için aşağıdaki alt bölümleri inceleyin.

Measure_Cage_Distance_Head

Measure_Cage_Distance_Head, avatar başının dış kafesinin baş mesh'ini ne kadar sıkı sardığını skorlama doğrulama kontrolüdür; kafesin ne çok mesh'le dışarıda yüzdüğünü ne de içeriye girdiğini kontrol eder.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Baş kafesi baş mesh'i ile kesişiyor. {negativeSDFPercent}% baş kafesi tepe noktası baş mesh'in içindedir.	Doğrulamayı engeller
Baş kafesi baş mesh'indan çok uzakta. Baş kafesi ve mesh arasındaki maksimum mesafe {max_sdf}, bu ise izin verilen eşik olan {max_sdf_threshold}'dan fazladır	Doğrulamayı engeller
Varlık kalite uyarısı: Baş kafesi mesafe skoru {score}. Baş kafesi ve mesh arasındaki maksimum mesafe {max_distance}, {negative_sdf_percent}% baş kafesi tepe noktası baş mesh'in içindedir.	Uyarı

Measure_Cage_Mesh_Distance

Measure_Cage_Mesh_Distance, katmanlı giysinin dış kafesinin render mesh'ini ne kadar sıkı takip ettiğini skorlama doğrulama kontrolüdür; bir kafes çok uzakta ya da mesh'in içine itildiğinde belirler.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Dış kafes, render mesh'i ile kesişiyor. {negativeSDFPercent}% dış kafes tepe noktası render mesh'in içindedir.	Doğrulamayı engeller
Dış kafes render mesh'ten çok uzakta. Dış kafes ve mesh arasındaki maksimum mesafe {max_sdf}, bu ise izin verilen eşik olan {max_sdf_threshold}'den fazladır.	Doğrulamayı engeller
Varlık kalite uyarısı: Kafes ile mesh arasındaki mesafe skoru {score}. Dış kafes ve mesh arasındaki maksimum mesafe {max_distance}, {negative_sdf_percent}% dış kafes tepe noktası render mesh'in içindedir.	Uyarı

Measure_Cage_Mesh_Distance_Avatar

Measure_Cage_Mesh_Distance_Avatar, tam gövde dış kafesinin beden mesh'ini ne kadar iyi takip ettiğini skorlama doğrulama kontrolüdür; bir kafes çok uzakta yüzdüğünde veya bununla kesiştiğinde belirler.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Gövde kafesi gövde mesh'i ile kesişiyor. {negativeSDFPercent}% gövde kafesi tepe noktası gövde mesh'in içindedir.	Doğrulamayı engeller
Gövde kafesi gövde mesh'indan çok uzakta. Gövde kafesi ve mesh arasındaki maksimum mesafe {max_sdf}, bu ise izin verilen eşik olan {max_sdf_threshold}'den fazladır.	Doğrulamayı engeller
Varlık kalite uyarısı: Gövde kafesi mesafe skoru {score}. Gövde kafesi ve mesh arasındaki maksimum mesafe {max_distance}, {negative_sdf_percent}% gövde kafesi tepe noktası gövde mesh'in içindedir.	Uyarı

Measure_Cage_Relevancy

Measure_Cage_Relevancy, dış kafesin ne kadarının gerçekten aksesuarın üzerinde olduğunu, böylece kafes düzenlemelerinin giysinin ihtiyaç duyduğu yerlerde kalmasını skorlama doğrulama kontrolüdür.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
{outer_cage_face_irrelevant_percent}% değiştirilmiş dış kafes tepe noktası aksesuarı kaplamamaktadır. Lütfen dış kafesi sadece gerekli yerlerde taşımaya dikkat edin.	Doğrulamayı engeller
Varlık kalite uyarısı: Kafes alaka skoru {score}. {irrelevant_percent}% değiştirilmiş dış kafes tepe noktası aksesuarı kaplamamaktadır.	Uyarı

Measure_Cage_UV

Measure_Cage_UV, iç ve dış kafes UV'lerinin katmanlı giysi şablonuyla eşleşip eşleşmediğini kontrol eden bir doğrulama kontrolüdür; katmanlı giysi şablonuyla eşleşmeyen UV'ler varlığın bedene nasıl sarıldığını bozabilir.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Kafes {cage_name} içinde {incorrect_uv_count} yanlış UV değeri bulunmaktadır ve bu değerler şablona ait değildir. Lütfen kafes UV'sini düzeltin.	Doğrulamayı engeller
Varlık kalite uyarısı: Kafes UV skoru {score} için {cage_name}. Yanlış UV sayısı: {incorrect_uv_count}.	Uyarı

Measure_Cage_UV_Avatar

Measure_Cage_UV_Avatar, her gövde parçasının UV'lerini standart şablon üzerinde tutan bir kafes içermesini kontrol eden bir doğrulama kontrolüdür; yanlış kafes UV'leri katmanlı giysinin bedene nasıl sarıldığını bozar.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Kafes {cage_name} içinde {incorrect_uv_count} yanlış UV değeri bulunmaktadır ve bu değerler şablona ait değildir. Lütfen kafes UV'sini düzeltin.	Doğrulamayı engeller
Varlık kalite uyarısı: Kafes UV skoru {score} için {cage_name}. Yanlış UV sayısı: {incorrect_uv_count}.	Uyarı

Measure_Degen_Triangles

Measure_Degen_Triangles, her mesh parçasındaki dejenere üçgenleri (sıfır veya sıfıra yakın alanı olan yüzeyler) skorlama doğrulama kontrolüdür; dejenere üçgenler yüzey eklemez ve render işlemini bozabilir.

Hata kodu	Ciddiyet
Varlık kalitesi: {partName} {degenerate_triangle_percent}% dejenere üçgen içermektedir (skor: {score}).	Uyarı
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı

Measure_Dynamic_Head

Measure_Dynamic_Head, bir dinamik başın animasyon yapılabilir olup olmadığını doğrulayan bir doğrulama kontrolüdür. Animasyon yapılabilir dinamik başların bir baş kafesi, FACS verileri, hizalı kilit noktaları vardır ve gözlerini kapatabilir, ağzını açabilir ve duyguları ifade edebilirler.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
Marketplace'teki dinamik başlar doğru kafesleme ile olmalıdır, böylece kafes üzerindeki göz ve ağız tepe noktaları mesh tepe noktalarıyla hizalanmalıdır. Lütfen kafesinizi ve mesh ile hizalamasını iyileştirin.	Doğrulamayı engeller
Dinamik baş için gülümseme ifadesi tespit edilemiyor. Lütfen kafes kilit noktalarını ağzın nerede olduğunu uyumlu hale getirin ve gülümseme ifadesini gösterebildiğinden emin olun.	Doğrulamayı engeller
Dinamik baş için sol göz kapama ifadesi tespit edilemiyor. Lütfen kafes kilit noktalarını sol gözün nerede olduğunu uyumlu hale getirin ve kapatılabildiğinden emin olun.	Doğrulamayı engeller
Marketplace'teki dinamik başların kafesi yoktur. Lütfen dinamik baş için bir kafes oluşturun.	Doğrulamayı engeller
Dinamik baş için ağız açma ifadesi tespit edilemiyor. Lütfen kafes kilit noktalarını ağzın nerede olduğunu uyumlu hale getirin ve açılabildiğinden emin olun.	Doğrulamayı engeller
Marketplace'teki dinamik başların animasyonlu olması gerekir, ancak bu başın FACS verisi yoktur.	Doğrulamayı engeller
Dinamik baş için sağ göz kapama ifadesi tespit edilemiyor. Lütfen kafes kilit noktalarını sağ gözün nerede olduğunu uyumlu hale getirin ve kapatılabildiğinden emin olun.	Doğrulamayı engeller
Dinamik baş için kaş çatma ifadesi tespit edilemiyor. Lütfen kafes kilit noktalarını ağzın nerede olduğunu uyumlu hale getirin ve kaş çatma ifadesini gösterebildiğinden emin olun.	Doğrulamayı engeller
Varlık kalite uyarısı: dinamik baş ifadesi skoru {score}.	Uyarı

Measure_Joint_Number

Measure_Joint_Number, gövde rig'inin eklem ayarını beklenen yapılandırmaya göre skorlama doğrulama kontrolüdür. Gövde rig'inin eklem ayarı, yüksek-fidelite rig'leri için sol ve sağ ellerdeki eklem sayılarını içerir.

Hata kodu	Ciddiyet
Varlık kalitesi: eklem yapılandırması {score} (eklemler: {joint_number}, sol el: {left_hand_joint_number}, sağ el: {right_hand_joint_number}) olarak puanlanmıştır.	Uyarı
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı

Measure_Mesh_Manifold

Measure_Mesh_Manifold, her mesh parçasının manifold bütünlüğünü skorlama doğrulama kontrolüdür; delikleri, manifold olmayan kenarları ve benzeri topolojik problemleri yakalar.

Hata kodu	Ciddiyet
Varlık kalitesi: {partName} manifold problemleri bulunmaktadır (skor: {score}).	Uyarı
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı

Measure_Mesh_Outside_OuterCage

Measure_Mesh_Outside_OuterCage, bir aksesuarın render mesh'inin ne kadarının kafesleri arasında kaldığını skorlama doğrulama kontrolüdür; dış kafesin dışına çıkan bir mesh giyildiğinde kötü bir şekilde şekil bozar.

Hata kodu	Ciddiyet
Kalite skoru, girdi verilerinin yanlış veya eksik olmasından dolayı düzgün bir şekilde hesaplanamadı. Lütfen modelinizi kontrol edin veya bir hata raporu oluşturun.	Doğrulamayı engeller
{mesh_outside_outer_cage_percent}% aksesuar mesh'inin tepe noktaları dış kafesinin dışındadır. Lütfen aksesuarın daha fazla kısmını kafesler arasında yerleştirin.	Doğrulamayı engeller
Varlık kalite uyarısı: Mesh kapsama skoru {score}. {mesh_outside_outer_cage_percent}% mesh tepe noktası dış kafesinin dışındadır.	Uyarı

Measure_Texture_Complexity

Measure_Texture_Complexity, her dokunun görsel karmaşıklığını skorlama doğrulama kontrolüdür; varlığa az detay ekleyen düz veya neredeyse boş dokuları işaretler.

Hata kodu	Ciddiyet
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı
Varlık kalitesi: doku {textureName} düşük karmaşıklığa sahip (skor: {score}).	Uyarı

Measure_Texture_Resolution

Measure_Texture_Resolution, her dokuyu piksel boyutlarına göre değerlendiren bir doğrulama kontrolüdür; varlığı bedende net tutacak kadar yüksek çözünürlüğü ödüllendirir.

Hata kodu	Ciddiyet
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı
Varlık kalitesi: doku {textureName} boyutu {texture_width}x{texture_height} (skor: {score}).	Uyarı

Measure_Triangle_Intersection

Measure_Triangle_Intersection, her mesh parçasındaki kendi kendine kesişen üçgenleri skorlama doğrulama kontrolüdür; yüzeyler birbirinin içinden geçerek karmaşık, üst üste binen geometri oluşturur.

Hata kodu	Ciddiyet
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı
Varlık kalitesi: {partName} {intersecting_tri_face_percent}% kesişen üçgen yüzeyi içermektedir (skor: {score}).	Uyarı

Measure_UV_Bound

Measure_UV_Bound, bir mesh'in UV tepe noktalarının ne kadarının 0-1 doku alanının dışında kaldığını ölçen bir doğrulama kontrolüdür; bir puan bildirir ama yüklemeyi asla engellemez.

Hata kodu	Ciddiyet
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı
Varlık kalitesi: {partName} {uv_outside_bound_vert_percent}% UV tepe noktası sınırların dışında (skor: {score}).	Uyarı

Measure_Vertex_Similarity

Measure_Vertex_Similarity, bir mesh'teki neredeyse tekrar eden tepe noktalarını ölçecek bir doğrulama kontrolüdür; bir puan bildirir ama yüklemeyi asla engellemez.

Hata kodu	Ciddiyet
Varlık kalite skoru {measureName} için hesaplanamadı çünkü girdi verileri eksik veya geçersizdi. Bu, yüklemenizi engellemez.	Uyarı
Varlık kalitesi: {partName} {similar_vertex_percent}% benzer tepe noktasına sahiptir (skor: {score}).	Uyarı