Export-Referenz

Einen Export aufrufen#

Rufen Sie Server-Exports aus den Server-Skripten Ihrer Ressource auf und Client-Exports aus ihren Client-Skripten. Der Ressourcenname enthält einen Bindestrich, verwenden Sie daher immer die Klammerform exports['tosun-ac']. Die Form exports.tosun-ac ist kein gültiges Lua.

• Übergeben Sie Server-IDs als Zahlen. Mehrere Exports verwenden die ID direkt als Tabellenschlüssel.
• Einige Exports führen eine synchrone Datenbankabfrage aus und geben dabei die Ausführung ab (yield). Rufen Sie sie aus einem Thread oder einem Event-Handler auf: getBans, getBanInfo, GetDetections, isAdmin und die anderen Staff-Prüfungen, IsExemptFromPunish, ForensicLinksOf und refreshPanelWhitelist. Auch scanAllResources und scanSingleResource geben die Ausführung ab.
• Ein abgesicherter Export, der Ihre Ressource ablehnt, gibt false zurück, auch wenn er normalerweise nil zurückgibt.
• Einige Exports existieren nur, wenn ihre Funktion aktiviert ist (siehe Funktionsabhängige Exports). Der Aufruf eines nicht registrierten Exports wirft einen Fehler, kapseln Sie diese Aufrufe daher in pcall.
• Mehrere Exports fehlen in den Export-Listen in fxmanifest.lua (zum Beispiel MarkTeleport, punish und AllowWeapon). Diese Listen dienen nur der Information; die Exports funktionieren.
• Die Tabellen unten zeigen Ja in der letzten Spalte, wenn die aufrufende Ressource vertrauenswürdig sein muss. Siehe Vertrauenswürdige Ressourcen.

-- Server-Skript in Ihrer eigenen Ressource
local status = exports['tosun-ac']:GetIntegrationStatus()
if not status.trusted then
    print(status.hint) -- die hinzuzufügende server.cfg-Zeile
end

-- dem AC einen Teleport melden, dann den Spieler bewegen
exports['tosun-ac']:MarkTeleport(src, 8000)
SetEntityCoords(GetPlayerPed(src), x, y, z)

-- Client-Skript in Ihrer eigenen Ressource
exports['tosun-ac']:SetExempt(true, 60000, 'my_menu')

• Integrationsleitfaden
• Serverkonfiguration

Vertrauenswürdige Ressourcen#

Exports mit Ja in der Vertrauensspalte ändern Ausnahmen, Staff-Rechte, Banns, Spielergesundheit, Waffen oder Inventar, Quarantäne, Ressourcen und Signaturen oder den gesamten Server. Sie akzeptieren nur Aufrufe aus einer vertrauenswürdigen Ressource. Ein abgelehnter Aufruf bewirkt nichts und gibt false zurück.

Ein Aufrufer ist vertrauenswürdig, wenn er die Serverkonsole ist, tosun-ac selbst, eine in ts.ExportCallerWhitelist in der Konfiguration aufgeführte Ressource oder eine in der Convar tosun_ac_trusted_resources aufgeführte Ressource. Die Standardliste der Konfiguration ist qbx_core, qb-core, es_extended, ox_inventory und ox_lib.

Bevorzugen Sie die Convar. Sie steht in server.cfg und übersteht AC-Updates, während Änderungen an der Konfigurationsdatei bei einem AC-Update verloren gehen können. Trennen Sie Namen durch Kommas oder Leerzeichen. Die Vertrauensliste wird 10 Sekunden zwischengespeichert, eine Änderung zur Laufzeit greift also innerhalb von 10 Sekunden.

Bei der ersten Ablehnung für jedes Paar aus Ressource und Export gibt das AC eine Warnung mit der genauen hinzuzufügenden server.cfg-Zeile in der Serverkonsole aus und schreibt eine Zeile in die Panel-Logs. Die Zeile im Panel-Log ist immer auf Türkisch.

Audit-Modus: Mit ts.EnforceExportCallerWhitelist = false laufen nicht vertrauenswürdige Aufrufe, und jedes Paar aus Ressource und Export wird einmal in der Serverkonsole ausgegeben (keine Zeile im Panel-Log). Der Standard ist true. Verwenden Sie den Audit-Modus nur während der Einrichtung, um zu sehen, welche Skripte was aufrufen.

Führen Sie tosunac_integration in der Serverkonsole aus, um den Durchsetzungsmodus, die vertrauenswürdigen Ressourcen mit ihrer Quelle (config oder convar) und die letzten 20 abgelehnten Aufrufe auszugeben. Aus einem Skript rufen Sie GetIntegrationStatus() auf.

