Kurulum

Anti-Cheat kurulumu — adım adım

Bu rehber sıfırdan çalışır duruma gelmenizi sağlar. Her adımın neden gerektiğini de açıklar; bir şey ters giderse nerede arayacağınızı bilirsiniz.

Başlamadan önce — gereksinimler

1. Paketi indirin

Aboneliğiniz aktif olduktan sonra panelden indirin: Panel → Sunucular → sunucunuz → "Anti-Cheat İndir"

Ya da lisans anahtarınızla doğrudan:

curl -H "X-License-Key: LISANS_ANAHTARINIZ" \
     -o tosun-ac.zip \
     https://admin.tosundev.com/api/ac_package_download.php

2. Klasöre çıkarın

resources/
└── [tosun]/
    ├── tosun-ac/
    └── tosun-ac-guardian/

İki klasör de aynı seviyede olmalı. Guardian ayrı bir resource'tur — birazdan neden önemli olduğunu göreceksiniz.

3. Veritabanı şemasını yükleyin

Yalnızca ilk kurulumda:

mysql -u KULLANICI -p VERITABANI < tosun-ac/sql/ts_anticheat.sql

Alternatif olarak configs/anticheat_config.lua içinde ts.autoSQL = true yapıp sunucuyu bir kez başlatın, sonra tekrar false çevirin.

ℹ️ Sürüm yükseltmelerinde şema farkları otomatik uygulanır (ADD COLUMN IF NOT EXISTS) — elle bir şey yapmanız gerekmez.

4. server.cfg — sıralama önemli

ensure oxmysql
ensure tosun-ac
ensure tosun-ac-guardian

5. Paneli bağlayın

configs/anticheat_config.lua içinde:

ts.webPanelURL = "https://admin.tosundev.com"
ts.webPanelKey = "API_ANAHTARINIZ"

API anahtarını Panel → Sunucular → sunucunuz → API anahtarı bölümünden alırsınız.

İkisini de boş bırakabilirsiniz — anti-cheat açılışta bunları veritabanındaki panel_settings tablosundan otomatik çeker. Panelden kurulum yaptıysanız zaten oradadır.

6. Başlatın ve doğrulayın

Sunucuyu yeniden başlatın. Konsolda şunları görmelisiniz:

[Tosun AC v9.0] NetEventGuard aktif
[AC-Guardian] Aktif — tosun-ac harici gözetmen koruması altında.

Ardından oyun içinde:

/ts status     → modül durumu
/ts test       → kendi kendine test

Panel → AC → Canlı ekranında sunucunuz 30 saniye içinde çevrimiçi görünmelidir.

7. Platform sertleştirmesi — en değerli adım

# İstemci networked entity (araç/ped/obje) yaratamaz
set sv_entityLockdown "relaxed"

# Statebag'e yalnızca sunucu yazabilir
set sv_stateBagStrictMode "true"

# Entity kontrol hijack'i (araç fırlatma, oyuncu savurma)
set sv_filterRequestControl "2"

# İstismara açık ağ olayları
set sv_enableNetworkedSounds "false"
set sv_enableNetworkedPhoneExplosions "false"
set sv_enableNetworkedScriptEntityStates "false"

# ScriptHookV istemcileri
set sv_scriptHookAllowed "false"

# Değiştirilmiş istemci dosyaları (silent-aim için kullanılır)
set sv_pureLevel "1"

Anti-cheat açılışta bunları denetler ve eksik olanları konsolda uyarı olarak listeler. Güvenli olanları otomatik uygulatmak isterseniz:

ts.hardening.autoApply = true

8. Admin yetkisi verin

Dört yoldan biri yeterlidir, ilk eşleşen kazanır:

# 1) server.cfg — ACE
add_ace group.admin tosun.admin allow
add_principal identifier.license:LISANSINIZ group.admin

# 2) txAdmin — otomatik tanınır (ts.txAdminAuth = true)

# 3) admins/anticheat_admins.lua
Admins = { "license:xxxxxxxxxxxxxxxxxxxxxxxx" }

# 4) Panel → AC → Admin Yetkileri

Menüyü açmak: /tsmenu, /ts menu veya F7.

Kurulum kontrol listesi

• ☐ Konsolda NetEventGuard aktif yazıyor
• ☐ Konsolda [AC-Guardian] Aktif yazıyor
• ☐ Kırmızı GUVENLIK UYARISI bloğu yok (ya da listelenen convar'ları bilinçli atladınız)
• ☐ Panelde sunucu çevrimiçi görünüyor
• ☐ /tsmenu admin için açılıyor
• ☐ /tsmenu normal oyuncuda hiçbir şey yapmıyor

Sık karşılaşılan sorunlar

Güncelleme

1. Panelden yeni paketi indirin (aynı adres — daima lisansınız için üretilmiş en güncel sürümü verir)
2. configs/, admins/ ve editable/ klasörlerinizi yedekleyin
3. Kaynak klasörünü değiştirin
4. Config dosyalarınızı geri koyun — bu dosyalar tam da düzenlemeye devam edebilesiniz diye asla karartılmaz
5. Yeniden başlatın

Destek isterken Build ID'nizi belirtin (server/core/anticheat_000_license.lua içinde) — hangi yapıyı kullandığınızı tam olarak gösterir.