Paylaşım SRO Archive Explorer - Gelişmiş PK2 Editör, 3D Model, Harita ve Efekt Görüntüleyici

Türk Silkroad Online topluluğunun buluşma noktası olan SroCave'de, Silkroad geliştiricileri ve araştırmacıları için en güncel, yenilikçi ve kaliteli içerikleri sunmaya devam ediyoruz. Piyasada zor bulunan bu tarz benzersiz araçlara, rehberlere ve kaynaklara her zaman SroCave ayrıcalığıyla ulaşabilirsiniz. Bugün, Silkroad client dosyalarını inceleme ve düzenleme sürecini tamamen değiştirecek harika bir aracı sizlerle paylaşıyorum.

SRO Archive Explorer Nedir?​

SRO Archive Explorer, Silkroad Online istemci (client) arşivleri için geliştirilmiş, harici komut satırı (CMD) araçlarına ihtiyaç bırakmayan kapsamlı bir masaüstü PK2 tarayıcısı, görüntüleyicisi ve tersine mühendislik (reverse-engineering) aracıdır.

Oyunun orijinal veri dosyalarını dışa aktarmadan önce içeriklerini görüntüleyebilir; 3D modelleri, haritaları, dungeonları, dokuları (texture), UI dosyalarını, metin tablolarını ve partikül efektlerini doğrudan program üzerinden inceleyebilirsiniz. Geliştirme ve asset araştırma süreçlerinizi inanılmaz derecede hızlandıracaktır.

Önemli Not: Bu proje şu anda aktif geliştirme aşamasındadır. Çoğu özellik kusursuz çalışsa da bazı bölümlerde ufak tefek eksikler olabilir. İlgilenen geliştirici arkadaşlarımız GitLab üzerinden hata bildiriminde bulunabilir veya projeye katkı (PR) sağlayabilirler.

Öne Çıkan Özellikler​

• Doğrudan PK2 Erişimi: PK2 arşivlerini anında açın, içerik ağacında gezinin, dosya arayın ve dosya türüne göre filtreleme yapın.
• Tam Kapsamlı Düzenleme: Dosya, klasör veya tüm arşivi dışa aktarın (extract). Mevcut arşive yeni dosyalar ekleyin veya klasörlerden sıfırdan yepyeni PK2 arşivleri oluşturun.
• Canlı Kod/Metin Düzenleme: Düzenlenebilir metin veya kod dosyalarını doğrudan program içinde değiştirip kaydedin. (UTF-8, UTF-16, EUC-KR, GBK, Big5 destekli)
• Gelişmiş Görüntüleme Sistemi:
  • Modeller & Efektler: BSR/BMS 3D modelleri materyalleri ve animasyonlarıyla görüntüleyin. EFP partikül efektlerini 3D oynatın ve zaman çizelgelerini inceleyin.
  • Harita & Zindanlar: DOF zindan sahnelerini (objeler, ışıklar, efektler) ve bölgesel haritaları (.m) tüm detaylarıyla keşfedin.
  • Yetenek Ağaçları (Skill Trees): Çin ve Avrupa karakter yetenek ağaçlarını ikonları, seviyeleri, efektleri ve animasyon bağlantılarıyla birlikte listeleyin.
  • Görseller: DDS ve DDJ texture dosyalarını alfa/arka plan kontrolleriyle açın.

Desteklenen Dosya Formatları​

• Dokular (Textures): DDS, DDJ, PNG, JPG, BMP, GIF, WEBP
• Ses Dosyaları: OGG, OGA, WAV
• 3D Modeller: BSR, BMS, CPD (Compound)
• Partiküller ve Haritalar: EFP (Efekt), .m (Bölge haritaları), DOF (Zindan)
• Arayüz (UI) ve Animasyon: 2DT, BAN, BSK
• Veri ve Metin: BMT, TXT, INI, CFG, DAT

İndirme ve Önizleme Bağlantıları​

Bu değerli araca ait GitLab kaynak kodlarını indirmek veya hiçbir kurulum yapmadan doğrudan tarayıcınız üzerinden (Online Version) kullanmak için aşağıdaki bağlantıları kullanabilirsiniz.

Kurulum ve Kullanım (Geliştiriciler İçin)​

Projeyi kendi bilgisayarında derlemek ve çalıştırmak isteyenler için Node.js gereklidir. Terminal veya CMD üzerinden aşağıdaki komutları sırasıyla girerek aracı çalıştırabilirsiniz:



Veya yukarıda verilen Web Versiyonu linkine tıklayarak hiçbir şey kurmadan direkt tarayıcınızdan PK2 dosyalarınızı seçip incelemeye başlayabilirsiniz.