Vertrauen hebt außerdem das MarkTeleport-Budget auf: Vertrauenswürdige Ressourcen können Teleports ohne das Zeitlimit pro Spieler markieren.

Tosun AC registriert außerdem interne Exports und Net-Events für die eigene Infrastruktur (Panel-Bridge, Signierung, Scans, Lizenzierung, Batching). Sie gehören nicht zu dieser Referenz und sind keine unterstützte API. Einige sind durch die Vertrauensprüfung oder eine interne Aufruferprüfung geschützt. Rufen Sie sie nicht auf.

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

• Serverkonfiguration
• Konsolenbefehle

Integration und Ausnahmen#

Server-Exports, die dem AC legitime Aktionen in Ihren Skripten mitteilen und abfragen, ob ein Spieler ausgenommen ist.

Die passende Ausnahme wählen#

Verwenden Sie die engste Ausnahme, die Ihr Skript abdeckt. Mehrere Ausnahmen teilen sich dasselbe Client-Ausnahme-Flag, daher kann eine die andere beenden: ClearArea mit einem Bereichsnamen setzt das Flag zurück, das auch SetPlayerExempt, MarkTeleport und BypassDetection setzen.

Staff und Berechtigungen#

Lesen und ändern Sie, wen das AC als Staff behandelt. Staff-Prüfungen können die Datenbank abfragen, rufen Sie sie daher aus einem Thread oder einem Event-Handler auf.

isAdmin gibt true zurück für: eine manuelle Gewährung per addAdmin; die ACEs txadmin, tx.admin, txadmin.menu, txadmin.advanced, command.txadmin, command.ts, command.ban, command.kick, tosun.admin, ts.admin und alle aus ts.AdminBypassAces; die Principals group.admin, group.superadmin, group.moderator und group.god; command.kick/ban/resources/restart, wenn ts.txAdminAuth aktiv ist; Kennungen in admins.lua, ts.AdminMenu.allowedIds und ts.AdminBypassIdentifiers; sowie Panel-Freigaben in der Datenbank. Eine ACE, die auch builtin.everyone erteilt wurde, zählt nicht.

isAdmin und addAdmin sind im Quellcode zweimal registriert. Die Versionen in anticheat_server.lua werden zuletzt geladen und sind die, die laufen; diese Referenz beschreibt jene.

Spieler-Whitelist und Bereiche#

Whitelist nach Server-ID, Whitelist nach Kennung und benannte Bereiche. Die Laufzeitlisten liegen nur im Speicher und gehen beim Neustart verloren; die Panel-Whitelist ist davon getrennt.

Strafen und Banns#

Bestrafen Sie Spieler über die AC-Pipeline, bannen Sie Offline-Spieler und lesen Sie Banns. Alle schreibenden Exports hier erfordern Vertrauen.

• Events

Wie punish() die Strafe wählt#

punish(), ban() und BanPlayerExt() teilen sich eine Pipeline. Sie folgt dieser Reihenfolge.

1. Teammitglieder werden übersprungen, wenn ts.AdminBypassDetections nicht false ist. Spieler mit aktiver Ausnahme oder auf der Laufzeit- oder Panel-Whitelist werden übersprungen. ts.Debug schaltet diese Überspringungen ab. Übersprungene Aufrufe bewirken nichts und protokollieren nichts.
2. Der Spieler muss online sein. Andernfalls wird ein Fehler in der Serverkonsole ausgegeben, und nichts passiert.
3. Strafe: Ein gültiges Argument punishment hat Vorrang. Andernfalls ts.DetectionPunishments[configKey], dann dessen Alias, dann der Erkennungsschlüssel, dann ts.punishType, dann BAN.
4. Jedes Ergebnis löst das Server-Event ts_anticheat:playerBanned aus, sendet eine Chatnachricht, wenn ts.chatMessages aktiv ist, fügt einen Cloud-Verstoß hinzu und schreibt das AC-Log und das Live-Log.
5. LOG: sendet das Screenshot-Log an Discord.
6. KICK: prüft Staff unabhängig von ts.AdminBypassDetections erneut, Teammitglieder werden also nie gekickt. Sendet dann das Screenshot-Log und trennt den Spieler.
7. BAN: trägt den Bann mit einer Dauer aus ts.BanDurations in Stunden ein (configKey, Alias, Erkennungsschlüssel, Präfix, dann default; 0 = permanent) und bannedBy 'anticheat:' plus Schlüssel. Löst ts_anticheat:banCommitted aus, benachrichtigt das Panel und trennt den Spieler (erneuter Versuch nach 3 s).

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

Moderation eines einzelnen Spielers#

Wirken auf einen Spieler. Lesen Sie die Vertrauensspalte genau: Mehrere dieser Exports haben keine Vertrauensprüfung.

Serverweite Aktionen#

