Bu bölümdeki teknik gereksinimler yalnızca Unreal Engine dosya formatıyla ilgilidir (.uproject ve .uplugin).

4.1 ÜRÜN SAYFASI BİLGİLERİ

4.1.1 Açıklama Metni

4.1.1.a Animasyonlu ürünler için yayıncıların Galeri bölümüne bir 3D model veya Uzun Açıklamaya animasyonları gösteren bir video bağlantısı eklemeleri gerekmektedir.
4.1.1.b Sesli ürünler için yayıncıların Uzun Açıklamaya bir ses ön izleme bağlantısı eklemeleri gerekmektedir.
4.1.1.c Blueprint tabanlı projeler için Yayıncıların Uzun Açıklamaya indirilebilir bir demo proje veya ürünlerin işlevselliğini gösteren bir video bağlantısı eklemeleri gerekmektedir.

4.2 DOSYALAR

4.2.1 Proje Dosyası

4.2.1.a Proje dosyası bir zip arşivi olarak yüklenmeli ve yalnızca bir Unreal Engine projesi içermelidir.

4.2.2 Desteklenen Motor Sürümleri

4.2.2.a Yayıncılar, ürünlerin Desteklenen Motor Sürümlerinde beyan edildiği gibi çalışmasını sağlamaktan sorumludur.
4.2.2.b İlk başvuru ve onayın ardından her ürün, Desteklenen Motor Sürümü olarak Unreal Engine'in en son sürümünü dahil eden bir Proje Sürümü içermelidir.
4.2.2.c Yayıncılar, yayınladıkları tüm ürünlerin en güncel üç motor sürümünden en az birini desteklediğinden emin olmalıdır.
4.2.2.d Kod Eklentisi ürünleri, tek farkları .uplugin tanımlayıcılarının "EngineVersion" anahtarında sadece farklı değere sahip olmaları olsa bile, her bir farklı Desteklenen Motor Sürümü için bir Proje Sürümü bulundurmalıdır ve her biri farklı tüm eklenti klasörlerini barındıran farklı Proje Dosyası Bağlantısı bulundurmalıdır.
4.2.2.e Yalnızca içerik bulunduran projelerin yeni bir motor sürümünü desteklemesini isteyen yayıncılar, bu motor sürümünü ürünün en son Proje Sürümüne ekleyebilir veya yeni bir Proje Sürümü eklemek için bir Dosya Güncellemesi yayınlanabilir.

4.2.3 Desteklenen Hedef Platformlar

4.2.3.a Yayıncılar, ürünlerin Desteklenen Hedef Platformlarda beyan edildiği gibi çalışmasını sağlamaktan sorumludur.

4.2.4 Dağıtım Yöntemi

4.2.4.a Bir müşterinin mevcut projesiyle birleştirilmesi ve kullanılması amaçlanan ürünler, bir Öğe Paketi Dağıtım Yöntemi sunmalıdır.
4.2.4.b Öğe Paketi Dağıtım Yöntemi olan ürünler Seviye Planları, zorunlu Yapılandırma (.ini) dosyaları veya diğer projelere kolayca eklenemeyen/taşınamayan diğer öğeleri içermemelidir.
4.2.4.c Müşterilerin kendi ürünlerini oluşturmak için temel olarak kullanabilecekleri bağımsız bir proje veya çerçeve olması amaçlanan ürünler, bir Tamamlanmış Proje Dağıtım Yöntemi sunmalıdır.

4.2.5 Üçüncü Taraf Yazılım Kullanımı

4.2.5.a Yayıncılar, ürünlerinin herhangi bir türde Üçüncü Taraf Yazılımı içerip içermediğini, kullanıp kullanmadığını, bunlara bağlı olup olmadığını veya bunları dağıtıp dağıtmadığını beyan etmelidir. Üçüncü Taraf Yazılım tabiri; yayıncı veya Epic Games dışındaki kaynaklardan gelen yazı tipleri, grafikler, sesler, API'ler, içerik, kaynak kodu veya derlenmiş kütüphaneler dâhil ancak bunlarla sınırlı olmamak üzere tüm dosyaları kapsamaktadır.
4.2.5.b "Bu Ürün Üçüncü Taraf Yazılım Kullanmaktadır" şeklinde bir Üçüncü Taraf Yazılım Kullanım beyanı bulunduran Kod Eklentileri, bu formda daha ayrıntılı bir beyan da bulundurmalıdır.