Ekstra Bilgiler ve Notlar​

• Standart Silkroad arşivleri için varsayılan PK2 şifresi (Base Key): 169841
• Bu paylaşım resmi oyun arşivlerini veya özel sunucu (private server) dosyalarını içermez. Sadece bir inceleme aracıdır, tam bir oyun istemcisi değildir.
• Eski Vulkan altyapısı kaldırılmış olup, tüm önizleme ve render işlemleri doğrudan Electron uygulaması içerisinden (veya tarayıcıdan) sağlanmaktadır.

Ekran Görüntüleri​

Skills and world/map catalog







3D models, animation, audio, text, and textures



























Particle effects











Dungeons and compounds

Güncelleme Notları​

Aracın gelişim sürecini ve eklenen yeni özellikleri aşağıdan takip edebilirsiniz:

30 Haziran 2026​

• Tarayıcı (Browser) Desteği: Tarayıcı tarafında çalışan Archive Explorer API'sini yükleyen bir Vite yapısı eklendi. Artık yerel PK2 dosyaları doğrudan tarayıcı üzerinden açılabilir ve çalışma alanı arayüz ayarları localStorage'da saklanır.
• Salt Okunur Bellek İçi PK2: Mevcut ayrıştırıcı (parser) ve önizleme kodlarının Node dosya sistemi veya Electron IPC olmadan çalışabilmesi için salt okunur bellek içi tarayıcı PK2 arşivi eklendi.
• Docker Entegrasyonu: Herhangi bir host/proxy yapılandırmasına ihtiyaç duymadan nginx üzerinden statik sunum yapabilen, /healthz destekli genel Docker paketlemesi eklendi.
• Gelişmiş Dosya Sıralama: Dosya tarayıcısında filtrelenmiş sonuçlar artık dosya adına veya boyutuna göre artan/azalan şekilde sıralanabiliyor (sıralama tam arşivi değil, yalnızca temel dosya adını baz alır).
• Navmesh Düzenleme Arayüzü: Navmesh düzenlemelerinde, zemin engelleme (blocker) düzenlemeleri artık tüm hücreyi boyamak yerine sadece ilgili kutucuğun (tile) üzerinde bir katman olarak gösteriliyor.
• Navmesh Görünürlük Kontrolleri: Zemin, obje yüzeyleri, obje geçiş kenarları ve engellenmiş kenarlar artık renklerin daha net anlaşılabilmesi için ayrı katmanlar, render sıraları ve opaklık değerleri kullanıyor. Objeleri gizleme tuşu, obje navmesh katmanlarını da otomatik olarak gizliyor.
• EasyFX Optimizasyonları: Yoğun EasyFX zaman çizelgeleri artık varsayılan olarak kapalı başlıyor; statik emit limitleri, mesh derinlik (depth-write) davranışları ve ViewBillboard güncelleme maliyetlerinde ciddi iyileştirmeler yapıldı.

28 Haziran 2026​

• Dünya Navmesh Tarayıcısı: Tembel yükleme (lazy-load) özellikli NVM küçük resimlerine ve doğrudan bölge seçimine sahip yeni bir dünya navmesh genel bakış tarayıcısı eklendi.
• Görsel NVM Blocker Editörü: Fırça kontrolleri, fare tekerleğiyle yakınlaştırma (zoom), üzerine gelme bildirimleri (hover) ve kaydet/sıfırla eylemleri barındıran görsel NVM engelleyici editörü entegre edildi.
• Navmesh Obje Renderlama: Navmesh obje modeli işleme, obje görünürlük kontrolleri ve obje kenarı engelleme/temizleme düzenlemeleri eklendi.
• EasyFX Geliştirmeleri: BlendDiffuseGraph uyumluluğu, rastgele ölçek (scale) zamanlaması, grafik komut kareleri ve genel döndürme (spin) mantığı iyileştirildi. Çözümlenmemiş objelere sahip bölgeler için yalnızca tile (karo) tabanlı NVM önizleme desteği eklendi.

26 Haziran 2026​

• Bağımsız Electron Aracı: Archive Explorer, kendine ait README dosyası, ekran görüntüleri, kurulum notları ve desteklenen görünüm belgeleri ile tam bağımsız bir Electron inceleme aracı olarak hazırlandı.
• Altyapı Temizliği: Eski yerel Vulkan önizleme yardımcısı kaldırılarak odak tamamen TypeScript/Electron iş akışlarına çevrildi.
• Dokümantasyon: Arşiv, model, texture, metin, partikül, zindan, compound, yetenek (skill) ve navmesh önizleme sistemleri detaylıca belgelendi.

