server.cfg, convar'lar ve izinler

Yapılandırma nerede bulunur#

Tosun AntiCheat ayarları server.cfg'den, resource içindeki dört dosyadan ve web panelden okur. Kimlik bilgileri yalnızca sunucuya özel yerlerde durmalıdır. configs/anticheat_config.lua paylaşılan bir scripttir; bu yüzden sunucu onu her istemciye gönderir.

• Kurulum
• Panel kurulumu
• Lisans anahtarı

Tam server.cfg örneği#

Tipik bir kurulum için eksiksiz bir blok. Sıra önemlidir: bağımlılıklar ve kimlik bilgisi convar'ları ensure tosun-ac'den önce gelmelidir, çünkü kimlik bilgileri resource yüklenirken bir kez çözülür. Tek # ile başlayan satırlar isteğe bağlıdır; kullanmak için # işaretini kaldırın.

## ---------- Tosun AntiCheat: server.cfg bloğu ----------
## OneSync bir manifest bağımlılığıdır (txAdmin de etkinleştirebilir).
set onesync on

## Bağımlılıklar: bunları tosun-ac'den önce başlatın.
## oxmysql ve tosun_render zorunlu bağımlılıklardır.
## screenshot-basic varsayılan ts.screenshotModule'dür.
## mysql_connection_string'i ensure oxmysql'den önce ayarlayın (MySQL rehberine bakın).
ensure oxmysql
ensure screenshot-basic
ensure tosun_render

## Kimlik bilgileri: set kullanın (asla setr veya sets değil) ve ensure tosun-ac'nin ÜSTÜNDE tutun.
## Resource yüklenirken bir kez okunurlar.
## Lisans biçimi: tac_live_ ve ardından 40 küçük harfli hex karakter.
set tosun_ac_license "YOUR_LICENSE_KEY"
## İsteğe bağlı: boşsa panel anahtarı oyun DB'sindeki panel_settings'ten yüklenir.
# set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
# set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
## İsteğe bağlı: yalnızca ts.licenseLock tarafından kullanılır.
# set tosun_ac_server_id "server-1"

## Korumalı AC export'larını çağırabilecek resource'lar (virgülle ayrılmış).
set tosun_ac_trusted_resources "my-housing,my-clothing"

## İsteğe bağlı: ekran görüntüsü ve kanıt yüklemeleri için herkese açık https panel adresi.
# set ts_public_panel_url "https://panel.example.com"

## İsteğe bağlı: Tosun Connect DB bridge'ini bu dosyadan yönetin.
## manual satırı olmadan (ve ts.panelMirror kapalıyken) iki bridge convar'ı da "1" değerine zorlanır.
# set tosun_db_bridge_manual "1"
# set tosun_db_bridge_enabled "1"
# set tosun_db_bridge_money_write "0"

## İsteğe bağlı: oynama süresi yazıcısını kapatın (yalnızca qb, qbcore ve qbox).
# set tosun_panel_playtime "0"

## İsteğe bağlı, bridge dosyalarını kullanan entegratörler için. İstemciler bunları okur, bu yüzden setr kullanın.
# setr tosun_ac_resource "tosun-ac"
# setr tosun_ac_bridge_client_ms "60000"

ensure tosun-ac

## ---------- Yetkili izinleri ----------
## Yetkili durumu ve oyun içi yetkili menüsü:
add_ace group.admin tosun.admin allow
## tosunac_setup, manuel taramalar ve ban ekranı önizlemesi:
add_ace group.admin tosunac.admin allow
add_ace group.admin command.tosunac_setup allow
add_ace group.admin command.tosunac_backdoorscan allow
add_ace group.admin command.tosunac_eventscan allow
add_ace group.admin tosunac.banscreen.test allow
## Her yetkili için bir satır:
add_principal identifier.license:YOUR_LICENSE_HEX group.admin