Aktionen, die jeden Spieler oder jede neue Verbindung betreffen.

Quarantäne und Payload-Schutz#

Isolieren Sie einen verdächtigen Spieler und schützen Sie Ihre eigenen Net-Events vor Crash-Payloads und Spam.

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
    -- den Kauf verarbeiten
end)

Spieler und Erkennungen#

Fragen Sie Spieler, Kennungen, Banns pro Spieler, Bedrohungswerte und verknüpfte Konten ab. Einige Ergebnisse enthalten personenbezogene Daten wie IP-Adressen.

Benachrichtigungen und Sprache#

Senden Sie Telefon-Benachrichtigungen und verwenden Sie die Übersetzungstabellen des AC. phoneNotify und phoneNotifyAdmins existieren nur, wenn ts.AdminMenu.enable aktiv ist.

Screenshots#

Fordern Sie Screenshots von Spielern für das Panel an. Die Log-Exports des AC sind intern und hier nicht aufgeführt.

• Panel-Einrichtung

Status und Diagnose#

Lesen Sie den AC-Zustand für Dashboards und Health-Checks.

Resource Guard#

Lesen und ändern Sie die freigegebene Ressourcen-Baseline. Alle diese Exports sind registriert, auch wenn der Resource Guard deaktiviert ist.

• Konsolenbefehle

Signatur-, Backdoor- und Event-Scans#

Führen Sie Scans aus und verwalten Sie Signaturen, Ausnahmen für Fehlalarme und Escrow-Überspringungen. Scans können dauern; führen Sie sie aus einem Thread aus.

Honeypot-Events#

Machen Sie Eventnamen zu Fallen oder geben Sie sie wieder frei. Beide schreiben in ac_protected_events und laden neu aus der Datenbank.

Funktionsabhängige Exports#

Diese Exports werden nur registriert, wenn ihre Funktion aktiv ist. Ist die Funktion aus, wirft ein Aufruf einen Fehler.

• Konfiguration und Leistung

Clientseitige Exports#

Rufen Sie diese aus Client-Skripten auf. Jede Client-Ressource kann sie aufrufen; es gibt keine Vertrauensprüfung. Sie betreffen nur Prüfungen auf diesem Client und ändern nie die serverseitige Durchsetzung.

-- Charakterauswahl
exports['tosun-ac']:SetSpawned(false)
-- ... Spieler wählt einen Charakter ...
exports['tosun-ac']:SetSpawned(true)

JavaScript-Exports#

Tosun AC registriert auf dem Server einige JavaScript-Exports für Ressourcen-Scans und Lizenzprüfung. Sie sind intern, nicht durch die Vertrauensprüfung abgesichert und keine unterstützte API. Rufen Sie sie nicht auf. Es gibt keine öffentlichen JavaScript-Exports.

Bridge-Dateien: Einrichtung#

Die optionalen Bridge-Dateien in tosun-ac/bridge geben Ihrer Ressource eine globale Tabelle TosunAC mit kurzen Hilfsfunktionen. Sie rufen die Exports innerhalb von pcall auf, sodass Ihr Skript weiterläuft, wenn das AC gestoppt ist. Das AC sieht Ihre Ressource als Aufrufer.

1. Fügen Sie die Bridge zur fxmanifest.lua Ihrer Ressource hinzu: server_script '@tosun-ac/bridge/tosun_ac_server.lua' und bei Bedarf client_script '@tosun-ac/bridge/tosun_ac_client.lua'.
2. Hat der AC-Ordner einen anderen Namen, fügen Sie setr tosun_ac_resource "folder-name" zu server.cfg hinzu. Verwenden Sie setr: Die Client-Bridge liest diese Convar auf dem Client.
3. Optional: set tosun_ac_bridge_server_ms (Standard 60000), set tosun_ac_bridge_cooldown_ms (Standard 750, 0 deaktiviert) und setr tosun_ac_bridge_client_ms (Standard 60000).
4. Für volle Server-Ausnahmen fügen Sie Ihre Ressource zu tosun_ac_trusted_resources hinzu. Ohne Vertrauen fällt TosunAC.PlayerExempt auf eine weiche Ausnahme zurück und gibt einmalig einen Hinweis in der Serverkonsole aus (der Hinweistext ist auf Türkisch).

-- fxmanifest.lua Ihrer Ressource
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"

-- Server-Skript
local ok, mode = TosunAC.PlayerExempt(src, 'long', 'clothing')
-- mode ist 'full' (vertrauenswürdig) oder 'soft' (nur Bewegung, max. 15 s)

• Integrationsleitfaden
• Serverkonfiguration

Bridge: Server-Hilfsfunktionen#

