Metin2 Sunucu

Metin2 Source Nasıl Derlenir? FreeBSD Game, DB ve Client Build Rehberi

21 Kasım 2026 16 dk okuma 6 görüntülenme Burak A.
Metin2 Source Nasıl Derlenir? FreeBSD Game, DB ve Client Build Rehberi

Metin2 özel sunucu (PVP) geliştiriciliğinde hazır paketlerin (game/db tar.gz) kullanıldığı dönem geride kalmıştır. Günümüzde hasar formüllerini dengelemek, bellek sızıntılarını kapatmak, yeni zindan ve lonca sistemleri entegre etmek isteyen her sunucu yöneticisi Metin2 source derleme süreçlerine hakim olmak zorundadır. Kaynak kodlar (source code), oyunun tüm mantıksal kurallarını belirleyen ve doğrudan makine diline çevrilen C++ dosyalarından meydana gelir.

Kaynak kodların doğru derlenmesi; sunucunun kararlılığını, işlemci kaynak tüketimini ve oyuncuların istemci (client) tarafında yaşayacağı akıcılığı doğrudan belirler. Bu kapsamlı teknik rehberde; FreeBSD ortamında Game ve DB kaynak kodlarının derlenmesinden Windows üzerinde Visual Studio ile Client binary üretimine, sık karşılaşılan derleme hatalarından güvenli canlıya alma prosedürlerine kadar tüm aşamaları adım adım inceleyeceğiz.

🧩 1. Metin2 Source Nedir? Game, DB ve Client Kaynak Kod Mimarisi

Metin2 altyapısı birbiriyle sürekli iletişim halinde olan üç temel C++ kaynak kod katmanından oluşur:

🎮 Game Source: Oyun Dünyasının Mantıksal Beyni

Oyuncuların koordinatları, hareketleri, ticaret pencereleri, saldırı ve savunma formülleri, zindan kurguları ve yapay zeka (NPC/mob) davranışları Game katmanında işlenir. FreeBSD üzerinde derlenerek çalıştırılabilir game binary dosyasını oluşturur. Çekirdek mimarisinin ayrıntıları için Metin2 Game Core Nedir? Sunucu Mimarisi ve Performans Rehberi içeriğimizi inceleyebilirsiniz.

🗄️ DB Source: Veritabanı ve Önbellek İletişim Katmanı

MySQL veya MariaDB veritabanı ile Game core arasında bir köprü görevi görür. Eşya kayıtları, hesap tabloları ve oyuncu verilerini doğrudan diskteki veritabanına yazmak yerine kendi önbellek havuzunda (cache) toplar ve asenkron olarak diske aktarır. Çıktısı çalıştırılabilir db binary dosyasıdır.

🖥️ Client Source: İstemci ve Grafik Çizim Motoru

Oyuncuların bilgisayarlarında çalışan grafik arayüz (UI), 3D çizim motoru (Direct3D / DirectX), animasyonlar, zemin kaplamaları ve ses dosyalarını yöneten istemci kodlarıdır. Windows ortamında derlenir ve oyuncuların oyuna giriş yaptığı çalıştırılabilir istemci (.exe) dosyasını üretir.

Metin2 Game DB ve Client kaynak kod katmanları ve C++ derleme mimarisi şeması
Metin2 altyapısında Game Core, DB önbellek katmanı ve Windows Client C++ derleme mimarisi

📋 2. Derleme Öncesi Sistem Gereksinimleri ve Donanım Hazırlığı

C++ kaynak kodlarını derleme süreci, derleyicinin yüzlerce dosyayı tarayarak nesne (.o / .obj) dosyalarına dönüştürdüğü yoğun bir işlemci ve disk işlemidir:

  • FreeBSD Sunucu Ortamı: Game ve DB derlemesi için en az 4 vCPU çekirdeği ve 4 GB RAM önerilir. Çok çekirdekli sistemlerde paralel derleme yapılarak işlem süresi önemli ölçüde kısaltılabilir. Bellek miktarı yetersiz sistemlerde derleme sırasında bellek tükenmesi (OOM) yaşanabilir.
  • Depolama Alanı: Kaynak kodların boyutu, derleme sırasında üretilen ara nesne dosyaları ve yedekler için sunucuda en az 15–20 GB boş disk alanı bulunmalıdır. Yüksek IOPS değerine sahip NVMe diskler derleme sürecindeki dosya okuma ve yazma gecikmelerini en aza indirir.
  • Windows Geliştirme Bilgisayarı: Client derlemesi için en az 8 GB RAM’e sahip 64-bit Windows işletim sistemi, uygun Visual Studio sürümü ve gerekli SDK kütüphaneleri hazırlanmalıdır.