## ---------- AC'nin başlangıçta kontrol ettiği FiveM sıkılaştırma convar'ları ----------
set sv_stateBagStrictMode true
set sv_filterRequestControl 2
set sv_enableNetworkedSounds false
set sv_enableNetworkedPhoneExplosions false
set sv_enableNetworkedScriptEntityStates false
set sv_scriptHookAllowed false
## Önce test edin: relaxed veya strict, istemciden araç spawn eden scriptleri bozabilir.
set sv_entityLockdown relaxed
set sv_pureLevel 1
## server.cfg denetimi bu boş olduğu sürece uyarı verir:
# set sv_enforceGameBuild YOUR_GAME_BUILD

• MySQL kurulumu
• Kurulum rehberi

server.cfg bloğu için kurallar#

Örneği sunucunuza uyarlarken bu kurallara uyun.

• oxmysql ve tosun_render'ı tosun-ac'den önce başlatın. Manifest; 4890 veya daha yeni sunucu build'ini, OneSync'i, oxmysql'i ve tosun_render'ı bağımlılık olarak bildirir.
• Varsayılan ts.screenshotModule'ü kullanıyorsanız screenshot-basic'i başlatın.
• Tüm set tosun_ac_ kimlik bilgisi satırlarını ensure tosun-ac'den önce koyun. Değerler yüklenirken bir kez okunur; sonradan yapılan bir değişiklik resource'un yeniden başlatılmasını gerektirir.
• Kimlik bilgileri için set kullanın. setr değeri her istemciye kopyalar, sets ise onu herkese açık sunucu bilgisinde yayınlar.
• setr'ı yalnızca istemcilerin okuduğu convar'lar için kullanın: ts_screen_upload, tosun_ac_resource ve tosun_ac_bridge_client_ms.
• DB bridge satırına gerek yoktur. 9.6.14'ten beri bridge varsayılan olarak açıktır ve tosun_db_bridge_manual "1" değilse veya ts.panelMirror.enabled = true değilse set ... "0" satırları yok sayılır.
• Eski kurulum rehberleri (INSTALLER-READY.md, INSTALLER-LICENSE.md, INSTALL-MULTILANG.md, CONFIG-PERFORMANCE-GUIDE.md) ensure'u kimlik bilgilerinden önce koyar, panel anahtarını configs/anticheat_config.lua içine yazar ve tosun_render'ı atlar. Bunun yerine bu sayfayı izleyin.

Convar referansı#

Tosun AntiCheat'in okuduğu ve ayarlayabileceğiniz tüm convar'lar. Notlar sütununda setr yazmıyorsa set kullanın. AC ayrıca kendine ait birkaç dahili convar yazar ve okur; bunlar korumalıdır ve ayarlamamalısınız.

Kimlik bilgileri: öncelik ve kullanım#

Üç kimlik bilgisi resource yüklenirken bir kez çözülür: lisans anahtarı, panel API anahtarı ve merkezi token. Her biri için AC bu sıradaki ilk boş olmayan değeri alır.

MIGRATION uyarısı, paylaşılan değeri temizlemenizi ve orada hiç saklanmış her kimlik bilgisini yenilemenizi ister, çünkü o dosya her istemciye gönderilir.

4096 karakterden uzun veya kontrol karakteri içeren bir değer, yüklemeyi Invalid server credential setting hatasıyla durdurur.

Yalnızca panel anahtarı: bu adımlardan sonra hâlâ boşsa AC, oyun DB'sinden panel_settings.ac_api_key'i kopyalar. AC her başlangıçta çözülen anahtarı ac_settings içindeki webPanelKey satırına düz metin olarak yazar. Biri panelde bu satırı düzenlerse, düzenlenen değer bir sonraki yeniden başlatmaya kadar sizinkinin yerine geçer.

Yalnızca lisans anahtarı: lisans kilidi tac_live_ artı 40 küçük harfli hex (49 karakter), TOSUN-AC-YYYY-... ve TOSUN-... biçimlerini kabul eder. Biçim kontrolü yalnızca ts.licenseLock.enabled = true iken çalışır ve yalnızca biçimi kontrol eder.

