vSro Paylaşım Silkroad Online Dize Referansları ve UIIT Mimarisi: Dahili Sabitler ve Yerelleştirme Köprüsü

Silkroad Online Dize Referansları ve UIIT Mimarisi: Dahili Sabitler ve Yerelleştirme Köprüsü

Silkroad Online istemcisinin (`sro_client.exe`) ikili yapısı decompile edildiğinde; sunucudan gelen paketlerin kullanıcı arayüzünde (UI) hangi metinlere, hata uyarılarına ve sistem diyaloglarına dönüştürüldüğünü belirleyen **421 adet dize sabiti (String Literal) ve `UIIT_*` anahtarı** ortaya çıkmaktadır. Bu dize referansları, 98 farklı ağ işlem koduyla (Opcode) doğrudan ilişkili olup protokolün çalışma mantığını şüpheye yer bırakmayacak şekilde belgeler.

Bu teknik monografta; istemci ikilisinden çıkarılan **UIIT dize indeksinin mimari yapısı**, `textuisystem.txt` ile kurulan yerelleştirme köprüsü, sohbet, kale savaşı, lonca, parti, akademi ve simya sistemlerine ait **çalışma zamanı format ve hata ayıklama şablonları** akademik bir titizlikle incelenmektedir.

---

### 1. UIIT Mimarisi ve Dinamik Metin Bağlama Mekanizması

İstemci, sunucudan gelen yanıt paketlerinde (`0xB0xx`) veya durum güncellemelerinde (`0x30xx`) kullanıcıya gösterilecek metinleri ham olarak paketin içinde taşımaz. Bunun yerine:
1. Sunucu, işlem sonucunu belirten bir durum kodu (Status Code) veya hata indeksi gönderir.
2. İstemci işleyicisi (Handler), C++ kaynak kodunda sabit tanımlanmış bir **`UIIT_*` (User Interface Item Text)** anahtarını seçer.
3. Bu anahtar, PK2 arşivi (`Media.pk2\server_dep\silkroad\textdata\textuisystem.txt`) içerisindeki yerelleştirilmiş dize tablosundan sorgulanır.
4. Ekrana, oyuncunun seçtiği dilde (İngilizce, Korece, Türkçe vb.) nihai mesaj basılır.

---

### 2. Fonksiyonel Sistemlere Göre UIIT Dize ve Opcode İndeksi



---

### 3. Lonca, Parti ve Akademi Sistemi Dize Haritası



---

### 4. Çalışma Zamanı Format ve Hata Ayıklama (Debug) Şablonları

İstemci makine kodunda yer alan dahili `sprintf` şablonları, motorun iç durum değişkenlerini açıkça ortaya koyar:



---

### 5. Geliştiriciler İçin Çıkarımlar ve Analiz Metodolojisi

1. **Paket Anlamını Kesin Çözme:** Yeni bir paketin ne işe yaradığı analiz edilirken; işleyicinin içinde aranan `UIIT_*` anahtarı, paketin amacını %100 kesinlikle ortaya çıkarır. Örneğin içinde `UIIT_MSG_FORT_WAR_BEGIN` geçen bir işleyicinin kale savaşı başlangıç paketi olduğu tartışmasızdır.
2. **Çok Dilli İstemci Geliştirme:** Özel arayüz modülleri veya botlar geliştirilirken hardcoded metinler yerine `textuisystem.txt` içerisindeki `UIIT_*` anahtarları referans alınmalı, böylece çok dilli destek korunmalıdır.
3. **Fail-Closed Prensibi:** `UIIT_CHATERR_*` veya `UIIT_MSG_*_ERR_*` dizileri, sunucu tarafında hangi kural ihlalinin (mesafe, yetki, envanter doluluğu) gerçekleştiğini doğrudan bildirir.

---

Silkroad Geliştirici Camiasına Teşekkür ve Saygı

Bu kapsamlı teknik dokümantasyon, tersine mühendislik mimarisi ve protokol analizlerinin gün ışığına çıkmasında Silkroad ekosistemine yıllardır karşılıksız devasa emekler veren ve bu mirası ileriye taşımaya devam eden öncü geliştiricilerimize en içten teşekkürlerimizi sunarız:

DaxterSoul — Paket filtreleme, proxy mimarileri ve sunucu güvenliğindeki temel çalışmaları ve topluluğa kazandırdığı standartlar için,
florian0 — İstemci (Client) ve GameServer ikili (binary) tersine mühendisliği, hook ve assembly düzeyindeki rehber niteliğindeki araştırmaları için,
JellyBitz — Açık kaynak Silkroad araçları, paket analiz kütüphaneleri ve geliştirici ekosistemine sunduğu paha biçilmez açık kaynak yazılımlar için,
ferdoran — İstemci-sunucu protokol analizlerinin, opcode referanslarının ve teknik dokümantasyonun derlenip topluluğa kazandırılmasındaki büyük gayretleri için.

Silkroad geliştirici topluluğuna kattığınız değer, paylaştığınız bilgi birikimi ve sunduğunuz vizyon için sonsuz teşekkürler. İyi ki varsınız!

Genişletmek için tıkla ...