Doğru sunucu donanımının seçimi ve kaynak planlaması için Metin2 Sunucu Kiralama Rehberi ve FreeBSD Metin2 Sunucu Optimizasyonu makalelerimizi referans alabilirsiniz.

📦 3. FreeBSD Üzerinde Gerekli Paketlerin Kurulumu ve Bağımlılıklar

FreeBSD üzerinde derleme yapabilmek için gerekli geliştirici araçlarının kurulu olması gerekir. Ancak paket isimleri ve gereksinimler FreeBSD sürümüne (FreeBSD 12, 13 veya 14) ve kullanılan files altyapısına göre farklılık gösterir. Resmi paket ve port yönetimi ayrıntıları için FreeBSD Handbook dokümantasyonunu inceleyebilirsiniz.

# 💻 1. FreeBSD Paket Veritabanını Güncelleme:
pkg update -f

# 💻 2. Temel Derleme ve Sürüm Kontrol Araçlarını Kurma:
pkg install -y gmake makedepend git

Bağımlılık Yönetiminde Kritik Mimari Ayrım

Metin2 kaynak kodlarında kullanılan harici kütüphaneler (CryptoPP, DevIL, Boost, Lua vb.) iki farklı yöntemle yönetilir:

  • Extern (Dahili) Kütüphane Yapısı: Modern files altyapılarında bağımlılıklar projenin extern/ klasöründe statik (.a) olarak yer alır. Bu tip altyapılarda FreeBSD sistemine ek paket kurmaya gerek kalmaz; derleyici doğrudan bu klasördeki kütüphaneleri bağlar.
  • Sistem Paketleri (pkg/ports): Eski nesil altyapılarda kütüphaneler işletim sisteminin /usr/local/lib dizininden çekilir.
# 💻 Sistem genelinde kütüphane kullanan altyapılar için örnek paket kurulumu:
# (Not: Paket adları FreeBSD sürümünüze göre gcc10, gcc12 veya boost-libs şeklinde değişebilir)
pkg install -y cryptopp devil boost-all python27 mysql57-client
⚙️ Teknik Bilgi: FreeBSD Sürümü ve Paket Uyumluluğu
FreeBSD 13 ve 14 sürümlerinde eski GCC (gcc48/gcc49) veya MySQL 5.5 paketleri resmi depolardan kaldırılmıştır. Modern bir altyapıda Clang / GCC 10+ ve MariaDB istemcisi kullanılması tavsiye edilir.

⚙️ 4. Derleme Araçlarının Görevleri: GCC, Clang, Make ve Gmake

Kaynak kodların binary dosyasına dönüşmesinde rol oynayan araçların görevleri doğru kavranmalıdır:

  • Derleyici (Compiler – GCC / Clang): C++ kaynak kodlarını (.cpp ve .h) okuyarak sözdizimini (syntax) kontrol eden ve bunları makine koduna (.o object dosyalarına) çeviren temel araçtır.
  • Bağlayıcı (Linker – ld): Derleyicinin ürettiği onlarca bağımsız nesne dosyasını ve harici kütüphaneleri tek bir çalıştırılabilir binary dosyada (game veya db) birleştiren araçtır.
  • Make vs Gmake Ayrımı: FreeBSD’nin yerel make komutu BSD Makefile formatına göre çalışır. Metin2 kaynak kodlarındaki Makefile dosyaları ise GNU Make uzantılarına göre hazırlanmıştır. Bu nedenle derleme işlemlerinde standart make yerine mutlaka gmake komutu kullanılmalıdır.

💻 5. Game Source Derleme Süreci (Adım Adım gmake)