1. Sunucu convar'ı: tosun_ac_license, tosun_ac_panel_key veya tosun_ac_central_token.
2. configs/anticheat_server.lua içindeki değer: licenseKey, panelKey veya centralToken.
3. Paylaşılan configs/anticheat_config.lua içindeki eski değer: ts.licenseLock.licenseKey, ts.webPanelKey veya ts.Central.token. Burada herhangi bir değer olması konsola bir MIGRATION uyarısı yazdırır.

• Lisans anahtarı

configs/anticheat_server.lua#

Kimlik bilgilerini server.cfg'ye yazmak istemiyorsanız bu yalnızca sunucuya ait dosyayı kullanın. AC'nin sunucu scriptlerinden önce yüklenir ve istemcilerde hemen döner. Convar'ı veya veritabanından bulmayı kullanmaya devam etmek için bir alanı boş bırakın.

• Boş olmayan bir convar her zaman bu dosyadaki değere göre önceliklidir.
• configs/anticheat_config.lua içindeki karşılık gelen alanları boş tutun: ts.webPanelKey, ts.Central.token ve ts.licenseLock.licenseKey.
• Bu dosyanın yedeklerini gizli tutun.
• Dosya yalnızca ts.webPanelKey, ts.Central.token ve ts.licenseLock.licenseKey değerlerini doldurur. Diğer scriptler dosyayı değil, bu değerleri okur.

-- configs/anticheat_server.lua (yalnızca sunucu)
local credentials = {
    panelKey = '',     -- veya: set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
    centralToken = '', -- veya: set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
    licenseKey = '',   -- veya: set tosun_ac_license "YOUR_SERVER_LICENSE"
}

Panel URL'si ve ekran görüntüsü yüklemeleri#

configs/anticheat_config.lua içindeki ts.webPanelURL panel taban URL'sidir. Boş bırakabilirsiniz: boşsa AC, oyun DB'sindeki panel_settings'ten panel_url veya site_url'i yükler ve ac_settings'e kaydeder. HTTP ayar senkronu yalnızca hem URL hem de panel anahtarı ayarlıyken çalışır.

ts_public_panel_url'i yalnızca ekran görüntüleri, ban kanıtları ve canlı video farklı bir herkese açık adrese gitmesi gerekiyorsa ayarlayın. https olmalıdır. Yükleme token'ları yalnızca taban bu convar'a veya ts.webPanelURL'e eşitse https://host/api/screen_upload.php için verilir.

ts_screen_upload, screenCapture export'u ve /capture ve /ts_capture komutlarının kullandığı ayrı bir yoldur. setr gerektirir ve varsayılan değeri localhost'u gösterir. AC'deki hiçbir şey bu yüklemenin sonucunu işlemez.

Eski ts.PanelUrl, ts.panelUrl ve ts.webPanelUrl adları hâlâ yedek olarak okunur.

• Panel kurulumu

Tosun Connect DB bridge convar'ları#

9.6.14'ten beri isteğe bağlı DB bridge varsayılan olarak açıktır ve server.cfg satırı gerektirmez. Yükleme sırasında editable/server/tosun_db_bridge_defaults.lua, tosun_db_bridge_enabled ve tosun_db_bridge_money_write değerlerini "1" yapar; bu yüzden eski rehberlerdeki "0" satırları yok sayılır.

Bağlantıyı panelden tek bir sunucu için de kapatabilirsiniz: Sunucular, ardından sunucu, ardından Tosun Connect kartı.

Bridge https://admin.tosundev.com/api/server_db_bridge.php adresini yoklar, lisans anahtarınızı Bearer token olarak gönderir ve yalnızca şu işlemleri çalıştırır: players.list, player.detail, player.vehicles, bans.list, logs.list ve player.money.set.

ts.panelMirror.enabled = true iken AC bridge'i açmaya zorlamaz; böylece eski mirror çalışmaya devam eder. tosun_db_bridge_enabled "1" iken mirror'ın kendisi çalışmaz.

