Paylaşım Silkroad Effect Viewer - Gelişmiş .EFP (Particle) Görüntüleyici

SroCave ailesine selamlar,

Silkroad Online geliştiricilerinin en çok zorlandığı alanlardan biri de oyun içerisindeki görsel efektleri (particle effects) düzenlemek ve oyuna girmeden test etmektir. Türk Silkroad Online topluluğunun ve geliştiricilerin değişmez buluşma noktası olan SroCave'de bugün, görsel efekt tasarımlarınızı ve incelemelerinizi bambaşka bir boyuta taşıyacak harika bir açık kaynaklı aracı sizlerle paylaşıyoruz.

Silkroad Effect Viewer Nedir?​

Silkroad Effect Viewer, Silkroad Online .efp partikül efektleri (JMXVEFF / EasyFX) için geliştirilmiş bağımsız (standalone) bir görüntüleme programıdır. Oyunun orijinal efekt dosyalarını yükler, efekt ağacını (effect tree) ayrıştırır ve oyun içi davranışlarla birebir eşleşecek şekilde (zaman/ömür hesaplamaları, izler, görünümler) renderlar.

Program, Dear ImGui arayüzüne sahip yerel (native) bir Windows / Direct3D 9 uygulaması olarak tasarlanmıştır. BMS geometrilerini, DDJ texture dosyalarını, efekt plakalarını ve meshleri kusursuz bir şekilde önizlemenize olanak tanır.

Not: Program dosyaları içerisinde oyun assetleri (.efp, .ddj, .bms, .pk2) bulunmamaktadır. Test edebilmek için oyun client'inizden çıkardığınız kendi dosyalarınızı kullanmanız gerekmektedir.

İndirme Bağlantısı (Kaynak Kodları)​

Bu değerli projenin GitHub reposuna erişmek için aşağıdaki bağlantıyı kullanabilirsiniz:

Sistem Gereksinimleri​

Bu projeyi bilgisayarınızda derleyebilmek için aşağıdaki araçlara sahip olmalısınız:

• İşletim Sistemi: Windows (Render motoru Direct3D 9 / d3dx9 kullanmaktadır)
• IDE: Visual Studio 2017, 2019, 2022 veya 2026 (C++ workload yüklenmiş herhangi bir sürüm)
• CMake: Sürüm 3.14 veya üzeri
• DirectX SDK (June 2010): d3d9.lib ve d3dx9.lib için gereklidir.(Kurulumdan sonra ortam değişkenlerine DXSDK_DIR yolunun eklendiğinden emin olun. Genelde yükleyici bunu otomatik yapar, yapmazsa CMake'e -DDXSDK_DIR=<path> olarak iletebilirsiniz.)

Kurulum ve Derleme Rehberi​

Dear ImGui projeye bir git submodule olarak eklendiğinden, repoyu indirirken --recurse-submodules komutunu kullanmanız şarttır.

Kaynak kodları çekmek için:


(Eğer normal şekilde clone yaptıysanız, submodulleri başlatmak için git submodule update --init --recursive komutunu kullanabilirsiniz. İleride güncellemek isterseniz git submodule update --remote kullanın.)

Derleme İşlemi (Building):Proje klasörünün ana dizininde bulunan Batch (.bat) dosyalarını kullanmak en kolay yöntemdir:

• Build.bat – Visual Studio kurulumunuzu tespit eder ve Build/ klasörüne solution dosyalarını oluşturur.
• Compile.bat – Build.bat dosyasını çalıştırır, ardından Debug/Release seçeneğini sorar ve projeyi derler.

Manuel CMake komutları kullanmak isterseniz:

Oluşturulan Çıktılar (Bin Klasörü)​

Derleme işlemi sonrasında programlar 32-bit (Win32) olarak Bin/ klasörüne çıkarılır:

• SilkroadEffectViewer: Ana GUI efekt görüntüleme uygulaması.
• efp_test: Yazılı .efp yükleyicisinin D3D olmadan çalışan konsol çapraz kontrol aracı.
• efp_shot: Ekran dışı (Offscreen) D3D9 render'larını PNG olarak çıkaran kanıt/test aracı.

Yasal Uyarı ve Teşekkür (Disclaimer & Credits)​

• Yasal Uyarı: Bu yazılım "olduğu gibi", yalnızca eğitim ve araştırma amacıyla sunulmuştur. Kullanımdan doğabilecek zararlardan, veri kayıplarından veya diğer sonuçlardan geliştirici sorumlu tutulamaz. Risk kullanıcının kendisine aittir.
• Geliştirici: ZAGORODNOV1337
• Özel Teşekkür: silkroadboss (Xoka)

SroCave forumlarında bu tarz Silkroad geliştirme araçlarının devamı için konuyu beğenmeyi ve düşüncelerinizi yorumlarda belirtmeyi unutmayın!