Game kaynak kodları sunucu dosyalarının mantıksal motorudur. Metin2 source derleme sürecinde Game core derlemesi, projenin en kapsamlı C++ kod tabanını oluşturur. Aşağıdaki dizin yolları genel birer temsilî örnektir; gerçek dizinler sunucunuzdaki klasör yapısına göre değişiklik gösterebilir.

# 💻 1. Game kaynak kod dizinine geçiş yapın (Temsilî yol):
cd /usr/src/server/game/src

# 💻 2. Varsa Makefile bağımlılıklarını güncelleyin:
# Not: Bu komut her files yapısında bulunmaz; Makefile dosyanızda 'depend' hedefi varsa çalıştırılmalıdır.
gmake depend

# 💻 3. Derlemeyi başlatın:
# 4 vCPU çekirdeğine sahip bir sunucuda paralel derleme için:
gmake -j4
💡 İpucu: Artımlı Derleme (Incremental Build) Avantajı
Kaynak kod üzerinde küçük bir düzenleme yaptıktan sonra her seferinde gmake clean çalıştırmak tüm projeyi baştan derleyeceği için gereksiz zaman kaybına yol açar. Yalnızca gmake -j4 komutunu çalıştırmak, derleyicinin sadece değiştirdiğiniz .cpp dosyalarını tespit edip saniyeler içinde derlemesini sağlar. gmake clean komutunu yalnızca Makefile değişikliklerinde veya sıfırdan temiz bir dağıtım çıktısı alırken kullanın.

Derleme işlemi başarıyla bittiğinde, Makefile yapılandırmanıza bağlı olarak aynı dizinde veya bir üst klasörde (örneğin ../bin/game) çalıştırılabilir game dosyası oluşur.

💾 6. DB (Database) Source Derleme Süreci

DB kaynak kodları, veritabanı önbelleklemesini ve sorgu iletişimini derler. Game katmanına göre dosya sayısı çok daha az olduğu için derleme süresi oldukça kısadır.

# 💻 1. DB kaynak kod dizinine geçiş yapın (Temsilî yol):
cd /usr/src/server/db/src

# 💻 2. Varsa bağımlılıkları kontrol edin:
gmake depend

# 💻 3. DB binary dosyasını derleyin:
gmake -j4

Derleme tamamlandığında dizinde db çalıştırılabilir dosyası üretilir. Veritabanı optimizasyonları ve tablo yapılandırmaları hakkında daha fazla bilgi için Metin2 Database Optimizasyonu Nasıl Yapılır? rehberimizi inceleyebilirsiniz.

🖥️ 7. Windows Üzerinde Visual Studio ile Client (Binary) Build Süreci

Metin2 source derleme işlemlerinin sunucu tarafı FreeBSD üzerinde tamamlandıktan sonra, oyunun istemci tarafı Windows üzerinde Visual Studio IDE’si ile derlenir:

1. Doğru Visual Studio Sürümünün Seçimi

Client kaynak kodlarının hazırlandığı C++ standartlarına göre uygun Visual Studio sürümü kullanılmalıdır. MSVC araç takımları ve derleme bayrakları hakkında ayrıntılı bilgi için resmi Microsoft Visual C++ dokümantasyonu sayfasına göz atabilirsiniz:

  • Eski Nesil (Mainline / Rev40k): Genellikle Visual Studio 2013 (v120 araç takımı) gerektirir.
  • Modern Nesil (C++17 / C++20): Visual Studio 2019 veya Visual Studio 2022 (v142 / v143 araç takımı) ile derlenir.

2. Kütüphane ve SDK Bağımlılıkları

Visual Studio üzerinde çözüm (solution) dosyası açılmadan önce şu bileşenler kontrol edilmelidir:

  • DirectX SDK: Eski grafik motoruna sahip altyapılarda Microsoft DirectX SDK (June 2010) kurulu olmalı ve proje özelliklerinde VC++ Directories -> Include/Library yolları tanımlanmalıdır. Modern altyapılarda ise Windows 10/11 SDK içindeki Direct3D kütüphaneleri kullanılabilir.
  • Python Kütüphanesi: Çoğu Metin2 client yapısı Python 2.7 sürümünü temel alır. Projenin bağımlılık klasöründeki Python başlıklarının eksiksiz olduğunu doğrulayın.