Definiert durch bridge/tosun_ac_server.lua in Ihrer Ressource. Presets: SHORT 30000, MEDIUM 60000, LONG 120000, XL 180000 ms (TosunAC.Presets). TosunAC.Version ist '1.2'.

Bridge: Client-Hilfsfunktionen#

Definiert durch bridge/tosun_ac_client.lua in Ihrer Ressource. Sie kapseln den Client-Export SetExempt und bieten daher nur clientseitige Entlastung.

Exports, die jede Ressource aufrufen kann#

Diese Exports haben keine Vertrauensprüfung und haben Nebenwirkungen. Jede Server-Ressource kann sie aufrufen. Setzen Sie nur Ressourcen ein, denen Sie vertrauen; beachten Sie, dass jede Server-Ressource ohnehin über FiveM-Natives Spieler kicken oder Client-Events auslösen kann.

• MarkTeleport: Bewegungsausnahme, begrenzt durch das Budget pro Spieler.
• spectatePlayer: teleportiert einen Spieler und gewährt bei jedem Aufruf eine Bewegungsausnahme von 15 s ohne Budget.
• NoteCloudViolation: erhöht den Bedrohungswert eines Spielers und kann die License an die serverübergreifende Bedrohungsdatenbank melden.
• warnPlayer und mutePlayer: schreiben Verwarnungs- und Stummschaltungseinträge.
• freezePlayer und slayPlayer: wirken direkt auf einen Spieler.
• crashGuardReject: fügt Strikes hinzu, die zu Kick oder Bann führen können.
• screenCapture, v6ScreenWatchRequest und RequestShieldScreenshot: fordern Screenshots an.
• rescanResources, scanAllResources, scanSingleResource, tsScanBackdoors und tsScanEvents: starten Scans. scanAllResources kann blockieren, und tsScanBackdoors kann Ressourcen stoppen, wenn automatisches Blockieren oder automatische Quarantäne aktiv ist.
• applyWeatherWithFramework und applyTimeWithFramework: ändern Wetter und Uhrzeit für alle.
• invalidateSignatureCache, reloadSignatureExceptions, reloadSignatureScanCaches und refreshPanelWhitelist: laden Caches neu.
• setPlayerLocale und unmutePlayer: ändern den Spielerzustand.
• phoneNotify und phoneNotifyAdmins: senden Telefon- oder Chatnachrichten an Spieler.

Veraltete und irreführende Namen#

Diese Exports funktionieren weiterhin, aber ihre Namen oder ältere Dokumentation lassen etwas vermuten, das sie nicht tun.

• Ältere Anleitungen (INTEGRATION.md für 9.6.6, CONFIG-EXPORTS-MULTILANG.md für 8.6.1 und der Weiterleitungs-Stub TOSUN-AC-EXPORTS.md) sind veraltet. Wo sie abweichen, entspricht diese Referenz dem Code von 9.6.15.
• SetPlayerExempt, PausePlayerDetections, PauseAllDetections, BypassDetection, AddWhitelist, RemoveWhitelist, WhitelistArea, ClearArea, addAdmin, fakeTriggerTrap und fakeTriggerWhitelist erfordern eine vertrauenswürdige Ressource, obwohl CONFIG-EXPORTS-MULTILANG.md sie ohne diese Voraussetzung aufführt.
• Die Standard-Vertrauensliste ist qbx_core, qb-core, es_extended, ox_inventory und ox_lib. In INSTALLER-READY.md fehlen qb-core und es_extended.
• GetIntegrationStatus() gibt außerdem ein Feld version zurück.
• punish, ban, BanPlayerExt, KickPlayer, offlineBan und offlineBanByLicense erfordern eine vertrauenswürdige Ressource.
• ban() und BanPlayerExt() folgen ts.punishType und ts.BanDurations['default'] und sind daher nicht immer permanent.
• KickPlayer prüft keine Ausnahmen. In der Straf-Pipeline verschont KICK Teammitglieder immer, während BAN und LOG ts.AdminBypassDetections folgen.
• Während einer Client-Ausnahme werden die meisten Client-Prüfungen vollständig übersprungen. Nur Erkennungen, die trotzdem den Bannweg erreichen, werden zu LOG-Einträgen mit dem Tag [exempt].
• NoteCloudViolation blockiert spätere Verbindungen nur bei ts.cloudBridge.threatIntelAction = 'kick'.
• Mit der Client-Bridge müssen die Convars tosun_ac_resource und tosun_ac_bridge_client_ms mit setr gesetzt werden, nicht mit set.
• Die Obergrenze pro Aufruf von MarkTeleport (ts.Integration.markTeleportMaxMs) gilt auch für vertrauenswürdige Aufrufer. Nur das Budget von 180 s pro 10 Minuten betrifft nicht vertrauenswürdige Aufrufer.