Export referansı

Bir export'u çağırma#

Sunucu export'larını resource'unuzun sunucu scriptlerinden, istemci export'larını da istemci scriptlerinden çağırın. Resource adı tire içerdiği için her zaman köşeli parantez biçimini kullanın: exports['tosun-ac']. exports.tosun-ac biçimi geçerli Lua değildir.

• Sunucu id'lerini sayı olarak verin. Birkaç export id'yi doğrudan tablo anahtarı olarak kullanır.
• Bazı export'lar senkron bir veritabanı sorgusu çalıştırır ve yield eder. Bunları bir thread'den veya event handler'dan çağırın: getBans, getBanInfo, GetDetections, isAdmin ve diğer yetkili kontrolleri, IsExemptFromPunish, ForensicLinksOf ve refreshPanelWhitelist. scanAllResources ve scanSingleResource da yield eder.
• Resource'unuzu reddeden korumalı bir export, normalde nil döndürse bile false döndürür.
• Bazı export'lar yalnızca ilgili özellik açıkken vardır (bkz. Özelliğe bağlı export'lar). Kayıtlı olmayan bir export'u çağırmak hata fırlatır; bu yüzden bu çağrıları pcall içine alın.
• Birkaç export fxmanifest.lua içindeki export listelerinde yoktur (örneğin MarkTeleport, punish ve AllowWeapon). Bu listeler yalnızca bilgi amaçlıdır; export'lar çalışır.
• Aşağıdaki tablolarda çağıran resource'un güvenilir olması gerekiyorsa son sütunda Evet yazar. Bkz. Güvenilen resource'lar.

-- kendi resource'unuzdaki sunucu scripti
local status = exports['tosun-ac']:GetIntegrationStatus()
if not status.trusted then
    print(status.hint) -- server.cfg'ye eklenecek satır
end

-- AC'ye ışınlanmayı bildir, sonra oyuncuyu taşı
exports['tosun-ac']:MarkTeleport(src, 8000)
SetEntityCoords(GetPlayerPed(src), x, y, z)

-- kendi resource'unuzdaki istemci scripti
exports['tosun-ac']:SetExempt(true, 60000, 'my_menu')

• Entegrasyon rehberi
• Sunucu yapılandırması

Güvenilen resource'lar#

Güven sütununda Evet ile işaretli export'lar muafiyetleri, yetkili haklarını, banları, oyuncu canını, silahları veya envanteri, karantinayı, resource'ları ve imzaları ya da tüm sunucuyu değiştirir. Yalnızca güvenilen bir resource'tan gelen çağrıları kabul ederler. Reddedilen bir çağrı hiçbir şey yapmaz ve false döndürür.

Çağıran şu durumlarda güvenilirdir: sunucu konsolu, tosun-ac'nin kendisi, config'teki ts.ExportCallerWhitelist içinde listelenen bir resource veya tosun_ac_trusted_resources convar'ında listelenen bir resource. Varsayılan config listesi qbx_core, qb-core, es_extended, ox_inventory ve ox_lib'dir.

Convar'ı tercih edin. server.cfg içinde durur ve AC güncellemelerinden etkilenmez; config dosyasındaki düzenlemeler ise AC'yi güncellediğinizde kaybolabilir. Adları virgül veya boşlukla ayırın. Güven listesi 10 saniye önbellekte tutulur; bu yüzden çalışma sırasında yapılan bir değişiklik 10 saniye içinde geçerli olur.

Her resource ve export çifti için ilk retten sonra AC, sunucu konsoluna eklenmesi gereken tam server.cfg satırını içeren bir uyarı yazar ve panel loglarına bir satır ekler. Panel log satırı her zaman Türkçedir.

Denetim modu: ts.EnforceExportCallerWhitelist = false iken güvenilmeyen çağrılar çalışır ve her resource ve export çifti sunucu konsoluna bir kez yazılır (panel log satırı yoktur). Varsayılan değer true'dur. Denetim modunu yalnızca kurulum sırasında, hangi scriptin neyi çağırdığını görmek için kullanın.

Uygulama modunu, güvenilen resource'ları kaynaklarıyla (config veya convar) ve son 20 reddedilen çağrıyı yazdırmak için sunucu konsolunda tosunac_integration çalıştırın. Bir scriptten GetIntegrationStatus() çağırın.

Güven ayrıca MarkTeleport bütçesini kaldırır: güvenilen resource'lar oyuncu başına süre sınırı olmadan ışınlanma işaretleyebilir.

Tosun AC kendi iç işleyişi için (panel köprüsü, imzalama, tarama, lisanslama, toplu yazma) dahili export'lar ve net event'ler de kaydeder. Bunlar bu referansın parçası değildir ve desteklenen bir API değildir. Bazıları güven kontrolüyle veya dahili bir çağıran kontrolüyle korunur. Bunları çağırmayın.