3. Çözümü Derleme (Build)

  1. UserInterface.sln veya Client.sln dosyasını Visual Studio ile açın.
  2. Üst menüdeki derleme modunu Release veya Distribute olarak ayarlayın. (Debug modu hata ayıklama amaçlıdır; oyunculara dağıtılacak nihai sürüm mutlaka Release veya Distribute modunda derlenmelidir).
  3. Çözüme sağ tıklayarak Build Solution (Çözümü Derle) seçeneğini çalıştırın.
  4. Derleme bittiğinde çıktı klasöründe Metin2Distribute.exe dosyası üretilecektir.

⚠️ 8. Sık Karşılaşılan Derleme Hataları ve Çözüm Yolları

C++ derleme sürecinde karşılaşılan yaygın hata mesajları ve çözüm yöntemleri:

Hata MesajıMuhtemel NedenÇözüm Yolu
gmake: not foundGNU Make aracı sistemde kurulu değildir.pkg install -y gmake komutu ile aracı kurun.
cannot find -lIL veya -lpngDevIL veya PNG grafik kütüphaneleri bulunamamıştır.Sistem genelinde paket kullanılıyorsa pkg install -y devil png kurun; extern kullanılıyorsa Makefile LIBDIR yolunu kontrol edin.
cannot find -lcryptoppCryptoPP şifreleme kütüphanesi eksiktir veya yolu yanlıştır.Makefile dosyasındaki -L/usr/local/lib veya extern kütüphane yolunu doğrulayın.
error: '>>' should be '> >'C++98 şablon sözdizimi uyuşmazlığı.Makefile CFLAGS alanına -std=c++11 bayrağını ekleyin veya kodda iki büyüktür işareti arasına boşluk bırakın.
Virtual memory exhaustedSunucunun fiziksel RAM miktarı derleyiciye yetersiz gelmiştir.Paralel derleme çekirdek sayısını düşürün (-j2 gibi) veya FreeBSD üzerinde Swap (takas alanı) oluşturun.
fatal error: d3d9.h: No such fileClient derlemesinde DirectX SDK yolları eksiktir.Visual Studio proje özelliklerine DirectX SDK June 2010 include ve lib dizinlerini ekleyin.

Hataların sunucu günlüklerine yansımalarını incelemek için Metin2 Server Logları: Syserr ve Hatalar Nasıl İncelenir? rehberimizden yararlanabilirsiniz.

Metin2 source derleme sürecinde derleyici hataları bağımlılık kontrolü ve telemetri analiz paneli
Metin2 gmake derleme sürecinde CPU çekirdek yükü, bellek kullanımı ve hata ayıklama telemetri paneli

📁 9. Derlenen Dosyaların Sunucuya Doğru Konumlandırılması ve Güvenli İzinler

Yeni derlenen game ve db dosyalarının sunucuya aktarılmasında doğru izin ve sahiplik yapılandırması kritik öneme sahiptir:

# 💻 1. Derlenen yeni binary dosyalarını sunucu çalışma dizinine kopyalayın (Örnek yollar):
cp /usr/src/server/game/src/game /usr/game/share/bin/game
cp /usr/src/server/db/src/db /usr/game/share/bin/db

# 💻 2. Dosya sahipliğini ve grubunu doğru kullanıcıya atayın:
chown root:wheel /usr/game/share/bin/game /usr/game/share/bin/db

# 💻 3. Dosyalara yalnızca gerekli çalıştırma yetkisini verin:
chmod +x /usr/game/share/bin/game
chmod +x /usr/game/share/bin/db
📝 Önemli Not: Güvenli İzin Standardı
Sunucu dosyalarına kontrolsüz biçimde chmod 777 izinleri vermek ciddi bir güvenlik açığı oluşturur. Çalıştırılabilir dosyalara yalnızca yürütme yetkisi (chmod +x veya chmod 755) verilmeli; yazma izinleri sınırlandırılmalıdır.

🔐 10. Canlı Sunucuya Dağıtım, Yedekleme ve Geri Dönüş (Rollback) Prosedürü