tosunac_db_status ve tosunac_db_check konsol komutları bridge durumunu gösterir ve oxmysql'i test eder.

1. Bridge'i server.cfg'den yönetmek için ensure tosun-ac'den önce set tosun_db_bridge_manual "1" ekleyin.
2. "1" veya "0" değeriyle set tosun_db_bridge_enabled ekleyin.
3. "1" veya "0" değeriyle set tosun_db_bridge_money_write ekleyin. "1" olmadan player.money.set write_disabled ile başarısız olur ve panele sunulmaz.

• MySQL kurulumu

Script geliştiricileri için convar'lar#

Bu convar'lar yalnızca başka bir resource AC'yi çağırdığında önemlidir. tosun_ac_trusted_resources hangi resource'ların korumalı export'ları çağırabileceğine karar verir; bridge convar'ları isteğe bağlı bridge dosyalarını yapılandırır.

Korumalı export'lar arasında SetExempt, SetPlayerExempt, Pause export'ları, BypassDetection, addAdmin, whitelistPlayer, approveResource, ban, offlineBan, webBridge export'ları ve quarantine bulunur.

Sunucu konsolu ve tosun-ac'nin kendisi her zaman güvenilirdir. Güvenilmeyen bir çağrı reddedilir; her resource ve export çifti için AC, bu convar'ın adını veren bir konsol uyarısı ve bir panel log satırı yazar. ts.EnforceExportCallerWhitelist = false iken çağrı çalışır ve yalnızca bir kez loglanır.

Güvenilen çağıranlar MarkTeleport'u oyuncu başına bütçe olmadan da kullanır.

INTEGRATION.md ve bridge/INTEGRATION.txt, tosun_ac_resource ve tosun_ac_bridge_client_ms için set gösterir. Bunun yerine setr kullanın: istemci bridge'i ikisini de istemcide okur.

Dahili AC event'leri ve export'ları da vardır. Bunlar korumalıdır ve resource'larınızdan çağrılmamalıdır.

# Korumalı export'ları çağırabilecek resource'lar (virgül veya boşlukla ayrılmış)
set tosun_ac_trusted_resources "my-housing,my-clothing"

# Kendi resource'unuzun içindeki bridge dosyaları
setr tosun_ac_resource "tosun-ac"
setr tosun_ac_bridge_client_ms "60000"
set tosun_ac_bridge_server_ms "60000"
set tosun_ac_bridge_cooldown_ms "750"

• Export'lar
• Export referansı
• Event'ler

ACE izinleri#

Tosun AntiCheat'in kontrol ettiği tüm ACE'ler. ACE'leri bir gruba verin ve yetkilileri add_principal ile gruba ekleyin. builtin.everyone'ın da sahip olduğu bir ACE hiç kimseyi yetkili yapmaz.

• Komutlar

Kısıtlı ve yalnızca konsol komutları#

AC'nin on komutu kısıtlı olarak kaydedilir. Oyunda FiveM, AC'nin kendi kontrolüne ek olarak eşleşen komut ACE'sini ister. Bu on komutun beşi oyuncuları tamamen yok sayar.

banscreentest kısıtlı değildir. Konsoldaki banscreentest playerId biçimi ACE gerektirmez; oyun içi /banscreentest tosunac.banscreen.test veya tosunac.admin gerektirir. tosunac_setup, iki tarama ve banscreentest retleri sessizdir.

Backdoor veya imza taraması bitmezse tosunac_setup hiçbir şeyi onaylamaz; ts.BackdoorGuard kapalıyken de durum budur. Biri sürerken ikinci bir çalıştırma reddedilir.

• Komutlar

Yetkili nasıl tanınır#

AC'nin iki ayrı erişim seviyesi vardır. Yetkili durumu ceza muafiyeti ve yetkili komutlarını (/ts alt komutları ve ts_ komutları) verir. Menü erişimi oyun içi yetkili menüsünü açar. Bazı kaynaklar bunlardan yalnızca birini verir.