4.3 İÇERİK

4.3.1 Genel

4.3.1.a Tüm ürünler, başvurusu yapılan Ürün Türü için Unreal Engine İçerik Yönergeleri'nde belirtilen içerik gereksinimlerini karşılamalıdır.
4.3.1.b Tek bir üründe bulunan öğeler birbirlerine göre doğru şekilde ölçeklendirilmeli ve Z ekseni yukarı bakacak şekilde aynı yön vektörüne bakmalıdır.
4.3.1.c İlk başvuru ve onayın ardından Epic, ürünlerin en güncel ana motor sürümünde beyan edildiği şekilde çalıştığından emin olmak için ürünleri inceleyecektir.
4.3.1.d Deneysel veya beta aşamasında olan Unreal Engine özelliklerini ve eklentilerini içeren ürünler, ürünün açıklamasında bu durumu açıkça belirtmelidir. Bir Deneysel Eklenti kullanımdan kaldırılırsa gereksinim kaldırılmadığı sürece ürünler daha yeni motor sürümlerini destekleyemez.
4.3.1.e Yalnızca içerik bulunduran projelerin kullanılmayan eklenti gereksinimleri, .uproject tanımlayıcısında karşılık gelen "Etkin" anahtarları için False değerine sahip olmalıdır.
4.3.1.f Yalnızca içerik bulunduran projelerin gereksinimleri Fab aracılığıyla kullanılabilir olmalı ve ürünün açıklamasında açıkça belirtilmelidir.
4.3.1.g Epic Games'in kaynak kodunun, Planlarının ve/veya Materyal Planlarının büyük bölümleri kullanılacaksa yalnızca örnek amaçlı olarak kullanılmalıdır.
4.3.1.h Projelerin yönlendiricileri temizlenmiş olmalıdır.
4.3.1.i İçerik, Unreal Engine'in ikili derlemelerinde çalışmalıdır. Ürünler, Unreal Engine'in kaynaktan derlenmiş sürümlerini kullanan müşterilere ekstra işlevsellik sağlayabilir ancak müşterinin Unreal Engine'i kaynaktan derlemesine tamamen bağlı olmamalıdır.

4.3.2 Haritalar