Başarılı bir Metin2 source derleme sürecinden sonra, canlı bir sunucuya yeni derlenen bir binary dosyasını yüklerken veri kaybını ve beklenmedik çökmeleri önlemek için şu adımlar izlenmelidir:

  1. Zaman Damgalı Yedek Alın: Yeni binary dosyasını dizine atmadan önce mevcut çalışan sağlam dosyayı mutlaka yedekleyin:
    cp /usr/game/share/bin/game /usr/game/share/bin/game_backup_$(date +%Y%m%d_%H%M)
    cp /usr/game/share/bin/db /usr/game/share/bin/db_backup_$(date +%Y%m%d_%H%M)
  2. Kanalları Güvenli Kapatın: Dosya kopyalama işlemi sırasında kanalların çalışır durumda olması dosya kilitlenmelerine veya bellek bozulmalarına yol açabilir. Sunucu kapatma scriptini (sh close.sh veya sh stop.sh) çalıştırın ve tüm süreçlerin kapandığını ps aux | grep game komutuyla doğrulayın.
  3. Yeni Dosyaları Yerleştirin ve Başlatın: Yeni dosyaları kopyalayıp chmod +x izinlerini verdikten sonra sunucuyu başlatın (sh start.sh).
  4. Geri Dönüş (Rollback) Planı: Eğer yeni kodda bir segmentasyon hatası (segfault) veya çekirdek çökmesi (core dump) meydana gelirse, kanalları derhal durdurup yedeklediğiniz game_backup_* dosyasının adını yeniden game yaparak saniyeler içinde eski kararlı sürüme dönebilirsiniz.
  5. Sürüm Kontrol Sistemi (Git): Kaynak kod dizininde (/usr/src/server) yerel bir Git deposu kurarak her başarılı derlemeyi commit etmek (git commit -m "Ticaret aynası eklendi"), yapılan değişikliklerin geriye dönük takibini sağlar.

Performans yönetimi ve sunucu kararlılığına dair ileri düzey ipuçları için Metin2 PVP Sunucusu Nasıl Optimize Edilir? makalemize göz atabilirsiniz.

🚀 11. Derleme Süresini Etkileyen Faktörler: Donanım Mimarisi

C++ derleme süreleri donanım kaynağının niteliğine doğrudan bağlıdır:

  • İşlemci Tek Çekirdek Performansı (IPC): C++ şablon metaprogramlama (templates) yoğun işlemler içerir. Yüksek tek çekirdek saat frekansına sahip işlemciler (örneğin AMD Ryzen serisi), derleyicinin nesne kodlarını üretme hızını doğrudan katlar.
  • Çok Çekirdekli Paralel Derleme: Makefile dosyasında -j bayrağı ile çekirdek sayısına uygun paralellik tanımlandığında (gmake -j8 gibi), bağımsız .cpp dosyaları eşzamanlı olarak derlenir ve toplam süre büyük oranda kısalır.
  • NVMe SSD ve Disk IOPS Değeri: Derleme esnasında binlerce başlık dosyası taranır ve diske yazılır. Geleneksel mekanik diskler veya yavaş SSD’ler yerine kurumsal NVMe diskler kullanmak I/O bekleme sürelerini (iowait) ortadan kaldırır.
  • Yeterli RAM ve Swap Alanı: Paralel derlemede her derleyici süreci yüzlerce megabayt bellek tüketebilir. Yetersiz bellek durumunda derleme kilitlenir veya hata verir.

Files seçimi ve altyapı uyumluluğu hakkında ayrıntılı rehberimiz için Metin2 Server Files Nedir? Doğru Files Nasıl Seçilir? rehberimizi inceleyebilirsiniz.

❓ 12. Metin2 Source Derleme Hakkında Sık Sorulan Sorular (SSS)

Game source üzerinde yapılan bir değişiklik istemciyi (Client) etkiler mi?

Eğer yapılan değişiklik sunucu ile istemci arasındaki ağ paket yapısını (packet.h), enum listelerini veya veri modellerini değiştiriyorsa, istemci tarafının da yeni paket yapısıyla yeniden derlenmesi zorunludur. Aksi takdirde oyuna girişte paket uyuşmazlığı nedeniyle istemci kapanır.

gmake clean komutunu ne zaman kullanmalıyım?

