Metin2 Pack Dosyaları: EPK ve EIX Nedir?

Metin2 istemcisi oyun dosyalarını tek tek değil, paketler hâlinde taşır. Her paket iki dosyadan oluşur: .eix dosya listesini (ad, boyut, konum, sıkıştırma türü) tutar, .epk verinin kendisini. İstemci bir dosyaya ihtiyaç duyduğunda adını küçük harfe çevirip CRC32 değerini hesaplar, eix içindeki kaydı bulur, epk'den o bölümü okur ve gerekiyorsa açar ya da şifresini çözer.

Paketlerin istemci klasöründeki yeri ve hangi paketin ne taşıdığı Metin2 client klasör yapısı yazısında. Burada biçimin kendisi, sıkıştırma türleri ve istemcinin paketleri hangi sırayla okuduğu anlatılıyor.

EIX dosyası ne içerir?

eix dosyası 12 baytlık bir başlıkla başlar: EPKD imzası, sürüm numarası (2) ve kayıt sayısı. Ardından her dosya için sabit boyda bir kayıt gelir. İstemci kaynak kodundaki tanım şöyledir:

typedef struct SEterPackIndex
{
	long  id;               // kaydın sırası
	char  filename[161];    // sanal yol, en çok 160 karakter
	DWORD filename_crc;     // yolun CRC32 değeri
	long  real_data_size;   // epk içinde ayrılan yer
	long  data_size;        // verinin gerçek boyu
	DWORD data_crc;         // verinin CRC32 değeri
	long  data_position;    // epk içindeki başlangıç
	char  compressed_type;  // 0-5 arası tür
} TEterPackIndex;

Yapı 4 bayta hizalı tanımlandığı için her kayıt 192 bayt tutar. İstemci eix'i iki biçimde kabul eder: EPKD ile başlayan düz dosya ya da MCOZ ile başlayan, LZO ile sıkıştırılıp şifrelenmiş dosya. Sürüm 2 değilse ya da dosya boyu kayıt sayısını karşılamıyorsa "Pack index file ... error" hatası syserr.txt'ye düşer ve paket yüklenmez.

EPK dosyası ve dosya adları

epk'nin bir başlığı yoktur; her dosyanın verisi eix kaydındaki data_position noktasından başlar. Paketleme sırasında her dosyaya 256 baytlık bloklara yuvarlanmış bir yer ayrılır. Bir dosya silindiğinde ya da büyüyüp eski yerine sığmadığında eski yeri boş blok olarak kalır ve sonraki dosyalar için yeniden kullanılır. Aynı paket defalarca güncellendikçe epk'de bu boşluklar birikir; baştan oluşturulan pakette olmaz.

Dosya adları paketlenirken ve aranırken aynı dönüşümden geçer: bütün harfler küçültülür, \ işaretleri / olur. Bu yüzden SkillDesc.txt ile skilldesc.txt aynı dosyadır. Ad en çok 160 karakter olabilir. İstemci aramayı adın kendisiyle değil CRC32 değeriyle yapar, sonra adı ayrıca karşılaştırır.

Paket içindeki yollar sanaldır. Modeller ve efektler d:/ymir work/..., simgeler icon/..., dil dosyaları locale/tr/..., sesler sound/..., haritalar doğrudan harita klasörünün adıyla (metin2_map_a1/setting.txt) kayıtlıdır. Yolunda hiç / geçmeyen dosyalar (system.py gibi) root paketine aittir.

Sıkıştırma ve şifreleme türleri

Her kaydın son alanı dosyanın nasıl saklandığını söyler. Kaynak kodda altı tür tanımlıdır:

1 ve 2 numaralı türlerde dosyayı açmak için gereken her şey istemcinin kendisinde bulunur. Bu türler veriyi gizlemekten çok paketi küçültmek ve sıradan düzenlemeyi zorlaştırmak içindir. 3, 4 ve 5 numaralı türler ise anahtarlarını oturum açılırken sunucudan alır; istemci tek başına çalıştırıldığında bu paketler açılamaz.

