QBCore Anticheat Kurulumu: Bağımlılıklar ve Kabul Testleri

qb-core tabanlı sunucuda doğru bağımlılık sırası, karakter ve silah doğrulaması, panel veri bağlantısı ve devreye alma testleri.

QBCore çekirdeğinin çalışması, kullanılan her banka veya envanter scriptinin aynı API’yi uyguladığı anlamına gelmez. Bu rehber mevcut çalışan altyapıyı koruyarak AC entegrasyonunu doğrulamak içindir.

Bu kurulumda doğrulanacak noktalar

• qb-core başlamış olmalı; AC framework alanı qb veya doğrulanmış auto olmalı.
• Karakter kimliği citizenid ile çevrimiçi source birbirinden ayrılmalı.
• Envanterde bulunan silah ve envantersiz arena silahı ayrı test edilmeli.
• Özel para/eşya event’leri kendi scriptinde sunucu yetkisi, miktar ve işlem bağlamını doğrulamalı.

Kurulum ve devreye alma sırası

1. Sign up ile hesap oluşturun, e-postanızı doğrulayın ve uygun ücretli planın ödeme durumunu kontrol edin.
2. Sunucular bölümünde doğru sunucuyu seçin; resource, ayarlar ve oyun veritabanını yedekleyip o sunucunun paketini indirin.
3. Paketi tosun-ac klasörüne açın; lisansı yalnız server.cfg içinde set ile saklayın.
4. Mevcut bağımlılık sırasını koruyun, uygun AC framework alanını ayarlayın ve bakımda başlatın.
5. Test karakteriyle aşağıdaki kabul kontrollerini tamamlayın; sürüm, tarih ve sonuçları kaydedin.

server.cfg başlangıç örneği

set tosun_ac_license "YOUR_SERVER_LICENSE"

ensure oxmysql
ensure qb-core
ensure tosun-ac

Sonucu nasıl değerlendirebilirsiniz?

• Konsolda kurulu sürüm ve gerçek framework tanımlanabilmeli.
• Meşru oyun akışları beklenmeyen ceza veya kalıcı muafiyet bırakmamalı.
• Panel okuması doğru sunucu ve karaktere ait olmalı; desteklenmeyen özellik ayrı belirtilmeli.
• Performans ve yanlış tespit incelemesi gerçek oyun senaryosuna dayanmalı.

QBCore ayarını ve veri sınırını belirleyin

configs/anticheat_config.lua içindeki mevcut ts.Framework.framework alanını qb olarak düzenleyin; bütün tabloyu silip tek alanla değiştirmeyin. ox_inventory kullanıyorsanız çalışan bağımlılık ve uyumluluk katmanını koruyun. Sunucu silah kontrolü çalışan ox_inventory’yi tercih eder; özel envanter uyarlamalarının API başarısızlığı oyuncunun silahsız olduğuna kanıt değildir.

Oyuncu ve ekonomi kabul testi

Köprü QBCore karakterlerini players tablosundaki citizenid ile, araçları player_vehicles üzerinden desteklenen alan ve indekslerle okur. Bu okuma tüm özel bankacılık tablolarını veya stash verisini kopyalamaz. Bağlantı ve çevrimiçi bakiye düzenleme varsayılan olarak açıktır; bunun için server.cfg satırı eklemezsiniz. Manuel mod kapalıyken eski tosun_db_bridge_enabled ve tosun_db_bridge_money_write satırları yok sayılır. Bakiyeyi yalnız yönetici (admin) veya sahip (owner) rolündeki panel kullanıcıları, karakter çevrimiçiyken ve beklenen bakiye eşleştiğinde ayarlayabilir; önce okumaları doğrulayın. Okuma ve düzenlemeyi bu sunucuda durdurmak için Sunucular → sunucu → Tosun Connect kartında Bağlantıyı kapat düğmesini kullanın. Gelişmiş: server.cfg’ye set tosun_db_bridge_manual "1" eklerseniz bu iki satır yeniden server.cfg’den okunur ve "1" yapılmayan her biri kapalı kalır; tek başına manual satırı bağlantıyı ve bakiye düzenlemeyi kapatır, manual "1" ile enabled "1" okumayı açık, bakiye düzenlemeyi kapalı tutar.

1. Bilinen meslek, nakit, banka ve aracı olan test karakteriyle bağlanın.
2. Bağlantı varsayılan olarak açıktır; panelden tek oyuncu ayrıntısını okuyun ve karakter ile değerlerin oyunla eşleştiğini doğrulayın.
3. Karakter değiştirip tekrar okuyun; önceki karakter veya eski source ile işlem yapılmadığını kontrol edin.
4. Ev, garaj, polis ekipmanı ve envanter eşyası olmadan verilen arena silahını test edin.
5. Özel ödül event’inde istemcinin keyfî miktar veya başka oyuncu seçemediğini scriptinizde doğrulayın.

Geri dönebileceğiniz bir kurulum hazırlayın

Çalışan sunucuda değişiklik yapmadan önce artifact sürümünü, framework ve envanter resource adlarını kaydedin. Paketi Sunucular bölümünde doğru sunucuyu seçerek indirin; başka sunucunun paketi veya lisansı yanlış bağlantı kurulmasına yol açabilir. Ücretli aboneliğinizi ve hesabınızın sunucu yönetim yetkisini kontrol edin. İndirdiğiniz ZIP dosyasını herkese açık bir dosya sitesine yüklemeyin.