Yetkililer için ceza muafiyeti yalnızca ts.AdminBypassDetections = true (hazır değer) ve ts.Debug = false (hazır değer) iken geçerlidir.

Menü erişimi ayrıca ts.AdminMenu.enable ve ts.AdminMenu.enabled değerlerinin true kalmasını gerektirir. Biri false olduğunda menü, F7 tuşu ve istemci yetkili aracı komutları kaydedilmez.

Yetkili durumu olup menü erişimi olmayan yetkililer, örneğin yalnızca txAdmin yetkilileri, yine de F7'ye basabilir. İstek reddedilir ve loglanır.

• Komutlar

Kimlik listeleri: Admins, allowedIds ve AdminBypassIdentifiers#

license:, steam:, discord: veya fivem: değerleri gibi tam kimlikler kullanın. Yetkililer için admins/anticheat_admins.lua'yı veya panel izinlerini tercih edin: o dosya yalnızca sunucuya aittir, configs/anticheat_config.lua ise her istemciye gönderilir.

• Admins: bir girdi tam kimlikle (büyük/küçük harf duyarsız) veya önekten sonraki kısımla eşleşir. Yetkili durumu ve menü verir.
• ts.AdminMenu.allowedIds: yetkili durumu ve menü. "all" ve "staff" değerleri hiçbir şey vermez.
• ts.AdminBypassIdentifiers: yalnızca yetkili durumu ve muafiyet, menü yok.

-- admins/anticheat_admins.lua (yalnızca sunucu)
Admins = {
    "license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "steam:11000010xxxxxxxx",
    "discord:123456789012345678",
}

-- configs/anticheat_config.lua (paylaşılan, istemcilere gönderilir)
ts.AdminMenu = {
    -- diğer menü anahtarları hazır geldiği gibi kalır
    allowedIds = {
        "license:YOUR_EXACT_PLAYER_IDENTIFIER",
    },
}
ts.AdminBypassIdentifiers = {}  -- yetkili durumu ve muafiyet, menü yok

Panel izinleri ve addAdmin export'u#

Panel izinleri, web panelde oluşturduğunuz ac_v7_admin_grants satırlarıdır. Aktif bir izin, oyuncunun license veya license2 değeriyle önekli veya öneksiz eşleşir ve yetkili durumu ile menü erişimi verir.

Olumlu yanıt 5 sn, olumsuz yanıt 30 sn önbellekte tutulur; bu yüzden yeni bir izin, daha önce kontrol edilmiş bir oyuncuya uygulanması 30 sn'ye kadar sürebilir.

Güvenilen bir resource, removeAdmin çağrılana kadar bir oyuncuya yetkili durumu ve menü erişimi vermek için addAdmin export'unu çağırabilir. ts.EnforceExportCallerWhitelist true iken çağıran tosun_ac_trusted_resources veya ts.ExportCallerWhitelist içinde listelenmiş olmalıdır.

• Panel kurulumu
• Export'lar

Oyuncu whitelist'i yetkili demek değildir#

Panel oyuncu whitelist'i (ac_whitelist) ve whitelist export'larıyla çalışma sırasında eklenen kimlikler yalnızca cezaları durdurur. Yetkili komutları veya yetkili menüsü vermezler.

• Bir satır, expires_at boş veya gelecekte olduğu sürece geçerlidir.
• Kabul edilen değerler: license, discord, steam veya fivem kimliği ya da bir citizenid. Önekler kaldırılır.
• Çalışma zamanı girdileri bellekte tutulur ve yeniden başlatmada kaybolur.
• ts.Debug = true iken iki liste de yok sayılır.

Yetkili davranışını değiştiren ayarlar#

configs/anticheat_config.lua içindeki bu anahtarlar, yetkililerin ve yetkisiz menü kullanıcılarının nasıl ele alınacağını değiştirir.

builtin.everyone ve bağlantı anındaki IP kontrolü#