2 ve 3 numaralı türlerde istemci okuduğu verinin CRC32 değerini kayıttakiyle karşılaştırır. Paket bozulmuşsa dosya okunmaz ve oyun o dosyayı hiç yoktan sayar.

LZO sıkıştırılmış verinin başında da MCOZ imzalı 16 baytlık bir başlık vardır: imza, şifreli boy, sıkıştırılmış boy ve açılmış boy. İstemcinin item_proto ve mob_proto kopyaları da paketin içinde bu sarmalayıcıyla saklanır.

İstemci paket listesini nasıl okur?

Bu kaynakta paket listesi istemcinin C++ kodunun içine yazılıdır. Exe açılırken şu adları sırayla kaydeder, en sonda root paketini:

std::vector<std::string> packlist
{
	"bgm", "effect", "etc", "icon", "item", "locale", "maps",
	"monster", "npc", "pc", "pc2", "pc3", "property", "season",
	"sound", "textureset", "zone",
};
for (const auto& pack : packlist)
	CEterPackManager::Instance().RegisterPack((c_pszFolder + std::string("/") + pack).c_str(), "*");
CEterPackManager::Instance().RegisterRootPack((c_pszFolder + std::string("/") + std::string("root")).c_str());

c_pszFolder değeri pack olduğu için istemci pack/effect.eix ve pack/effect.epk gibi dosyaları arar. Listede olup klasörde bulunmayan paket (bu istemcide bgm ve season) sessizce atlanır; eksiklik ancak o paketteki bir dosya istendiğinde fark edilir.

Paketler "*" ile kaydedildiği için hepsinin dosya adları tek bir ortak sözlüğe girer. İstemci bir dosyayı ararken hangi pakette olduğuna bakmaz, yalnız yolunu bilir. Bu yüzden icon/item/00010.tga icon paketinde de, başka bir pakette de olsa bulunur.

Arama sırası derlemeye göre değişir. Yayın (Release) derlemesi önce paketlere, bulamazsa diske bakar. Hata ayıklama (Debug) derlemesi önce diske, sonra pakete bakar. Debug exe ile çalışırken bir dosyayı paketi yeniden oluşturmadan diskte değiştirip denemek bu yüzden mümkündür.

Aynı yol iki pakette varsa hangisinin döneceği kodda garanti edilmez. Tek istisna, sunucunun oturum açılırken kaydettirdiği paketlerdir: bunlar aynı yoldaki eski kaydın yerine geçer. Bir dosyayı güncellerken eski kopyasını başka pakette bırakmamak gerekir.

Python betikleri paketten nasıl okur?

Exe, Python'a pack.Exist ve pack.Get fonksiyonlarını verir. Bu kaynakta açık olan ENABLE_PACK_GET_CHECK bayrağı yüzünden pack.Get yalnız .py, .pyc ve .txt dosyalarını döndürür; uzantısız item_proto gibi dosyalar Python'dan okunamaz. root paketindeki system.py, Python'un open fonksiyonunu ve import komutunu pakete yönlendirir. Diskteki bir dosyayı okumak ya da yazmak gerektiğinde betiklerde old_open kullanılır.

Yeni bir pack nasıl eklenir?

İki yol var. Birincisi, yeni dosyaları var olan bir paketin içine koymaktır; istemci dosyayı yoluna göre bulduğu için hangi pakette durduğu fark etmez. Yeni bir harita da çoğu zaman maps, zone ve property paketlerine eklenen klasörlerle gelir; harita tarafının ayrıntısı harita ekleme yazısında.

İkincisi, yeni bir paket adı açmaktır. Bu kaynakta liste C++ kodunda olduğu için adı listeye ekleyip istemciyi yeniden derlemek gerekir. Derleme adımları Metin2 source derleme yazısında anlatılıyor. Yeni paketin dosyaları pack/<ad>.eix ve pack/<ad>.epk olarak konur.

makepackscript dosyası ne anlatır?