1. Mevcut tosun-ac klasörünü, düzenlenebilir ayarları ve oyun veritabanını yedekleyin. Değiştirmeden önce yedeğe erişebildiğinizi doğrulayın.
2. Yeni paketi ayrı bir klasöre açın. fxmanifest.lua doğrudan tosun-ac içinde bulunmalı; iç içe ikinci bir tosun-ac klasörü oluşmamalı.
3. Düzenlediğiniz ayarları yeni varsayılanlarla karşılaştırın. Bilinçli değişiklikleri ve entegrasyonları taşıyın; yeni ayar dosyasının tamamını eski dosyayla değiştirmeyin.

Meşru ışınlamayı doğru anda bildirin

Hareketten önce oyuncuyu, sunucunun belirlediği hedefi, yetkiyi ve etkin işlemi doğrulayın. Aşağıdaki parçadaki gibi konumu değiştirmeden hemen önce MarkTeleport çağırın. src ve destination, rastgele istemci parametresinden değil mevcut doğrulanmış sunucu akışınızdan gelmelidir. Bu parça tek başına ağ event’i değildir.

MarkTeleport güven listesi istemez. Hareket ve ilgili görünmezlik/godmode/kamera kontrollerini kısa süre gevşetir; silah, para, event suistimali ve injection kontrolleri açık kalır. Varsayılan ayarlarla güvenilir olmayan çağıran için tek çağrı 15 saniye, oyuncu bütçesi on dakikada toplam 180 saniyedir. Tekrarlanan uzatmalar bütçeyi kullanır. Oyuncuyu sürekli muaf tutmak için her tick çağırmayın.

-- Mevcut, doğrulanmış sunucu işleminizin içinde:
local ok = exports["tosun-ac"]:MarkTeleport(src, 8000, "house_enter")
if ok then
    SetEntityCoords(GetPlayerPed(src), destination.x, destination.y, destination.z)
end

Tekrarlanabilir başlangıç ölçümü alın

Ayar değiştirmeden önce temsilî bir oyun oturumunda sunucu profili alın. Oyuncu sayısını, artifact ve resource sürümlerini, yapılan işlemleri kaydedin. Sakin rol, kalabalık garaj ve çatışma farklı yük üretir. Tek değişiklik yaptıktan sonra aynı tür oturumla karşılaştırın. Sunucu CPU süresi, hitch uyarısı ve sorgu davranışı sabit FPS artışı vaadinden daha yararlıdır.

Aşağıdaki komutlar sınırlı örnek kaydeder ve durumunu gösterir. Profili açmadan kaydın bitmesini bekleyin. Her takılmayı anticheat’e bağlamak yerine sıçramanın hangi resource ve thread’den geldiğini inceleyin. Değişen ayarı tam adıyla özel önce/sonra notuna yazın. Kısa kayıt, yoğun saatteki bütün yükü öngöremez.

profiler record 500
profiler status
profiler view

tosunac_doctor

Cezayı bağlama ve kanıta göre ayarlayın

Normal oyun test edilene kadar bağlama duyarlı kontrolleri uygun gözlem ayarında tutun. Kayıt, araştırılması gereken sinyaldir; eşleşen herkesi yasaklama talimatı değildir. Karakter seçimi, canlandırma, ışınlama, polis ekipmanı ve script silahlarını doğrulayın. Kalıcı ve geniş muafiyet yerine ilgili sunucu entegrasyonunu ekleyin.

Ayar doktoru ayarlar uygulandıktan sonra çalışır; tosunac_doctor ile elle çağrılabilir. Etkin riskli değerleri raporlar, kendisi değiştirmez. Ağır ceza, kapalı önlemler, debug ve fail-open uyarılarını değerlendirin. Panel değerleri yerel varsayılanı değiştirebilir; yalnız disk dosyasına değil gerçekten kullanılan ayara bakın.

Muafiyet veya daha hafif ceza, asıl neden çözülmeden görünen şikâyeti azaltabilir. Geçici istisnaların ve düzeltilmesi gereken scriptlerin tarihli listesini tutun. Entegrasyon doğrulanınca ilgili istisnayı kaldırın; kabul edilen oyun senaryosunu yeniden çalıştırın ve kayıtlarını önceki denemeyle karşılaştırın. Değişiklikten sonra yalnız şikâyet sayısına değil ölçülen yük ve tespit bağlamına bakın.

• Bir ayarı değiştirin; nedenini, inceleyeni ve eski değerini kaydedin.
• Tekrarlanan tespitleri meşru script işlemleri ve zamanlarıyla karşılaştırın.
• Ceza, framework veya envanter değişince ilgili oyun akışını tekrar test edin.
• Yeni yanlış tespitte eski değere dönün; tekrar sıkılaştırmadan önce nedeni çözün.

Güncelleme, geri dönüş ve destek kaydı

Core, envanter, meslek scripti veya AC güncellendiğinde ilgili kabul testini yeniden çalıştırın. Aynı anda şema, ceza ve kaynak sürümü değiştirmeyin. Sorun yeni değişiklikten kaynaklanıyorsa yedeklenmiş resource ve ayarlara planlı bakımda dönün; veritabanı geri yüklemesini veri kaybını değerlendirmeden yapmayın. Desteğe artifact/core/envanter/AC sürümü, resource adı, test adımları, saat ve anahtarsız ilk hata mesajını verin. Oyuncu kimliklerini, lisansları, parolaları ve token’ları açık kayıtta paylaşmayın.

İlgili kurulum ayrıntıları

Kurulum dokümanı · Veritabanı köprüsü · Server export rehberi

Sign upDokümantasyon Fiyatları gör

Sıkça Sorulan Sorular

İlgili: ESX · Standalone · vRP · OX/Qbox · Tüm Framework Rehberleri · RedEngine Tespiti