Tüm yetkili ve menü ACE kontrolleri, builtin.everyone'ın da sahip olduğu bir ACE'yi yok sayar. Bu yüzden add_ace builtin.everyone command allow oyuncuları yetkili yapmaz. Bağlantı anındaki IP kontrolü ise farklı çalışır.

ts.v12.bypassStaffIpCheck false olmadığı sürece, bağlanan bir oyuncu şu durumlardan herhangi birinde ülke engel listesini ve VPN, proxy ve hosting retlerini atlar: oyuncu yetkilidir; oyuncuda command, txadmin, tx.admin, txadmin.menu, command.kick, command.ban ACE'lerinden biri ya da group.admin, group.superadmin, group.moderator veya group.god adlarından biri vardır; veya aktif bir panel izni oyuncunun license'ıyla tam olarak eşleşir.

Bu kontrol, builtin.everyone filtresi olmayan düz ACE testleri kullanır. Bu yüzden add_ace builtin.everyone command allow olan bir sunucuda her oyuncu VPN ve ülke kontrollerini atlar. Giriş seli (join-flood) kontrolü ise istisnadan önce yine çalışır.

Discord webhook dosyası#

configs/anticheat_webhooks.lua yalnızca sunucuya aittir. Her log kanalı için bir Discord webhook URL'si ve embed stilini tutar. Tüm URL'ler WEBHOOK_URL_BURAYA yer tutucusuyla gelir.

• Panel HTTP senkronu, boş olmayan bir URL gönderdiği her webhook'un üzerine yazar.
• Diğer resource'lar webhook URL'lerini getConfig('webhooks') ile yalnızca güvenilen çağıranlarsa alır.
• Ekran görüntüsü logları Detections embed'ini çözülen ceza yerine ts.punishType ile etiketler ve ts.punishType BAN olduğunda Webhooks.Bans'e de gönderir.
• Webhooks.WebhookAvatar embed avatar görselini ayarlar.

Webhooks.Detections    = "https://discord.com/api/webhooks/..."
Webhooks.Bans          = "https://discord.com/api/webhooks/..."
Webhooks.AdminMenuLogs = "https://discord.com/api/webhooks/..."
Webhooks.Connections   = "https://discord.com/api/webhooks/..."
Webhooks.OCR           = "https://discord.com/api/webhooks/..."
Webhooks.Commands      = "https://discord.com/api/webhooks/..."
Webhooks.MoneyLogs     = "https://discord.com/api/webhooks/..."
Webhooks.ResourceLogs  = "https://discord.com/api/webhooks/..."

Webhooks.WebhookUsername = "Tosun AntiCheat"
Webhooks.WebhookColor    = 15285208
Webhooks.WebhookInlines  = true

Panel config dosyasını nasıl ezer#

configs/anticheat_config.lua içindeki değerlerin çoğu varsayılandır. Web panel kendi değerlerini ac_settings ve diğer ac_ tablolarında tutar ve öncelik bu değerlerdedir. Dosyayı yalnızca panelin yönetmediği değerler için düzenleyin.

• Başlangıçtan yaklaşık 3 sn sonra ve ardından her ts.ServerPerf.configSyncIntervalSec saniyede bir (hazır değer 120, en az 20, yedek 60) ac_settings satırları ts değerlerinin üzerine yazar.
• AdminMenu.enable gibi noktalı anahtarlar iç içe alanlara yazar. framework veya moneyCheck gibi eski düz anahtarlar önce eşlenir.
• punishment_ anahtarı o tespit için ts.DetectionPunishments'a yazar. BAN ve KICK korunur; diğer her değer LOG olur.
• İşlem alanları ban, kick, log, cancel, reject veya stop olarak normalleştirilir. Diğer her değer log olur.
• globalBan. ile başlayan anahtarlar yok sayılır.
• Panel listeleri config listelerinin yerine geçer: silahlar, araç kara listesi, plakalar, trigger listesi, event sınırları, whitelist'teki resource'lar, OCR kelimeleri, Blacklist listeleri, patlama listesi ve entity whitelist'leri. Veritabanından gelen whitelist'teki resource'lar ve OCR kelimeleri ise birleştirilir.
• İstisna: ts.EventLimiter ve ts.ProtectedEvents handler'ları yüklenirken dosyadan bir kez kaydedilir. Sonraki panel değişiklikleri bunlar için sunucu tarafı denetimi değiştirmez.
• Bir değişiklikten sonra istemcilere yalnızca istemci için güvenli anahtarlar yeniden gönderilir.
• Panel senkronundan sonra riskli değerleri gözden geçirmek için konsolda tosunac_doctor çalıştırın.