root paketinin içinde makepackscript_onlyrootnopython.txt adlı bir dosya duruyor. Bu, Ymir'in paketleme aracının (MakePack) okuduğu bir betiktir. Aracın kendisi kaynak paketinde yok; istemcinin paket kütüphanesinde yalnız onun izleri (paket yazma fonksiyonları ve paketleme günlüğü) var. Betiğin kısaltılmış hâli:

FolderName "pack"

List ExcludedFolderNameList
{
	"CVS"
}
List ExcludedFileNameList
{
	"syserr.txt"
	"log.txt"
	"loginInfo.py"
	"makepackscript.txt"
}
List SecurityExtNameList
{
	"txt"
	"msk"
	"msa"
	"msm"
	"py"
}
List CompressExtNameList
{
	"txt"
	"mss"
	"mse"
	"spt"
	"atr"
	"dds"
	"tga"
}

Group RootPackItemList
{
	Group ItemProto
	{
		FileName	"*item_proto"
		Fixed	TRUE
	}
	Group ModelFiles
	{
		FileName "*.msm"
		Fixed	TRUE
	}
}

Group PackList
{
	Group UIScript
	{
		PathName	"UIScript/*"
		Fixed		TRUE
	}
}

Asıl dosyada hariç tutulan dosya listesi daha uzundur ve CompressExtNameList ayrıca msk, msf, msa, raw, wtr, mde uzantılarını içerir; RootPackItemList'te mob_proto, TextureSet/*.txt, *.txt, *.tbl ve *.cvt kalıpları da vardır.

• FolderName: Paketlerin yazılacağı klasör.
• ExcludedFolderNameList, ExcludedFileNameList: Pakete girmeyecek klasör ve dosyalar. Günlükler ve geliştiricinin otomatik giriş dosyası (loginInfo.py) bilerek dışarıda bırakılmış.
• SecurityExtNameList ve CompressExtNameList: Adları, istemcideki 2 numaralı (SECURITY) ve 1 numaralı (COMPRESS) türle örtüşüyor. Muhtemelen birinci listedeki uzantılar şifreli, ikincidekiler yalnız sıkıştırılmış olarak paketlenir; listelerde olmayan gr2, wav, jpg gibi uzantılar düz saklanır. txt, msk ve msa iki listede birden geçtiği için bunlara hangisinin uygulandığı aracın kendisine bağlıdır.
• RootPackItemList: root paketine girecek dosya kalıpları (item_proto, mob_proto, metin dosyaları, .msm model betikleri).
• PackList: Her grup ayrı bir paket tanımlar; burada UIScript klasörü.

Kaynakla gelen istemcinin pack klasöründe ayrıca EPack32 adlı, topluluk tarafından yazılmış bir paketleme aracı var. Onun da kaynak kodu pakette olmadığı için hangi türleri ürettiği burada anlatılmadı.

Sunucu tarafında paket anahtarları

3, 4 ve 5 numaralı türlerin anahtarları sunucunun share klasöründe tutulur ve istemciye auth girişi başarılı olduğu anda gönderilir:

• panama/panama.lst: Her satırda bir paket yolu ve 32 baytlık başlangıç vektörü dosyasının adı. Sunucu açılışta bu dosyaları okur, giriş başarılı olunca her vektörü o oturuma özel bir değerle karıştırıp istemciye yollar. İstemci adı gelen paketi o anda kaydeder; bu paketlerin istemcinin sabit listesinde olması gerekmez ve aynı yoldaki eski dosyaların yerine geçerler.
• package/ klasörü: 4 ve 5 numaralı türlerin anahtar ve ek parça (SDB) bilgileri. Anahtarlar giriş sırasında, ek parçalar ise karakter o paketle ilişkili bir haritaya girerken gönderilir.

Bu kaynakla gelen sunucu dosyalarında iki klasör de boş. Yani bu istemcinin paketleri sunucudan anahtar beklemiyor; 0, 1 ve 2 numaralı türlerle çalışıyor. Sunucunun bu adımı hangi bağlantıda yaptığı serverinfo.py ve bağlantı yazısında anlatılıyor.

Paketlemede sık yapılan hatalar

Dil dosyalarının paket içindeki yerleri ve biçimleri için istemci dil dosyaları yazısına bakılabilir.