Metin2 Quest Compiler (qc) Kullanımı — Başlangıç Rehberi

Metin2 private server geliştirenlerin sıkça karşılaştığı konulardan biri Quest Compiler (qc) kullanımıdır. Bu araç, sunucunuzdaki görev (quest) dosyalarını oyunun okuyabileceği formata dönüştürür. Bu rehberde qc'nin ne olduğunu ve temel kullanımını anlatıyoruz.

Quest Compiler (qc) Nedir?

Metin2 sunucu tarafında görevler .qc uzantılı kaynak dosyalarında yazılır. Ancak oyun motoru bu dosyaları doğrudan okuyamaz; önce .qsc uzantılı derlenmiş (compiled) dosyaya çevrilmesi gerekir. İşte bu dönüştürme işlemini yapan araca Quest Compiler denir.

qc Neden Gereklidir?

Sunucunuzda yeni bir quest (görev, event, NPC diyaloğu, ödül sistemi vb.) eklediğinizde veya mevcut bir questi düzenlediğinizde, değişikliklerin oyun içinde çalışması için mutlaka derleme işleminden geçmesi gerekir. Derlenmeyen ya da hatalı derlenen questler sunucu başlatma sırasında hata verir veya sessizce çalışmaz.

PuTTY ile qc Kullanımı — Adım Adım

1. PuTTY üzerinden sunucunuza SSH ile bağlanın.
2. Quest dosyalarınızın bulunduğu dizine gidin (genellikle quest/ klasörü altında).
3. Derlemek istediğiniz quest klasörüne girin: cd quest_adi
4. Aşağıdaki komutla derleme işlemini başlatın:

../../qc quest_adi.qc

5. İşlem başarılıysa aynı dizinde .qsc uzantılı yeni bir dosya oluşur.
6. Sunucunuzu (game core) yeniden başlatarak değişikliklerin aktif olmasını sağlayın.

Sık Karşılaşılan Hatalar

• "command not found" hatası: qc dosyasının yolu yanlış veya çalıştırma izni (chmod +x) eksik olabilir.
• Syntax error: .qc dosyasında parantez, tırnak veya girinti hatası olabilir — satır numarasına göre dosyayı kontrol edin.
• Quest oyunda görünmüyor: Derleme başarılı olsa bile core yeniden başlatılmadıysa değişiklik yansımaz.

İpuçları

• Her değişiklikten sonra mutlaka yeniden derleyin, .qc dosyasını düzenlemek tek başına yeterli değildir.
• Toplu quest güncellemelerinde tüm klasörü tek seferde derleyen betikler (script) kullanmak zaman kazandırır.
• Derleme öncesi dosyanızın yedeğini almak, hatalı düzenlemelerde geri dönüş imkanı sağlar.

Sonuç

Quest Compiler, Metin2 private server yönetiminin temel taşlarından biridir. PuTTY üzerinden birkaç komutla questlerinizi hızlıca derleyip sunucunuza aktarabilirsiniz. Sunucu kiralama ve teknik altyapı desteği için Eva Bilişim Metin2 VDS paketlerini inceleyebilirsiniz.