Hızlı başlangıç
Tosun AntiCheat — Dokümantasyon
FiveM sunucunuzu hilelere karşı korumak için gereken her şey. Aşağıdaki yol haritası, durumunuza göre nereden başlayacağınızı gösterir.
Hızlı başlangıç — 15 dakikada çalışır durumda
Hiç kurulum yapmadıysanız bu sırayı izleyin:
| # | Adım | Süre | Rehber |
|---|---|---|---|
| 1 | Veritabanınızı hazırlayın Zaten QBCore/ESX kullanıyorsanız mevcut veritabanınız yeterli — veriniz sizde kalır | ~5 dk | Veritabanı (MySQL) → |
| 2 | Sunucunuzu panele ekleyin Lisans anahtarınız burada üretilir | ~2 dk | Panel Bağlantısı → |
| 3 | Anti-cheat'i sunucunuza kurun Paketi indirin, klasöre atın, server.cfg'ye 3 satır ekleyin | ~5 dk | Kurulum → |
| 4 | Platform sertleştirmesini uygulayın En değerli adım — hilelerin çoğunu tek seferde engeller | ~3 dk | Kurulum § 7 → |
Neye ihtiyacınız var?
| Durumunuz | Gidilecek yer |
|---|---|
| Yeni kuruyorum, sıfırdan başlıyorum | Kurulum rehberi — adım adım, her adımın nedeni açıklanmış |
| Veritabanı bağlantısı kurulmuyor | Veritabanı rehberi — bağlantı dizesi, panel erişimi, sorun giderme |
| Panel sunucuma bağlanmıyor | Panel bağlantısı — bağlama, kullanım, sorun giderme |
| QBCore / ESX ile uyumluluk | Framework — otomatik tespit edilir |
| Yanlış ban alıyorum | Ayarlar & performans — doğrulama pencereleri, muafiyetler |
| Kendi script'imle entegre edeceğim | Export'lar — muafiyet, ban, whitelist API'si |
| Lisans anahtarım nerede? | Lisans anahtarı |
| Bir sorunum var | SSS · Panel → Destek |
Sistem nasıl çalışır?
Üç bileşen birlikte çalışır:
| Bileşen | Nerede çalışır | Görevi |
|---|---|---|
tosun-ac | FiveM sunucunuz | Tespit, ceza, koruma. Asıl anti-cheat. |
tosun-ac-guardian | FiveM sunucunuz | Anti-cheat durdurulursa 1 saniyede geri getirir. |
| Panel (bizde barındırılır) | Web | Banlar, tespitler, canlı izleme, ayarlar. |
Panel ile sunucu iki yönlü ve otomatik haberleşir: tespitler anında panele düşer, panelde yaptığınız ayar değişiklikleri ~30 saniyede sunucuya iner. Ayar değiştirmek için sunucu yeniden başlatmanız gerekmez.
Koruma yaklaşımımız
1. Platform katmanı (bypass edilemez). FiveM'in kendi yönlendirme convar'ları —
sv_entityLockdown, sv_stateBagStrictMode, sv_filterRequestControl. Bunlar açıkken sunucu hileli paketi hiç iletmez; istemcide ne çalışırsa çalışsın fark etmez.
2. Sunucu-otoriter katman. Silah verme, patlama, hasar gibi ağ olayları sunucudan geçer ve sunucu-taraflı gerçekle karşılaştırılır. Bir executor bu katmanı atlayamaz, yalnızca içeriğini uydurmayı deneyebilir — o da yakalanır.
3. İstemci katmanı. Native bütünlüğü, OCR, menü imzaları. Hızlı ve ucuz ilk filtredir; yanabileceği kabul edilerek tasarlanmıştır.
Dürüst not: Hiçbir anti-cheat "hile kesinlikle giremez" diyemez — kernel seviyesinde çalışan hilelere karşı istemci tarafı tespitin fiziksel bir sınırı vardır. Bu yüzden ağırlığı, hilenin atlayamadığı sunucu ve platform katmanlarına veriyoruz. Platform sertleştirmesini uygulamanız, yapabileceğiniz tek en etkili şeydir.
Yanlış ban politikası
İki hatadan da kaçınırız:
- Masum oyuncuyu banlamak. Fizik tabanlı tespitler (hız, teleport, noclip) art arda birden çok okuma ve minimum süre boyunca doğrulanmayı gerektirir; lag/desync sırasında tamamen atlanır.
- Hileciyi kaçırmak. Bir hileci kasten lag yaratıp doğrulama penceresini sürekli sıfırlatamaz — uzun pencerede toplam ihlal eşiği aşılırsa ceza yine uygulanır.
Ayrıca yanlış pozitif riski görece yüksek tespitlerde süreli ban verilir (örneğin noclip 7 gün), kesin tespitlerde (menü imzası, dump denemesi) kalıcı ban uygulanır. Ayarlanabilir: Ayarlar & performans.