# server.cfg
set tosun_ac_trusted_resources "my-housing,my-clothing"

• Sunucu yapılandırması
• Konsol komutları

Entegrasyon ve muafiyetler#

Scriptlerinizdeki meşru işlemleri AC'ye bildiren ve bir oyuncunun muaf olup olmadığını okuyan sunucu export'ları.

Muafiyet seçimi#

Scriptinizi kapsayan en dar muafiyeti kullanın. Birkaç muafiyet aynı istemci muafiyet bayrağını paylaşır, bu yüzden biri diğerini bitirebilir: alan adıyla çağrılan ClearArea, SetPlayerExempt, MarkTeleport ve BypassDetection'ın da ayarladığı bayrağı sıfırlar.

Yetkililer ve izinler#

AC'nin kimi yetkili saydığını okuyun ve değiştirin. Yetkili kontrolleri veritabanını sorgulayabilir; bu yüzden bunları bir thread'den veya event handler'dan çağırın.

isAdmin şu durumlarda true döndürür: elle verilmiş bir addAdmin izni; txadmin, tx.admin, txadmin.menu, txadmin.advanced, command.txadmin, command.ts, command.ban, command.kick, tosun.admin, ts.admin ACE'leri ve ts.AdminBypassAces içindeki herhangi biri; group.admin, group.superadmin, group.moderator ve group.god principal'ları; ts.txAdminAuth açıkken command.kick/ban/resources/restart; admins.lua, ts.AdminMenu.allowedIds ve ts.AdminBypassIdentifiers içindeki kimlikler; ve veritabanındaki panel izinleri. builtin.everyone'a da verilmiş bir ACE sayılmaz.

isAdmin ve addAdmin kaynak kodda iki kez kaydedilir. anticheat_server.lua içindeki sürümler en son yüklenir ve çalışan onlardır; bu referans onları anlatır.

Oyuncu whitelist'i ve alanlar#

Sunucu id'si whitelist'i, kimlik whitelist'i ve adlandırılmış alanlar. Çalışma zamanı listeleri yalnızca bellekte tutulur ve yeniden başlatmada kaybolur; panel whitelist'i ayrıdır.

Cezalar ve banlar#

Oyuncuları AC hattı üzerinden cezalandırın, çevrimdışı oyuncuları banlayın ve banları okuyun. Buradaki tüm yazma export'ları güven gerektirir.

• Event'ler

punish() cezayı nasıl seçer#

punish(), ban() ve BanPlayerExt() tek bir hattı paylaşır. İzlediği sıra şudur.

1. ts.AdminBypassDetections false değilse yetkililer atlanır. Aktif muafiyeti olan veya çalışma zamanı ya da panel whitelist'inde olan oyuncular atlanır. ts.Debug bu atlamaları kapatır. Atlanan çağrılar hiçbir şey yapmaz ve hiçbir şey loglamaz.
2. Oyuncu çevrimiçi olmalıdır. Değilse sunucu konsoluna bir hata yazılır ve hiçbir şey olmaz.
3. Ceza: geçerli bir punishment argümanı önceliklidir. Yoksa sırasıyla ts.DetectionPunishments[configKey], onun takma adı, tespit anahtarı, ts.punishType ve son olarak BAN.
4. Her sonuç ts_anticheat:playerBanned sunucu event'ini tetikler, ts.chatMessages açıksa bir sohbet mesajı gönderir, bir bulut ihlali ekler ve AC logunu ve canlı logu yazar.
5. LOG: ekran görüntüsü logunu Discord'a gönderir.
6. KICK: ts.AdminBypassDetections'tan bağımsız olarak yetkiliyi yeniden kontrol eder; bu yüzden yetkililer asla atılmaz. Ardından ekran görüntüsü logunu gönderir ve oyuncuyu sunucudan atar.
7. BAN: banı, saat cinsinden ts.BanDurations'tan alınan süreyle (configKey, takma ad, tespit anahtarı, önek, sonra default; 0 = kalıcı) ve 'anticheat:' artı anahtardan oluşan bannedBy ile ekler. ts_anticheat:banCommitted'i tetikler, paneli bilgilendirir ve oyuncuyu sunucudan atar (3 sn sonra yeniden denenir).

exports['tosun-ac']:punish(src, 'Money exploit', nil, 'my_shop_exploit', 'BAN')

Tek bir oyuncunun moderasyonu#

Tek bir oyuncu üzerinde işlem yapın. Güven sütununu dikkatle okuyun: bunların birkaçında güven kontrolü yoktur.

Sunucu geneli işlemler#

Tüm oyuncuları veya her yeni bağlantıyı etkileyen işlemler.

Karantina ve veri koruması#

Şüpheli bir oyuncuyu izole edin ve kendi net event'lerinizi çökertme verilerine ve spam'e karşı koruyun.

