TDGuard Dokümantasyonu

TDGuard, MMORPG sunucuları için geliştirilmiş, yüksek performanslı ve bulut tabanlı bir hile koruma sistemidir (Anti-Cheat). Bu dokümantasyon, sistemin kurulumundan ileri düzey yönetimine kadar ihtiyacınız olan tüm bilgileri içerir.

Güncel Sürüm: v2.3.0 Bu dokümantasyon en son yayınlanan sürüm ile uyumludur. Eski sürümler için destek verilmemektedir.

Sistem Gereksinimleri

TDGuard client ve server tarafında minimum sistem tüketimi hedefler.

İşletim Sistemi: Windows 10/11 (Oyuncular için), FreeBSD 11+ (Sunucu için)
Derleyici (Source): Visual Studio 2013, 2019 veya 2022
Network: Sunucunun dışarıya 80 (HTTP) ve 443 (HTTPS) portları açık olmalıdır.

Source Entegrasyonu (Tavsiye Edilen)

En yüksek güvenlik seviyesi için TDGuard'ı oyununuzun kaynak kodlarına gömmeniz önerilir. Bu işlem panelimiz üzerinden otomatize edilmiştir.

1. Dosyaların Hazırlanması

Oyununuzun Client Source klasöründeki UserInterface projesini açın. Aşağıdaki iki dosyayı masaüstüne kopyalayın:

UserInterface.cpp
UserInterface.h

2. Otomatik Patcher Kullanımı

Müşteri panelindeki Source Patcher menüsüne gidin. Kopyaladığınız dosyaları sürükle-bırak yöntemiyle yükleyin.

Kodlama Desteği (Encoding) Sistemimiz UTF-8 ve Windows-1254 (TR) karakter setlerini otomatik tanır. Ancak dosya formatınızın bozulmaması için orijinal dosyalarınızın yedeğini almayı unutmayın.

3. Manuel Entegrasyon (Opsiyonel)

Eğer otomatik sistemi kullanmak istemiyorsanız, UserInterface.cpp dosyanızın WinMain fonksiyonunun en başına şu kodu ekleyebilirsiniz:

#include "TDGuard.h"

int APIENTRY WinMain(HINSTANCE hInstance, ...) 
{
    // TDGuard Başlatma
    if (!TDGuard::Initialize("LISANS_ANAHTARINIZ")) {
        MessageBox(NULL, "Hile koruması başlatılamadı!", "Hata", MB_ICONERROR);
        return 0;
    }
    
    // Oyunun normal akışı...
    ...
}

Hata Kodları

Oyuncularınızın alabileceği hata kodları ve anlamları aşağıdadır.

Hata Kodu	Açıklama	Çözüm
`ERR_LIC_001`	Lisans bulunamadı veya süresi dolmuş.	Panelden lisans süresini kontrol edin.
`ERR_LIC_002`	IP adresi uyuşmazlığı.	Lisansınızın IP kilidi ile sunucu IP'niz eşleşmiyor.
`ERR_SEC_005`	Debugger tespit edildi.	Oyuncunun bilgisayarında Cheat Engine vb. açık. Kapatıp tekrar denesin.
`ERR_NET_999`	Sunucuya ulaşılamıyor.	İnternet bağlantısını veya Güvenlik Duvarı ayarlarını kontrol edin.

Geliştirici API

Eğer kendi web sitenizde sunucu durumunu göstermek isterseniz, public API uçlarımızı kullanabilirsiniz.

GET /api/status.php?license_key=YOUR_KEY

Dönen Yanıt (JSON):

{
    "status": "active",
    "server_name": "Metin2 PvP",
    "online_players": 1245,
    "last_update": "2026-01-12 14:30"
}