Metin2 client tarafında en sık karşılaşılan problemlerden biri Python traceback hatalarıdır. Client açılırken kapanabilir, login ekranı gelmeyebilir, envanter veya özel bir pencere açılınca oyun kapanabilir ya da syserr.txt içinde Python dosyalarına ait hata satırları görülebilir.

Bu hatalar genellikle root pack, uiscript, locale interface dosyaları, eksik import, yanlış fonksiyon adı veya bozuk Python syntax kaynaklıdır.

1. Python Traceback Nedir?

Traceback, Python’un hata oluştuğunda hangi dosyada ve hangi satırda problem yaşandığını gösterdiği hata çıktısıdır. Metin2 client syserr.txt içinde genellikle şu tarz görünür:

Traceback (most recent call last):
  File "uiInventory.py", line 123, in OnPressEscapeKey
AttributeError: 'InventoryWindow' object has no attribute 'Close'

Bu örnekte hata uiInventory.py dosyasının 123. satırında oluşmuştur. Hatanın türü ise AttributeError olarak görünmektedir.

2. Client Syserr Dosyasını Kontrol Etme

Client tarafındaki ilk kontrol dosyası genellikle client klasöründeki syserr.txt dosyasıdır.

Client klasorunde syserr.txt dosyasini acin ve en alttaki yeni hatalari kontrol edin.

Hatanın en önemli kısmı genellikle en alttaki satırlardır. Çünkü Python traceback içinde üst satırlar çağrı sırasını, en alt satır ise asıl hata türünü gösterir.

3. En Sık Görülen Python Hata Türleri

• SyntaxError: Yazım hatası vardır. Parantez, iki nokta veya tırnak eksik olabilir.
• AttributeError: Çağrılan fonksiyon veya değişken ilgili nesnede yoktur.
• NameError: Kullanılan isim tanımlı değildir.
• ImportError: Gerekli Python dosyası veya modül bulunamamıştır.
• TypeError: Fonksiyona yanlış tipte veya yanlış sayıda parametre gönderilmiştir.
• KeyError: Sözlük içinde olmayan bir anahtar çağrılmıştır.

Bu hata türleri doğrudan çözümü göstermez ama hangi yöne bakmanız gerektiğini anlatır.

4. Root Pack Hataları

Root pack, client tarafındaki Python dosyalarının büyük kısmını içerir. Örneğin:

• ui.py
• game.py
• interfaceModule.py
• uiInventory.py
• uiCharacter.py
• uiScriptLocale.py
• constInfo.py

Root dosyasında yapılan hatalı düzenleme clientin açılmamasına veya belirli bir pencere açıldığında kapanmasına neden olabilir.

Root hatalarında genel kontrol sırası:

• Son değiştirilen Python dosyasını belirleyin.
• syserr.txt içindeki dosya ve satır numarasını bulun.
• Eksik import veya yanlış fonksiyon adını kontrol edin.
• Python girintilerini kontrol edin.
• Root pack tekrar paketlenirken dosyanın gerçekten güncellendiğinden emin olun.

5. UI Script Hataları

Metin2 client arayüz pencereleri çoğu zaman uiscript dosyaları ile tanımlanır. Bu dosyalarda pencere boyutu, buton konumu, image yolu, text alanı ve child objeler bulunur.

Uiscript hatalarında şu belirtiler olabilir:

• Belirli bir pencere açılınca client kapanır
• Pencere açılır ama butonlar görünmez
• Arayüz objeleri üst üste biner
• syserr içinde LoadScriptFile hatası görülür
• Python tarafında GetChild hatası oluşur

Örnek GetChild hatası:

KeyError: 'board'
AttributeError: 'NoneType' object has no attribute 'SetEvent'

Bu tür hatalarda Python dosyası, uiscript içinde var olmayan bir objeyi çağırıyor olabilir.

6. GetChild Hatalarını Çözme

Python tarafında şu tarz bir kod olduğunu düşünelim:

self.GetChild("accept_button")

Bu durumda uiscript dosyasında accept_button isimli child obje gerçekten bulunmalıdır. Eğer isim farklıysa veya hiç yoksa client hata verebilir.

Çözüm için:

• Python dosyasındaki GetChild adını kontrol edin.
• Uiscript dosyasındaki name alanını kontrol edin.
• Büyük/küçük harf farkına dikkat edin.
• Yeni eklenen buton veya text objesinin doğru parent altında olduğundan emin olun.

7. Eksik Dosya ve Pack Problemleri

Client syserr içinde şu tarz hatalar görülebilir:

No file or directory
LoadScriptFile Error
CANNOT_FIND_PACK_FILE
Failed to load image

Bu durumda ilgili dosya pack içine eklenmemiş, yanlış klasöre konmuş veya yol hatalı yazılmış olabilir.

Özellikle şu dosya türleri kontrol edilmelidir:

• .py Python dosyaları
• .pyc derlenmiş Python dosyaları
• .py uiscript dosyaları
• .tga, .dds, .sub görsel dosyaları
• locale interface dosyaları

8. Encoding ve Türkçe Karakter Problemleri

Bazı eski client altyapılarında Python dosyalarında veya locale dosyalarında yanlış encoding kullanılması client hatasına sebep olabilir. Özellikle Türkçe karakterler yanlış kaydedildiyse yazılar bozuk görünebilir veya dosya okunamayabilir.

Dikkat edilmesi gerekenler:

• Dosyanın mevcut encoding yapısını koruyun.
• Farklı editörler arasında dosya kaydederken karakter setini bozmayın.
• Türkçe karakter desteklemeyen dosyalarda ş, ç, ğ, ü, ö, ı kullanımına dikkat edin.
• Eski altyapılarda UTF-8 her zaman sorunsuz çalışmayabilir.

Sık Yapılan Hatalar

• syserr.txt okumadan root dosyalarını rastgele değiştirmek
• Python girintilerini bozmak
• Uiscript içinde olmayan objeyi Python’da GetChild ile çağırmak
• Pack güncellendi sanıp eski client ile test yapmak
• Eksik görsel dosyalarını client içine eklememek
• Encoding yapısını bozarak dosyanın okunmasını engellemek

FAQ

Client açılıyor ama envanter açınca kapanıyor, neden?
Envanterle ilgili Python veya uiscript dosyasında hata olabilir. uiInventory.py ve ilgili uiscript dosyası client syserr üzerinden kontrol edilmelidir.

Traceback hatasında en önemli satır hangisidir?
Genellikle en alttaki hata satırı asıl problemi gösterir. Üst satırlar çağrı zincirini anlatır.

Root pack değişikliği sonrası oyun açılmıyor, ne yapmalıyım?
Son değiştirilen Python dosyasını eski yedeğiyle karşılaştırın, syserr.txt kontrol edin ve packin gerçekten güncellendiğinden emin olun.

Güvenlik ve Operasyon Önerileri

• Root pack düzenlemeden önce mutlaka yedek alın.
• Her değişiklikten sonra client syserr dosyasını temizleyip yeniden test edin.
• Toplu root değişiklikleri yerine küçük parça testleri yapın.
• Oyunculara patch vermeden önce temiz client üzerinde test edin.
• Encoding ve satır sonu formatını bilinçsiz değiştirmeyin.

Bu makale PvPSunucusu için özel olarak hazırlanmıştır.