RegisterNetEvent('myres:buy', function(data)
    local src = source
    if not exports['tosun-ac']:RateLimit(src, 'myres:buy', 5, 10000) then return end
    if exports['tosun-ac']:crashGuardReject(src, data) then return end
    -- satın almayı işle
end)

Oyuncular ve tespitler#

Oyuncuları, kimlikleri, oyuncuya göre banları, tehdit puanlarını ve bağlantılı hesapları sorgulayın. Bazı sonuçlar IP adresleri gibi kişisel veriler içerir.

Bildirimler ve dil#

Telefon bildirimleri gönderin ve AC çeviri tablolarını kullanın. phoneNotify ve phoneNotifyAdmins yalnızca ts.AdminMenu.enable açıkken vardır.

Ekran görüntüleri#

Panel için oyuncu ekran görüntüleri isteyin. AC'nin log yazan export'ları dahilidir ve burada listelenmemiştir.

• Panel kurulumu

Durum ve tanılama#

Gösterge panelleri ve sağlık kontrolleri için AC durumunu okuyun.

Resource guard#

Onaylı resource temel çizgisini okuyun ve değiştirin. Bu export'ların hepsi resource guard kapalıyken bile kaydedilir.

• Konsol komutları

İmza, backdoor ve event taramaları#

Taramaları çalıştırın ve imzaları, hatalı pozitif istisnalarını ve escrow atlamalarını yönetin. Taramalar zaman alabilir; bunları bir thread'den çalıştırın.

Honeypot event'leri#

Event adlarını tuzağa dönüştürün veya serbest bırakın. İkisi de ac_protected_events'e yazar ve veritabanından yeniden yükler.

Özelliğe bağlı export'lar#

Bu export'lar yalnızca ilgili özellik açıkken kaydedilir. Özellik kapalıysa onları çağırmak hata fırlatır.

• Config ve performans

İstemci tarafı export'lar#

Bunları istemci scriptlerinden çağırın. Herhangi bir istemci resource'u bunları çağırabilir; güven kontrolü yoktur. Yalnızca o istemcideki kontrolleri etkiler ve sunucu denetimini asla değiştirmezler.

-- karakter seçimi
exports['tosun-ac']:SetSpawned(false)
-- ... oyuncu bir karakter seçer ...
exports['tosun-ac']:SetSpawned(true)

JavaScript export'ları#

Tosun AC, resource taraması ve lisans doğrulaması için sunucuda birkaç JavaScript export'u kaydeder. Bunlar dahilidir, güvenilen resource kontrolüyle sarılmamıştır ve desteklenen bir API değildir. Bunları çağırmayın. Herkese açık JavaScript export'u yoktur.

Bridge dosyaları: kurulum#

tosun-ac/bridge içindeki isteğe bağlı bridge dosyaları, resource'unuza kısa yardımcılar içeren global bir TosunAC tablosu verir. Export'ları pcall içinde çağırırlar; böylece AC durdurulduğunda scriptiniz çalışmaya devam eder. AC, çağıran olarak sizin resource'unuzu görür.

1. Bridge'i resource'unuzun fxmanifest.lua dosyasına ekleyin: server_script '@tosun-ac/bridge/tosun_ac_server.lua' ve gerekirse client_script '@tosun-ac/bridge/tosun_ac_client.lua'.
2. AC klasörünün adı farklıysa server.cfg'ye setr tosun_ac_resource "folder-name" ekleyin. setr kullanın: istemci bridge'i bu convar'ı istemcide okur.
3. İsteğe bağlı: set tosun_ac_bridge_server_ms (varsayılan 60000), set tosun_ac_bridge_cooldown_ms (varsayılan 750, 0 kapatır) ve setr tosun_ac_bridge_client_ms (varsayılan 60000).
4. Tam sunucu muafiyetleri için resource'unuzu tosun_ac_trusted_resources'a ekleyin. Güven olmadan TosunAC.PlayerExempt yumuşak muafiyete düşer ve sunucu konsoluna bir kerelik bir ipucu yazar (ipucu metni Türkçedir).

-- sizin resource'unuzun fxmanifest.lua dosyası
server_script '@tosun-ac/bridge/tosun_ac_server.lua'
client_script '@tosun-ac/bridge/tosun_ac_client.lua'

# server.cfg
setr tosun_ac_resource "tosun-ac"
set tosun_ac_trusted_resources "my-resource"

-- sunucu scripti
local ok, mode = TosunAC.PlayerExempt(src, 'long', 'clothing')
-- mode 'full' (güvenilir) veya 'soft' (yalnızca hareket, en fazla 15 sn) olur

• Entegrasyon rehberi
• Sunucu yapılandırması

Bridge: sunucu yardımcıları#