25 Haziran 2026​

• Regex Dosya Arama: Arşiv kataloglarını filtrelemek için Regex destekli dosya arama seçeneği eklendi.
• EasyFX Zamanlama Uyumu: Referans görüntüleyiciye kıyasla grafik zamanlaması, RNG, materyal durumları ve emisyon gruplandırmaları büyük ölçüde senkronize edildi.
• Ortam Efektleri Stabilizasyonu: Şelaleler gibi ortam partikül efektleri (ambient effects); süreye dayalı statik yayın sayıları, korunan spawn (doğma) dizileri ve sabit ağ yayın havuzlarıyla daha stabil hale getirildi.
• BSR/Compound İyileştirmeleri: Kök kemik (root-bone) hizalaması, derinlik bileşimi düzeltmeleri ve modellerin kompozit olarak geri yüklenmesi sağlandı.

24 Haziran 2026​

• Partikül (Particle) İyileştirmeleri: Partikül başına texture-frame örnekleme eklendi. Şimşek ve mesh partikül efektleri için hıza odaklı ışın (beam) yönetimi eklendi.
• EasyFX Rotasyonları: EasyFX mesh/statik emisyonları, ayarlanmış rotasyon hızları ve emisyon aralıklarıyla güncellendi.
• EFP Varsayımlarının Kaldırılması: Ateş duvarı (fire wall), mermi (projectile) ve duman efektleri için isme dayalı önizleme tahminleri kaldırılarak doğrudan orijinal kaynak verilerine geçiş yapıldı.
• Ortam Compound Partikülleri: Çift taraflı billboard plakaları ve kameraya dönük partikül billboard'ları destekleyen ortam compound render sistemi eklendi.

23 Haziran 2026​

• Kapsamlı EasyFX Uyumluluğu: Texture-slide atlas yönlendirmesi, BAN pozisyon/rotasyon yönlendirmesi, birleştirici (combiner) alfa ve harmanlama (blend) faktörleri eklendi.
• Teşhis ve Raporlama: EasyFX yedek hedefleri, alfa/animasyon durumları ve kayıt (registry) uyumluluğu için teşhis ve kapsam raporlama sistemleri eklendi.
• Compound Ekipman Önizlemeleri: Silah ve ekipmanların (item root transforms), parlama (enhancement) efektlerinin ve görsel slot rotasyonlarının yumuşak alfa harmanlamasıyla önizlenmesi sağlandı.
• Gelişmiş Skill ve Projectile (Yetenek & Mermi): Tablo odaklı (table-driven) meta veriler, özel mermi mesafeleri, kaynak-hareket önizlemeleri, yörüngeler ve koni hızları eklendi.

22 Haziran 2026​

• EFP Ayrıştırma & Arayüz: EFP parse işlemleri, yapılandırılmış hata ayıklama verileri ve partikül araştırmaları için zaman çizelgesi (timeline) arayüzü geliştirildi.
• EasyFX Görünüm Modları: Partikül önizlemesine EasyFX görünüm modları uygulandı ve EFP stüdyo düzeni daha net bir inceleme için yeniden oluşturuldu.
• Mermi Simülasyonu: Projectile root-motion (mermi kök-hareketi) simülasyonu eklendi. Yörünge kontrolleri ve önizleme sorunları giderildi.
• İz (Trail) Önizlemeleri: İz önizleme zamanlaması yumuşatıldı ve daha yoğun efektler için partikül yayıcı (emitter) zaman çizelgeleri sıkıştırıldı.

13 - 21 Haziran 2026 (İlk Temeller)​

• İlk Archive Explorer çalışma alanı (workspace) oluşturuldu ve ilk import/render (içe aktarım/işleme) yolları entegre edildi.
• Zemin gürültü düzeltmeleri (terrain noise fixes) ve gökyüzü küresi (sky-sphere) temizliğini barındıran ilk dünya/sahne önizleme çalışmaları eklendi.
• Bağımsız Electron uygulaması kararı verilmeden önce yerel Vulkan tabanlı bir render motoru ve istemci arşivi çıkarma asistanı üzerinde erken aşama testleri yapıldı.
• Özel EFP, arşiv kataloğu ve sahne inceleme çalışmalarına zemin hazırlayan ilk geliştirme kilometre taşları tamamlandı.

SroCave'de bu tarz paylaşımların devamı için konuyu beğenmeyi ve düşüncelerinizi yorumlarda belirtmeyi unutmayın. İyi çalışmalar!