• Yapılandırma ve performans
• Panel kurulumu

Temel ayarlar#

configs/anticheat_config.lua'nın başına yakın üst düzey anahtarlar. Çoğu panelden de ayarlanabilir.

Yapılandırma bölümleri: tespitler ve cezalar#

Neyin tespit edileceğine ve ne kadar sert cezalandırılacağına karar veren bölümler.

Yapılandırma bölümleri: sunucu tarafı korumalar#

Sunucuda çalışan korumalar. Birkaçı önce event'i iptal eder ve yalnızca tekrarlanan ihlallerden sonra cezalandırır.

Yapılandırma bölümleri: bağlantı, yetkili ve panel#

Giren oyuncular, yetkili menüsü, panel bağlantısı ve sunucu geneli davranış için bölümler.

Yapılandırma bölümleri: resource'lar, event'ler ve entegrasyon#

Resource güveni, tarayıcılar ve geliştirici entegrasyonu için bölümler. Geliştiriciler için işaretli satırlar yalnızca kendi scriptleriniz AC'yi çağırdığında önemlidir.

• Export'lar
• Event'ler
• Framework

Yapılandırma bölümleri: listeler#

configs/anticheat_config.lua içindeki varsayılan listeler. Çoğu, senkron sırasında panel tablolarıyla değiştirilir.

Hiçbir şey yapmayan anahtarlar ve dosyada olmayan anahtarlar#

configs/anticheat_config.lua içindeki bazı anahtarlar 9.6.15'teki kod tarafından okunmaz. Bunları değiştirmenin hiçbir etkisi yoktur.

Kod, dosyada bulunmayan anahtarları da okur. Gerekirse bunları kendiniz ekleyin: ts.v12.joinFloodWindowSec (60), ts.v12.joinFloodMaxJoins (6), ts.v12.bannedCountries (ülke kodları; coğrafi engel listesi), ts.v6Enforcement.heuristic (sezgisel türlerin listesinin yerine geçer), ts.LiveWatch.fps (30), ts.SafeEventMaxArgs (64) ve ts.DetectionExempt sunucu event'lerinde always = true.

Şu istemci anahtarları okunur ama dosyada yoktur ve false yapılmadıkça açıktır: ts.antiScreenshotBypass, ts.antiRateOfFire ve ts.antiNetOwnership. ts.microJitterMeanMin (0.5) de okunur ama dosyada yoktur.