4.3.2.a Unreal Engine'in 3D görüntü alanında gösterilecek öğeler veya işlevler bulunduran her bir projenin bunları gösteren bir haritası olmalıdır.
4.3.2.b Haritaların ışıklandırması yapılmış olmalıdır.
4.3.2.c Haritalar yüklendiğinde veya "Play-In-Editor" (Editör'de Oyna) başlangıcında hiçbir hata veya sonuçsal uyarı içermemelidir.
4.3.2.d Haritalarda "z-fighting" bozunumu veya makul olmayan şekilde üst üste binen poligonlar bulunmamalıdır.

4.3.3 Görsel

4.3.3.1 2D Öğeler

4.3.3.1.a Dokular en yüksek çözünürlükte veya kullanım amaçlarına uygun çözünürlükte sunulmalıdır. Bir öğe için birden fazla doku çözünürlüğü sağlanabilir.
4.3.3.1.b Dokunun mipmapping'in gerekli olmadığı bir sistem kullandığı durumlar dışında her bir dokunun iki boyutu da mümkün olduğu müddetçe 2'nin üssü olan bir boyuta sahip olmalıdır (örn. 1024x512 veya 1024x4096).
4.3.3.1.c Dokular her iki boyutta da en fazla 16348 uzunlukta olabilir.

4.3.3.2 3D Öğeler

4.3.3.2.a Öğelerinin modüler kullanımını tanıtan ürünler, kolay kurulum için pivot noktaları yerleştirilmiş örgüler bulundurmalıdır.
4.3.3.2.b Öğelerinin modüler kullanımını tanıtan ürünler, bir ızgara üzerinde temiz bir şekilde birbirine geçen örgüler bulundurmalıdır.
4.3.3.2.c Statik kafeslerde ışık haritaları için üst üste binen veya saran UV'ler olmamalıdır.
4.3.3.2.d Örgülerde maddi kusurlar, görünür dikişler veya ışık haritası sorunları olmamalıdır.
4.3.3.2.e Örgüler, mümkün olduğu sürece uygun çarpışma niteliklerine olmalıdır.
4.3.3.2.f Örgüler ayrıntı seviyelerini uygun şekilde kullanmalı ve ürün açıklamasında hangi ayrıntı seviyelerinin dahil edildiği belirtilmelidir (hiçbir ayrıntı seviyesi modeli dahil değilse bile).
4.3.3.2.g Statik örgüler, Parçacık Sistemleri tarafından referans alınmadıkları durumlar dışında 0 Işık Haritası Koordinat Endeksine sahip olmamalıdır.

4.3.3.3 Animasyonlar

4.3.3.3.a Animasyonlar temiz ve tutarlı olmalı, görsel olarak amaçlarına uygun şekilde çalışmalıdır.
4.3.3.3.b Epic veya MetaHuman iskeletine göre donatılmamış tüm iskelet örgüleri özel, bağıl olarak ölçeklendirilmiş bir iskelet ve onlarla birlikte dağıtılan animasyonlar veya tam bir Control Rig bulundurmalıdır.

4.3.3.4 Karakterler

4.3.3.4.a İskelet örgüleri Epic veya MetaHuman iskeletine göre ölçeklendirilmelidir, böylece yeni bir projeye aktarıldıklarında doğru şekilde ölçeklendirilirler.
4.3.3.4.b İskelet örgüleri, görsel kusurlar olmadan tüm eklemlerde beklenen hareket aralığına sahip olmalıdır.
4.3.3.4.c İnsansı iskelet örgüleri, Epic veya MetaHuman iskeletine göre modellenmelidir. Özel, bağıl ölçekli bir iskelet tercih edilirse gerekli tüm animasyonlar bununla birlikte dağıtılmalıdır.
4.3.3.4.d Epic veya MetaHuman iskeletine göre modellenen ürünler için aynı kemik adları kullanılmalı, ters kinematik eklemleri hiyerarşinin aynı yerinde ağırlıksız kalmalı ve eklem yönleri yeniden konumlandırılmamalıdır. İskelet ek kemikler veya herhangi bir değişiklik içeriyorsa bu durum belgelenmeli ürün sayfasında beyan edilmelidir.
4.3.3.4.e Fizik Öğeleri, mümkün olduğu durumlarda iskelet örgülerini uygun şekilde örtmelidir.
4.3.3.4.f Fizik Öğeleri, Physics Asset Editor'da (Fizik Öğesi Düzenleyicisi) simüle edildiğinde ürünün kullanım amacına uygun sonuçlar vermelidir.

4.3.3.5 Materyaller

4.3.3.5.a Ürünler mümkün olduğunca materyal örnekleri kullanmalıdır.
4.3.3.5.b Ürün Alt Tabaka Materyalleri içeriyorsa Alt Tabaka Materyalleri Proje Ayarları içinde etkinleştirilmelidir.

4.3.3.6 Görsel Efektler

4.3.3.6.a Görsel efektlerin birden fazla mesafeden görüntülenmesi amaçlanıyorsa farklı ayrıntı seviyeleri olmalıdır.
4.3.3.6.b Emitter adları doğru ve ürünle ilgili olmalı, belirli bir parçacık sistemindeki tek yayıcı olmadıkları sürece "Particle Emitter" gibi bir isim taşımamalıdır.
4.3.3.6.c Görsel efektler, (bağıl olarak ölçeklendirilmiş biçimde) kullanım amaçlarına göre optimize edilmelidir.

4.3.4 Ses

4.3.4.a Ses dosyaları, .wav dosyaları olarak motora aktarılmalıdır.
4.3.4.b Ses dosyaları istenmeyen herhangi bir aksama veya bozulma içermemeli ve mümkün olan en yüksek kalitede sağlanmalıdır.
4.3.4.c MetaSound, mantık yapısını düzenlemek için düzgün bir şekilde düzenlenmelidir.
4.3.4.d MetaSounds, örnek/eğitim amaçlı olarak yorumlanmadığı sürece gevşek düğümleri olmamalıdır.
4.3.4.e MetaSounds hata veya dolaylı uyarılar oluşturmamalıdır.
4.3.4.f MetaSounds kullanılıyorsa "Bu ürün, Unreal Engine 5.0+ için MetaSounds destekler" sorumluluk reddi beyanı ürün sayfasına eklenmelidir.
4.3.4.g MetaSounds kullanılıyorsa Öğe Paketleri, kullanıcıya MetaSounds'un nasıl etkinleştirileceğini bildiren belgelerin yanı sıra Unreal Engine MetaSounds belgelerinin bağlantısını içermelidir.

4.3.5 Blueprint'ler

4.3.5.a Blueprint'ler düzgün bir şekilde düzenlenmeli ve mantık yapısını düzenlemek için fonksiyonlardan makul bir şekilde yararlanılmalıdır.
4.3.5.b Fonksiyonlar, değişkenler ve olayların tümü, amaçlarını veya Blueprint içindeki kullanımlarını yansıtan isimler kullanmalıdır.
4.3.5.c Blueprint'lerde örnek olarak veya öğretici amaçlarla yorumlanmadıkları sürece bağımsız düğümler bulunmamalıdır.
4.3.5.d Blueprint'ler hiçbir hata veya dolaylı uyarı oluşturmamalıdır.

4.3.6 Kod Eklentileri

4.3.6.a .uplugin tanımlayıcılarında eklentinin yüklenmesi amaçlanan ana motor sürümünü (örn. 5.x.0) belirleyen bir "EngineVersion" anahtar değeri bulunmalıdır. Örneğin eklenti, Unreal Engine sürüm 5.3 için tasarlanmışsa:

"EngineVersion": "5.3.0",

4.3.6.b .uplugin tanımlayıcıları, her bir modülde bir "PlatformAllowList" veya "PlatformDenyList" değeri bulundurmalı ve böylece modülün derlenmesinin beklendiği uygun platformları örneğin şu şekilde belirtmelidir:

"PlatformAllowList": [ "Win64", "Win32", "Mac", "IOS", "Android" ]

Not: Unreal Engine 4 eklentileri için bunun yerine "WhitelistPlatforms" veya "BlacklistPlatforms" anahtarlarını kullanmanız gerekecektir.

4.3.6.c .uplugin tanımlayıcılarında müşteriler bağlı projeleri açmaya çalışırsa motorun eksik eklentileri indireceği Epic Games Başlatıcısı adresini belirleyen bir "FabURL" anahtarı bulunmalıdır. Ürün onay için gönderildikten sonra "FabURL" değeri, ürünün Yayıncı Portalı bağlantısının sonundaki kimliği içermelidir. Örneğin bir yayıncı, Kod Eklentisi ürününün https://publish.unrealengine.com/v2/edit-product/ad53b85f109c87b4a8bf580898186114 bağlantısını taşıdığını tespit ederse .uplugin'de şu anahtar ve değer bulunmalıdır: "FabURL": "com.epicgames.launcher://ue/Fab/product/ad53b85f109c87b4a8bf580898186114",
4.3.6.d Eklentiler, motorla birlikte dağıtılan Unreal Engine eklentilerini gerektirebilir ancak diğer kullanıcı yapımı Unreal Engine eklentilerini gerektirmemelidir.

4.3.6.1 Kod

4.3.6.1.a Yayıncının oluşturduğu ve derlemek için Unreal Engine kaynak kodu gerektiren herhangi bir kod dahil olmak üzere kod eklentileri "kapalı kaynak" olmamalıdır ve gerekli kodlar arşivlenmiş eklenti klasörüne dahil edilmelidir. Yalnızca harici olarak derlenmiş statik kütüphaneler veya DLL'ler ve herhangi bir Unreal Engine kaynak kodunu içermeyen veya referans vermeyen kodlar başvuru sırasında kabul edilebilir. Müşteriler, Unreal Engine kaynak kodunu gerektiren eklenti kaynak koduna sahip olmalıdır, böylece motorun kaynaktan inşa edilmiş sürümlerinden derlemeyi deneyebilirler.
4.3.6.1.b Tüm kaynak ve başlık dosyaları, yayıncının adını veya şirket adını ve yayınlanma yılını belirten açıklamalı bir telif hakkı bildirimi (otomatik olarak oluşturulan Epic Games metni değil) içermelidir.
4.3.6.1.c Eklentiler en az bir modül C++ kodu içermelidir ancak içerik de içerebilir.
4.3.6.1.d Eklentiler yeni editör işlevselliği sunmalı, UE'yi üçüncü taraf sistemlerle entegre etmeli veya karmaşık oyun mantığını planlara açmalıdır. Ek araçlarda (3D modelleme yazılımları, veritabanı yönetim sistemleri vb.) kullanılmak üzere bir eklentiyle birlikte ekstra komut dosyaları ve öğeler dağıtılabilse de, gönderimin çoğunluğu doğrudan Unreal Editor'da kullanılacak eklemeler veya değişiklikler sağlamalıdır.
4.3.6.1.e Eklentiler .exe veya .msi dosyalarını dağıtmamalıdır.

4.3.6.2 Derleme

4.3.6.2.a Kod eklentileri hiçbir hata veya dolaylı uyarı oluşturmamalıdır.
4.3.6.2.b Eklentiler, Epic'in derleme araç zinciri tarafından oluşturulan ikili dosyalarla birlikte dağıtılacaktır. Bu nedenle yayıncılar, yeni bir eklenti sürümü göndermeden önce derlemeyi test etmek için Editor'ın Eklentiler penceresinde "Package..." (Paket) seçeneğine tıklayarak son hata ayıklamanın tamamlandığından emin olmalıdır. Yayıncılar bu komutu, eklentilerini derlemek istedikleri her Unreal Engine sürümünün kurulu ikili derlemelerinden da çalıştırabilirler: Engine\Build\BatchFiles\RunUAT.bat BuildPlugin -Plugin=[.uplugin dosyasının yolu, motorla aynı klasörde olmamalı] -Package=[Kaydedileceği klasör] -Rocket
4.3.6.2.c 4.18'den sonraki motor sürümlerine göre oluşturulan eklentilerin IWYU uyumlu olması sağlanacaktır. Yayıncılar, IWYU'yu etkinleştirmek için eklentinin .build.cs dosyalarına şunları ekleyebilir: PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
4.3.6.2.d Epic, yayıncıların eklentilerini varsayılan olarak yalnızca en son üç ana motor sürümüne göre derler. Daha eski motor sürümleri için derlemeler istek üzerine yapılabilir.
4.3.6.2.e Kendi eklenti dizinlerindeki dosyaları içermesi gereken ve 4.20'den sonraki motor sürümlerine göre oluşturulan eklentiler, .build.cs dosyalarında ModuleDirectory niteliğini kullanarak bu gereksinimlerin dosya yollarını eklemelidir. .build.cs dosyasının en üstünde System.IO; kullanılıyorsa Yayıncılar şu sözdizimini kullanabilir (burada "MyFolder" dahil etmek istedikleri geçerli modülün altındaki dizinin adıdır): PublicIncludePaths.Add(Path.Combine(ModuleDirectory, "MyFolder"));

4.3.6.3 Örnek Projeler

4.3.6.3.a Satın alınan ve içe aktarılan tüm eklentiler bir proje eklentisi olarak değil, ("\Epic Games\EngineVersion\Engine\Plugins\Fab" dosya yoluna) bir motor eklentisi olarak yüklenecektir. Bu nedenle yayıncıların yeni müşterilere işlevselliğini göstermek için eklentiyle birlikte kullanılacak bir Örnek Proje oluşturmaları önemle tavsiye edilir.
4.3.6.3.b Kod Eklentileri için örnek projeler dağıtmayı tercih eden yayıncılar, Teknik Bilgilerine "Örnek Proje:" seçeneğinin yanına örnek projenin indirilebileceği bir siteye (Google Drive/Dropbox/OneDrive/vb. gibi) yönlendiren bir bağlantı eklemelidir.
4.3.6.3.c Örnek projeler, ürünlerin eklentilerini gerektiren .uproject tanımlayıcılarını bulundurmalıdır ancak müşteriler eklentileri doğrudan Fab'den kuracaklarından eklentilerin kendilerini içermemelidir.

4.3.7 Dosya Yapısı

4.3.7.1 Adlandırma Kuralları

4.3.7.1.a Klasörler ve dosyalar, kendi projeleri bağlamında doğru ve tutarlı adlandırma kurallarına sahip olmalıdır.
4.3.7.1.b Klasörler ve dosyalar "Assets", "NewFolder" gibi belirsiz şekillerde adlandırılmamalıdır.
4.3.7.1.c Klasör ve dosya adları yalnızca İngilizce karakterleri ve alt çizgileri içerebilir.

4.3.7.2 Yalnızca İçerik Bulunduran Projeler

4.3.7.2.a Proje klasörleri kullanılmayan klasörler, Eklenti klasörleri veya yerel klasörler (örneğin "Binaries", "Build", "Intermediate" veya "Saved") içermemelidir. Örneğin "MyProject" adındaki bir proje için şu dosya ve klasörler başvurudan önce arşivlenmelidir:

MyProject
|----- Config
|----- Content
| └── MyProject
|----- MyProject.uproject

4.3.7.2.b Proje dosyalarını içe aktardıktan sonra çakışmaları en aza indirmek için projeye özel olan tüm öğeler Content klasörünün altındaki tek bir ana klasörde saklanmalıdır; Contents klasörünün hemen altında başka hiçbir dosya veya klasör bulunmamalıdır.
4.3.7.2.c Contents klasörünün altındaki ana klasörün içinde bulunan öğeler, öğe türüne veya belirli öğe gruplarına göre sıralanmalıdır.
4.3.7.2.d Contents dosyasının altındaki ana klasörün adı dahil olmak üzere tüm öğe dosya yolları en fazla 140 karakter uzunluğunda olmalıdır.

4.3.7.3 Kod Eklentileri

4.3.7.3.a Eklenti klasörleri kullanılmayan klasörler veya yerel klasörler (Binaries, Build, Intermediate veya Saved gibi) içermemelidir, bu nedenle "MyPlugin" olarak adlandırılabilecek bir eklenti için başvurudan önce sıkıştırılacak dosya ve klasörler şunlardır:

4.3.7.3.b Content, Resources veya Source klasörlerinin (Docs klasörleri gibi) yanında dağıtım için tasarlanmış ana eklenti klasöründeki klasörler için, içinde "FilterPlugin.ini" bulunan bir Config klasörü olmalıdır. Bu dosya, şuna benzer bir şey içermelidir:

[FilterPlugin]
/Docs/...
/MyOtherFolder/...

4.3.7.3.c Source klasörünü ve .uplugin dosyasını içeren ana eklenti klasöründen başlayarak tüm dosya yolları 170 karakter veya daha kısa olmalıdır.
4.3.7.3.d Üçüncü taraf bağımlılıkları yalnızca izin belgesiyle kullanılabilir ve Source klasörünün içinde bulunan bir ThirdParty klasörüne yerleştirilmelidir.

4.3.8 Belgeler

4.3.8.a Nasıl kurulacağı veya kullanılacağı konusunda özel bilgi gerektiren ürünler, ilgili ürünlerin uygulanması, kullanılması ve/veya değiştirilmesini kapsayan ücretsiz belgeler içermeli, dağıtmalı veya müşterileri bunlara yönlendirmelidir. Buna kullanıcılara bir ürünün dosyaları aracılığıyla doğrudan yeniden dağıtılamayan gerekli üçüncü taraf yazılımların nasıl indirileceği, kurulacağı ve/veya entegre edileceği konusunda talimat vermek de dahildir.
4.3.8.b Belgeler internet tabanlı kılavuzlar, .txt/.pdf dosyaları, kod/plan yorumları, videolar veya editör içi öğretici plan öğeleri şeklinde sunulmalıdır.
4.3.8.c Belgeler İngilizce olmalıdır fakat yayıncılar belgelerinin tercüme edilmiş sürümlerini de ekleyebilirler.
4.3.8.d Sağlanan indirme bağlantıları indirmeyi otomatik olarak başlatmamalıdır.