Resource'unuzun içindeki bridge/tosun_ac_server.lua tarafından tanımlanır. Hazır ayarlar: SHORT 30000, MEDIUM 60000, LONG 120000, XL 180000 ms (TosunAC.Presets). TosunAC.Version '1.2'dir.

Bridge: istemci yardımcıları#

Resource'unuzun içindeki bridge/tosun_ac_client.lua tarafından tanımlanır. SetExempt istemci export'unu sarar; bu yüzden yalnızca istemci tarafı rahatlama sağlar.

Her resource'un çağırabileceği export'lar#

Bu export'larda güven kontrolü yoktur ve yan etkileri vardır. Her sunucu resource'u bunları çağırabilir. Yalnızca güvendiğiniz resource'ları çalıştırın; herhangi bir sunucu resource'unun FiveM native'leri üzerinden zaten oyuncu atabildiğini veya istemci event'leri tetikleyebildiğini unutmayın.

• MarkTeleport: oyuncu başına bütçeyle sınırlı hareket muafiyeti.
• spectatePlayer: bir oyuncuyu ışınlar ve her çağrıda bütçesiz 15 sn'lik bir hareket muafiyeti verir.
• NoteCloudViolation: bir oyuncunun tehdit puanını artırır ve license'ı sunucular arası tehdit veritabanına bildirebilir.
• warnPlayer ve mutePlayer: uyarı ve susturma kayıtları yazar.
• freezePlayer ve slayPlayer: doğrudan bir oyuncu üzerinde işlem yapar.
• crashGuardReject: kick veya ban'a yol açabilen ihlal puanları ekler.
• screenCapture, v6ScreenWatchRequest ve RequestShieldScreenshot: ekran görüntüsü ister.
• rescanResources, scanAllResources, scanSingleResource, tsScanBackdoors ve tsScanEvents: tarama başlatır. Otomatik engelleme veya otomatik karantina açıkken scanAllResources resource engelleyebilir, tsScanBackdoors resource durdurabilir.
• applyWeatherWithFramework ve applyTimeWithFramework: herkes için havayı ve saati değiştirir.
• invalidateSignatureCache, reloadSignatureExceptions, reloadSignatureScanCaches ve refreshPanelWhitelist: önbellekleri yeniden yükler.
• setPlayerLocale ve unmutePlayer: oyuncu durumunu değiştirir.
• phoneNotify ve phoneNotifyAdmins: oyunculara telefon veya sohbet mesajı gönderir.

Eski ve yanıltıcı adlar#

Bu export'lar hâlâ çalışır, ama adları veya eski belgeleri yapmadıkları bir şeyi ima eder.

• Eski rehberler (9.6.6 için INTEGRATION.md, 8.6.1 için CONFIG-EXPORTS-MULTILANG.md ve TOSUN-AC-EXPORTS.md yönlendirme taslağı) güncel değildir. Farklılık olduğunda bu referans 9.6.15 koduyla eşleşir.
• SetPlayerExempt, PausePlayerDetections, PauseAllDetections, BypassDetection, AddWhitelist, RemoveWhitelist, WhitelistArea, ClearArea, addAdmin, fakeTriggerTrap ve fakeTriggerWhitelist güvenilen bir resource gerektirir; CONFIG-EXPORTS-MULTILANG.md bunları bu gereksinim olmadan listelese de.
• Varsayılan güven listesi qbx_core, qb-core, es_extended, ox_inventory ve ox_lib'dir. INSTALLER-READY.md qb-core ve es_extended'ı atlar.
• GetIntegrationStatus() bir version alanı da döndürür.
• punish, ban, BanPlayerExt, KickPlayer, offlineBan ve offlineBanByLicense güvenilen bir resource gerektirir.
• ban() ve BanPlayerExt() ts.punishType ve ts.BanDurations['default'] değerlerini izler; bu yüzden her zaman kalıcı değildir.
• KickPlayer muafiyetleri kontrol etmez. Ceza hattında KICK yetkilileri her zaman korur; BAN ve LOG ise ts.AdminBypassDetections'ı izler.
• Bir istemci muafiyeti sırasında istemci kontrollerinin çoğu tamamen atlanır. Yalnızca yine de ban yoluna ulaşan tespitler [exempt] etiketli LOG girdilerine dönüşür.
• NoteCloudViolation sonraki girişleri yalnızca ts.cloudBridge.threatIntelAction = 'kick' iken engeller.
• İstemci bridge'iyle birlikte tosun_ac_resource ve tosun_ac_bridge_client_ms convar'ları set ile değil, setr ile ayarlanmalıdır.
• Çağrı başına MarkTeleport üst sınırı (ts.Integration.markTeleportMaxMs) güvenilen çağıranlara da uygulanır. Yalnızca 10 dakikada 180 sn'lik bütçe güvenilmeyen çağıranlar içindir.