• ts.NetworkJoin.minimalSync
• ts.AdminMenu.espMaxDistance ve ts.AdminMenu.screenshotTimeout (ESP espMaxDist kullanır)
• ts.AdminMenu.permissionLevel (eski bir etiket; erişim ACE'lerden, listelerden ve izinlerden gelir)
• ts.ResourceGuard.strictClientDiff
• ts.LiveWatch.enabled, preferTosunRender ve maxConcurrent
• ts.PhoneNotify.enabled, onBan ve onDetect

Config dosyasındaki güncel olmayan yorumlar#

configs/anticheat_config.lua içindeki birkaç yorum eski davranışı anlatır. Kod şu şekilde çalışır.

• Yorum panel ayarlarının her 30 sn'de yeniden senkronlandığını söyler. Aralık ts.ServerPerf.configSyncIntervalSec'tir (hazır 120 sn).
• Yorum tosunac_setup'ın event'leri whitelist'e aldığını söyler. Yalnızca kataloglar; korumaya ts.EventScanner.autoProtect karar verir.
• ts.ProtectedEvents yorumu framework event'lerinin hatalı banlara yol açtığı konusunda uyarır. Anahtarsız çağrılar reddedilir ve loglanır, asla cezalandırılmaz.
• ts.EventLimiter yorumu sınır aşıldığında tetiklendiğini söyler. Sayı değere ulaştığında tetiklenir.
• Bridge yorumu dört bridge convar'ının hepsi için setr önerir. Yalnızca tosun_ac_resource ve tosun_ac_bridge_client_ms setr gerektirir.
• ts.Locale yorumu ar'ı atlar, ama locales/ar.json pakette gelir.

AC'nin kontrol ettiği FiveM sıkılaştırma convar'ları#

İki modül başlangıçta FiveM convar'larını okur. Convar koruması (ts.hardening) başlangıçtan yaklaşık 8 sn sonra çalışır ve ayarlanmamış bir değeri zayıf sayar. server.cfg denetimi (ts.cfgAudit) başlangıçtan 15 sn sonra çalışır ve salt okunurdur.

Sıkılaştırma anahtarları ve çıktısı#

İki kontrol de varsayılan olarak yalnızca rapor verir. Bunları configs/anticheat_config.lua içinde değiştirin.

• ts.hardening.enabled = false convar korumasını atlar.
• ts.hardening.autoApply = true (hazır false), AC'nin altı güvenli convar için set'i kendisinin çalıştırmasını sağlar. sv_entityLockdown ve sv_pureLevel asla otomatik uygulanmaz.
• ts.cfgAudit.enabled = false server.cfg denetimini kapatır.
• Convar koruması bir konsol uyarısı yazar ve tüm zayıf convar'ları listeleyen bir ac_detections satırı (detection_type hardening_missing) ekler.
• Denetim bir konsol uyarısı yazar ve zayıf ayar sayısını içeren bir admin_logs satırı ekler.
• İki kontrolün konsol metni de koda gömülü Türkçedir. Her koruma uyarı satırı eklenecek tam set satırını gösterir.
• tosunac_doctor, FiveM convar'ları hakkında değil, riskli AC ayarları hakkında ayrı bir konsol raporudur.

Sık yapılan hatalar#

Destek talebi açmadan önce bunları kontrol edin.

• setr veya sets ile ayarlanan kimlik bilgileri: her istemciye veya herkese açık sunucu bilgisine ulaşırlar.
• ensure tosun-ac'den sonra yazılan kimlik bilgileri: bir sonraki resource yeniden başlatmasına kadar okunmazlar.
• configs/anticheat_config.lua içinde panel anahtarı: dosya istemcilere gönderilir ve konsol bir MIGRATION uyarısı yazar.
• tosun_render başlatılmamış: zorunlu bir bağımlılıktır.
• ESX veya Qbox sunucusunda ts.Framework.framework'ün "qb" olarak bırakılması.
• Türkçe kullanmayan bir sunucuda ts.Locale'in "tr" olarak bırakılması.
• ts.appealDiscord'un geliştiricinin Discord bağlantısında bırakılması.
• ts.punishType'ın LOG veya KICK yapılması: elle verilen banlar da log veya kick'e dönüşür.
• add_ace builtin.everyone command allow: her oyuncu VPN ve ülke kontrollerini atlar.
• tosun.admin'in tosunac_setup'ı açmasını beklemek: bunun için tosunac.admin ve command.tosunac_setup gerekir.
• txAdmin yetkililerinin AC menüsünü açabilmesini beklemek: txAdmin ACE'leri yalnızca yetkili durumu verir. tosun.admin veya bir panel izni ekleyin.
• tosun_db_bridge_manual "1" olmadan set tosun_db_bridge_enabled "0": satır yok sayılır.
• ts.Debug'ın true bırakılması: yetkili ve whitelist istisnaları kapalıdır.

• Başlangıç
• Komutlar