gmake clean daha önce üretilmiş tüm .o nesne dosyalarını siler. Yalnızca Makefile dosyasını düzenlediğinizde, genel başlık dosyalarında köklü bir değişiklik yaptığınızda veya dağıtıma çıkacak tamamen taze bir binary almak istediğinizde kullanmalısınız. Günlük testlerde bu komutu çalıştırmamak derleme süresinden tasarruf sağlar.

Neden chmod 777 yerine chmod +x kullanmalıyız?

777 izni dosya üzerinde sunucudaki herkese okuma, yazma ve çalıştırma yetkisi verir; bu durum kötü niyetli bir sürecin binary dosyasının üzerine yazabilmesine zemin hazırlar. chmod +x ise yalnızca çalıştırma izni ekler ve yazma haklarını koruyarak dosya güvenliğini sağlar.

Windows Client derlemesinde neden Debug modu kullanılmamalıdır?

Debug modunda derleyici kod optimizasyonlarını devre dışı bırakır ve bellek kontrolleri için hata ayıklama sembolleri ekler. Bu durum istemcinin FPS değerini düşürür ve binary dosya boyutunu büyütür. Canlı oyunculara sunulacak istemci mutlaka Release veya Distribute modunda derlenmelidir.

Farklı bir files yapısının kaynak kodları mevcut sunucuma uyar mı?

Hayır. Her altyapının veritabanı şemaları, paket tabloları ve fonksiyon kütüphaneleri farklıdır. Bir altyapının kaynak kodlarından üretilen game dosyası, başka bir files yapısının veritabanı veya istemcisiyle senkronize çalışmaz.

🏆 13. Sonuç ve AydınCloud Yüksek Performanslı FreeBSD VDS Çözümleri

Özetle; Metin2 source derleme, sunucu sahiplerinin oyun mekaniklerini diledikleri gibi özelleştirmelerini, güvenlik açıklarına anında yama uygulamalarını ve projelerini profesyonel standartlara taşımalarını sağlayan en temel geliştirici sürecidir. Doğru yapılandırılmış bir FreeBSD geliştirme ortamı, kontrollü bağımlılık yönetimi ve titiz bir dağıtım prosedürüyle projelerinizi güvenle büyütebilirsiniz.

AydınCloud olarak; Metin2 geliştiricilerinin ihtiyaç duyduğu yüksek saat frekanslı AMD Ryzen işlemciler, kurumsal NVMe depolama altyapısı ve geliştirme araçlarıyla optimize edilmiş FreeBSD sanal sunucu çözümleri sunuyoruz. Derleme süreçlerinizi hızlandırmak ve oyuncularınıza kesintisiz, düşük gecikmeli bir altyapı sağlamak için AydınCloud Metin2 Sunucu paketlerimizi inceleyebilir veya yüksek kaynaklı VDS Sunucu çözümlerimizi tercih edebilirsiniz.

⚔️ Metin2 Geliştiricileri İçin Yüksek Saat Frekanslı FreeBSD VDS Altyapısı

C++ derleme süreçlerinde bellek tükenmesi ve işlemci darboğazı yaşamayın. AydınCloud’un yüksek tek çekirdek performanslı AMD Ryzen işlemcileri, saf kurumsal NVMe diskleri ve optimize edilmiş FreeBSD altyapısıyla kaynak kodlarınızı güvenle derleyin ve sunucunuzu kesintisiz yönetin.

AydınCloud Metin2 VDS Paketlerini İnceleyin →
Paylaş:
Tüm Yazılara Dön Hemen İnceleyin → Metin2 Sunucu Paketleri Düşük ping, DDoS korumalı Metin2 sunucu paketlerimizi keşfedin. DDoS koruması Düşük ping Anında kurulum

Yorum Yap

E-posta adresiniz yayınlanmayacaktır. Zorunlu alanlar işaretlenmiştir.

🛡️
Güvenlik Doğrulaması
7 + 9 = ?
🔒 Spam botlarını engellemek amacıyla lütfen yukarıdaki matematik işleminin sonucunu yazın.

Yardıma mı ihtiyacınız var? Size nasıl yardımcı olabiliriz?
WhatsApp Destek Bizi Arayın E-posta Gönder