server.cfg, Convars und Berechtigungen

Wo die Konfiguration liegt#

Tosun AntiCheat liest Einstellungen aus server.cfg, vier Dateien in der Ressource und dem Webpanel. Zugangsdaten gehören nur an Orte, die ausschließlich der Server liest. configs/anticheat_config.lua ist ein Shared-Skript, der Server sendet es also an jeden Client.

• Installation
• Panel-Einrichtung
• Lizenzschlüssel

Vollständiges server.cfg-Beispiel#

Ein vollständiger Block für eine typische Installation. Die Reihenfolge ist wichtig: Abhängigkeiten und Zugangsdaten-Convars müssen vor ensure tosun-ac stehen, weil die Zugangsdaten einmal beim Laden der Ressource aufgelöst werden. Zeilen, die mit einem einzelnen # beginnen, sind optional; entfernen Sie das #, um sie zu verwenden.

## ---------- Tosun AntiCheat: server.cfg-Block ----------
## OneSync ist eine Manifest-Abhängigkeit (txAdmin kann es ebenfalls aktivieren).
set onesync on

## Abhängigkeiten: vor tosun-ac starten.
## oxmysql und tosun_render sind zwingende Abhängigkeiten.
## screenshot-basic ist das Standard-ts.screenshotModule.
## mysql_connection_string vor ensure oxmysql konfigurieren (siehe MySQL-Anleitung).
ensure oxmysql
ensure screenshot-basic
ensure tosun_render

## Zugangsdaten: set verwenden (nie setr oder sets) und ÜBER ensure tosun-ac platzieren.
## Sie werden einmal beim Laden der Ressource gelesen.
## License-Format: tac_live_ gefolgt von 40 Hex-Zeichen in Kleinbuchstaben.
set tosun_ac_license "YOUR_LICENSE_KEY"
## Optional: Wenn leer, wird der Panel-Schlüssel aus panel_settings in der Spiel-DB geladen.
# set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
# set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
## Optional: nur von ts.licenseLock verwendet.
# set tosun_ac_server_id "server-1"

## Ressourcen, die abgesicherte AC-Exports aufrufen dürfen (kommagetrennt).
set tosun_ac_trusted_resources "my-housing,my-clothing"

## Optional: öffentliche https-Panel-Adresse für Screenshot- und Beweis-Uploads.
# set ts_public_panel_url "https://panel.example.com"

## Optional: die Tosun-Connect-DB-Bridge aus dieser Datei steuern.
## Ohne die manual-Zeile (und mit ausgeschaltetem ts.panelMirror) werden beide Bridge-Convars auf "1" erzwungen.
# set tosun_db_bridge_manual "1"
# set tosun_db_bridge_enabled "1"
# set tosun_db_bridge_money_write "0"

## Optional: den Playtime-Writer abschalten (nur qb, qbcore und qbox).
# set tosun_panel_playtime "0"

## Optional, für Integratoren mit Bridge-Dateien. Clients lesen diese Werte, daher setr verwenden.
# setr tosun_ac_resource "tosun-ac"
# setr tosun_ac_bridge_client_ms "60000"

ensure tosun-ac

## ---------- Staff-Berechtigungen ----------
## Staff-Status und Admin-Menü im Spiel:
add_ace group.admin tosun.admin allow
## tosunac_setup, die manuellen Scans und die Vorschau des Bannbildschirms:
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
## Eine Zeile pro Teammitglied:
add_principal identifier.license:YOUR_LICENSE_HEX group.admin

## ---------- FiveM-Hardening-Convars, die das AC beim Start prüft ----------
set sv_stateBagStrictMode true
set sv_filterRequestControl 2
set sv_enableNetworkedSounds false
set sv_enableNetworkedPhoneExplosions false
set sv_enableNetworkedScriptEntityStates false
set sv_scriptHookAllowed false
## Zuerst testen: relaxed oder strict kann Skripte beschädigen, die Fahrzeuge vom Client aus spawnen.
set sv_entityLockdown relaxed
set sv_pureLevel 1
## Die server.cfg-Prüfung warnt, solange dieser Wert leer ist:
# set sv_enforceGameBuild YOUR_GAME_BUILD

• MySQL-Einrichtung
• Einrichtungsanleitung

Regeln für den server.cfg-Block#

Befolgen Sie diese Regeln, wenn Sie das Beispiel an Ihren Server anpassen.

• Starten Sie oxmysql und tosun_render vor tosun-ac. Das Manifest deklariert Server-Build 4890 oder neuer, OneSync, oxmysql und tosun_render als Abhängigkeiten.
• Starten Sie screenshot-basic, wenn Sie das Standard-ts.screenshotModule beibehalten.
• Setzen Sie jede Zugangsdatenzeile set tosun_ac_ vor ensure tosun-ac. Die Werte werden einmal beim Laden gelesen; eine spätere Änderung erfordert einen Neustart der Ressource.
• Verwenden Sie set für Zugangsdaten. setr repliziert den Wert an jeden Client, und sets veröffentlicht ihn in den öffentlichen Serverinformationen.
• Verwenden Sie setr nur für Convars, die Clients lesen: ts_screen_upload, tosun_ac_resource und tosun_ac_bridge_client_ms.
• Sie brauchen keine Zeile für die DB-Bridge. Seit 9.6.14 ist die Bridge standardmäßig aktiv, und Zeilen set ... "0" werden ignoriert, außer tosun_db_bridge_manual ist "1" oder ts.panelMirror.enabled = true.
• Ältere Installationsanleitungen (INSTALLER-READY.md, INSTALLER-LICENSE.md, INSTALL-MULTILANG.md, CONFIG-PERFORMANCE-GUIDE.md) setzen ensure vor die Zugangsdaten, tragen den Panel-Schlüssel in configs/anticheat_config.lua ein und lassen tosun_render weg. Folgen Sie stattdessen dieser Seite.

Convar-Referenz#

Jede Convar, die Tosun AntiCheat liest und die Sie setzen dürfen. Verwenden Sie set, außer die Spalte Hinweise nennt setr. Das AC schreibt und liest außerdem einige eigene interne Convars; diese sind geschützt, und Sie dürfen sie nicht setzen.

Zugangsdaten: Rangfolge und Umgang#

Drei Zugangsdaten werden einmal beim Laden der Ressource aufgelöst: der Lizenzschlüssel, der Panel-API-Schlüssel und das zentrale Token. Für jedes nimmt das AC den ersten nicht leeren Wert in dieser Reihenfolge.

Die MIGRATION-Warnung fordert Sie auf, den Wert in der Shared-Datei zu leeren und alle Zugangsdaten zu wechseln, die jemals dort gespeichert waren, weil diese Datei an jeden Client gesendet wird.

Ein Wert mit mehr als 4096 Zeichen oder mit Steuerzeichen stoppt das Laden mit dem Fehler Invalid server credential setting.

Nur Panel-Schlüssel: Ist er nach diesen Schritten noch leer, kopiert das AC panel_settings.ac_api_key aus der Spiel-DB. Bei jedem Start schreibt das AC den aufgelösten Schlüssel im Klartext in die ac_settings-Zeile webPanelKey. Bearbeitet jemand diese Zeile im Panel, ersetzt der bearbeitete Wert Ihren bis zum nächsten Neustart.

Nur Lizenzschlüssel: Die Lizenzsperre akzeptiert die Formate tac_live_ plus 40 Hex-Zeichen in Kleinbuchstaben (49 Zeichen), TOSUN-AC-YYYY-... und TOSUN-.... Die Formatprüfung läuft nur, wenn ts.licenseLock.enabled = true ist, und prüft nur das Format.

1. Die Server-Convar: tosun_ac_license, tosun_ac_panel_key oder tosun_ac_central_token.
2. Der Wert in configs/anticheat_server.lua: licenseKey, panelKey oder centralToken.
3. Der veraltete Wert in der Shared-Datei configs/anticheat_config.lua: ts.licenseLock.licenseKey, ts.webPanelKey oder ts.Central.token. Jeder Wert hier erzeugt eine MIGRATION-Warnung in der Konsole.

• Lizenzschlüssel

configs/anticheat_server.lua#

Verwenden Sie diese reine Server-Datei, wenn Sie Zugangsdaten lieber nicht in server.cfg ablegen. Sie wird vor den Server-Skripten des AC geladen und kehrt auf Clients sofort zurück. Lassen Sie einen Eintrag leer, um weiterhin die Convar oder die Ermittlung aus der Datenbank zu nutzen.

• Eine nicht leere Convar hat immer Vorrang vor dem Wert in dieser Datei.
• Lassen Sie die entsprechenden Einträge in configs/anticheat_config.lua leer: ts.webPanelKey, ts.Central.token und ts.licenseLock.licenseKey.
• Halten Sie Backups dieser Datei privat.
• Die Datei füllt nur ts.webPanelKey, ts.Central.token und ts.licenseLock.licenseKey. Andere Skripte lesen diese Werte, nicht die Datei.

-- configs/anticheat_server.lua (nur Server)
local credentials = {
    panelKey = '',     -- oder: set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
    centralToken = '', -- oder: set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
    licenseKey = '',   -- oder: set tosun_ac_license "YOUR_SERVER_LICENSE"
}

Panel-URL und Screenshot-Uploads#

ts.webPanelURL in configs/anticheat_config.lua ist die Basis-URL des Panels. Sie können sie leer lassen: Ist sie leer, lädt das AC panel_url oder site_url aus panel_settings in der Spiel-DB und speichert sie in ac_settings. Der HTTP-Einstellungs-Sync läuft nur, wenn sowohl die URL als auch der Panel-Schlüssel gesetzt sind.

Setzen Sie ts_public_panel_url nur, wenn Screenshots, Bann-Beweise und Live-Videos an eine andere öffentliche Adresse gehen müssen. Sie muss https sein. Upload-Tokens werden nur für https://host/api/screen_upload.php ausgestellt, wenn die Basis dieser Convar oder ts.webPanelURL entspricht.

ts_screen_upload ist ein separater Pfad, den der Export screenCapture und die Befehle /capture und /ts_capture verwenden. Er benötigt setr, und sein Standard zeigt auf localhost. Nichts im AC verarbeitet das Ergebnis dieses Uploads.

Die alten Namen ts.PanelUrl, ts.panelUrl und ts.webPanelUrl werden weiterhin als Fallback gelesen.

• Panel-Einrichtung

Convars der Tosun-Connect-DB-Bridge#

Seit 9.6.14 ist die DB-Bridge auf Abruf standardmäßig aktiv und benötigt keine Zeile in server.cfg. Beim Laden setzt editable/server/tosun_db_bridge_defaults.lua tosun_db_bridge_enabled und tosun_db_bridge_money_write auf "1", daher werden die "0"-Zeilen aus älteren Anleitungen ignoriert.

Sie können die Verbindung für einen Server auch im Panel abschalten: Servers, dann der Server, dann die Karte Tosun Connect.

Die Bridge fragt https://admin.tosundev.com/api/server_db_bridge.php ab, sendet Ihren Lizenzschlüssel als Bearer-Token und führt nur diese Operationen aus: players.list, player.detail, player.vehicles, bans.list, logs.list und player.money.set.

Mit ts.panelMirror.enabled = true erzwingt das AC die Bridge nicht, der alte Mirror funktioniert also weiter. Der Mirror selbst läuft nicht, solange tosun_db_bridge_enabled "1" ist.

Die Konsolenbefehle tosunac_db_status und tosunac_db_check zeigen den Zustand der Bridge und testen oxmysql.

1. Um die Bridge über server.cfg zu steuern, fügen Sie set tosun_db_bridge_manual "1" vor ensure tosun-ac hinzu.
2. Fügen Sie set tosun_db_bridge_enabled mit "1" oder "0" hinzu.
3. Fügen Sie set tosun_db_bridge_money_write mit "1" oder "0" hinzu. Ohne "1" schlägt player.money.set mit write_disabled fehl und wird dem Panel nicht angeboten.

• MySQL-Einrichtung

Convars für Skriptentwickler#

Diese Convars sind nur relevant, wenn eine andere Ressource das AC aufruft. tosun_ac_trusted_resources entscheidet, welche Ressourcen abgesicherte Exports aufrufen dürfen; die Bridge-Convars konfigurieren die optionalen Bridge-Dateien.

Zu den abgesicherten Exports gehören SetExempt, SetPlayerExempt, die Pause-Exports, BypassDetection, addAdmin, whitelistPlayer, approveResource, ban, offlineBan, die webBridge-Exports und quarantine.

Die Serverkonsole und tosun-ac selbst sind immer vertrauenswürdig. Ein nicht vertrauenswürdiger Aufruf wird abgelehnt; für jedes Paar aus Ressource und Export gibt das AC eine Konsolenwarnung und eine Panel-Logzeile aus, die diese Convar nennt. Mit ts.EnforceExportCallerWhitelist = false läuft der Aufruf und wird nur einmal protokolliert.

Vertrauenswürdige Aufrufer erhalten außerdem MarkTeleport ohne das Budget pro Spieler.

INTEGRATION.md und bridge/INTEGRATION.txt zeigen set für tosun_ac_resource und tosun_ac_bridge_client_ms. Verwenden Sie stattdessen setr: Die Client-Bridge liest beide auf dem Client.

Es gibt außerdem interne AC-Events und -Exports. Sie sind geschützt und dürfen nicht aus Ihren Ressourcen aufgerufen werden.

# Ressourcen, die abgesicherte Exports aufrufen dürfen (durch Komma oder Leerzeichen getrennt)
set tosun_ac_trusted_resources "my-housing,my-clothing"

# Bridge-Dateien in Ihrer eigenen Ressource
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"

• Exports
• Export-Referenz
• Events

ACE-Berechtigungen#

Jede ACE, die Tosun AntiCheat prüft. Erteilen Sie ACEs einer Gruppe und fügen Sie Teammitglieder mit add_principal zur Gruppe hinzu. Eine ACE, die auch builtin.everyone hat, macht niemanden zum Teammitglied.

• Befehle

Eingeschränkte Befehle und reine Konsolenbefehle#

Zehn AC-Befehle sind als eingeschränkt registriert. Im Spiel verlangt FiveM dann zusätzlich zur eigenen Prüfung des AC die passende Befehls-ACE. Fünf der zehn ignorieren Spieler vollständig.

banscreentest ist nicht eingeschränkt. Die Konsolenform banscreentest playerId benötigt keine ACE; /banscreentest im Spiel benötigt tosunac.banscreen.test oder tosunac.admin. Ablehnungen von tosunac_setup, den beiden Scans und banscreentest erfolgen stumm.

tosunac_setup gibt nichts frei, wenn der Backdoor- oder Signaturscan nicht abgeschlossen wird, auch wenn ts.BackdoorGuard deaktiviert ist. Ein zweiter Lauf, während einer läuft, wird abgelehnt.

• Befehle

Wie Staff erkannt wird#

Das AC hat zwei getrennte Zugriffsstufen. Staff-Status gibt Straffreiheit und die Staff-Befehle (/ts-Unterbefehle und die ts_-Befehle). Menüzugriff öffnet das Admin-Menü im Spiel. Einige Quellen gewähren nur eines davon.

Straffreiheit für Staff gilt nur bei ts.AdminBypassDetections = true (ausgeliefert) und ts.Debug = false (ausgeliefert).

Menüzugriff erfordert außerdem, dass ts.AdminMenu.enable und ts.AdminMenu.enabled true bleiben. Ist einer davon false, werden das Menü, die Taste F7 und die Client-Befehle der Admin-Werkzeuge nicht registriert.

Teammitglieder mit Staff-Status, aber ohne Menüzugriff, zum Beispiel reine txAdmin-Teammitglieder, können trotzdem F7 drücken. Die Anfrage wird abgelehnt und protokolliert.

• Befehle

Kennungslisten: Admins, allowedIds und AdminBypassIdentifiers#

Verwenden Sie vollständige Kennungen wie Werte mit license:, steam:, discord: oder fivem:. Bevorzugen Sie für Staff admins/anticheat_admins.lua oder Panel-Freigaben: Diese Datei liest nur der Server, während configs/anticheat_config.lua an jeden Client gesendet wird.

• Admins: Ein Eintrag passt auf die vollständige Kennung (ohne Beachtung der Groß-/Kleinschreibung) oder auf den Teil nach dem Präfix. Er gewährt Staff-Status und das Menü.
• ts.AdminMenu.allowedIds: Staff-Status und das Menü. Die Werte "all" und "staff" gewähren nichts.
• ts.AdminBypassIdentifiers: nur Staff-Status und Ausnahme, kein Menü.

-- admins/anticheat_admins.lua (nur Server)
Admins = {
    "license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "steam:11000010xxxxxxxx",
    "discord:123456789012345678",
}

-- configs/anticheat_config.lua (shared, wird an Clients gesendet)
ts.AdminMenu = {
    -- andere Menüschlüssel bleiben wie ausgeliefert
    allowedIds = {
        "license:YOUR_EXACT_PLAYER_IDENTIFIER",
    },
}
ts.AdminBypassIdentifiers = {}  -- Staff-Status und Ausnahme, kein Menü

Panel-Freigaben und der Export addAdmin#

Panel-Freigaben sind Zeilen in ac_v7_admin_grants, die Sie im Webpanel anlegen. Eine aktive Freigabe passt auf die license oder license2 des Spielers, mit oder ohne Präfix, und gibt Staff-Status und Menüzugriff.

Eine positive Antwort wird 5 s zwischengespeichert, eine negative 30 s. Eine neue Freigabe kann daher bis zu 30 s brauchen, bis sie für einen bereits geprüften Spieler gilt.

Eine vertrauenswürdige Ressource kann den Export addAdmin aufrufen, um einem Spieler Staff-Status und Menüzugriff zu geben, bis removeAdmin aufgerufen wird. Solange ts.EnforceExportCallerWhitelist true ist, muss der Aufrufer in tosun_ac_trusted_resources oder ts.ExportCallerWhitelist aufgeführt sein.

• Panel-Einrichtung
• Exports

Die Spieler-Whitelist ist kein Staff#

Die Spieler-Whitelist im Panel (ac_whitelist) und zur Laufzeit über die Whitelist-Exports hinzugefügte Kennungen verhindern nur Strafen. Sie geben keine Staff-Befehle und kein Admin-Menü.

• Eine Zeile zählt, solange expires_at leer ist oder in der Zukunft liegt.
• Akzeptierte Werte: eine license-, discord-, steam- oder fivem-Kennung oder eine citizenid. Präfixe werden entfernt.
• Laufzeiteinträge liegen im Speicher und gehen beim Neustart verloren.
• Beide Listen werden bei ts.Debug = true ignoriert.

Einstellungen, die den Umgang mit Staff ändern#

Diese Schlüssel in configs/anticheat_config.lua ändern, wie Teammitglieder und unberechtigte Menünutzer behandelt werden.

builtin.everyone und die IP-Prüfung beim Verbinden#

Jede ACE-Prüfung für Staff und Menü ignoriert eine ACE, die auch builtin.everyone hat. add_ace builtin.everyone command allow macht Spieler also nicht zu Teammitgliedern. Die IP-Prüfung beim Verbinden funktioniert anders.

Solange ts.v12.bypassStaffIpCheck nicht false ist, überspringt ein verbindender Spieler die Länder-Sperrliste und die Ablehnungen für VPN, Proxy und Hosting in jedem dieser Fälle: Der Spieler ist Staff; der Spieler hat die ACE command, txadmin, tx.admin, txadmin.menu, command.kick, command.ban oder einen der Namen group.admin, group.superadmin, group.moderator oder group.god; oder eine aktive Panel-Freigabe passt exakt auf die License des Spielers.

Diese Prüfung verwendet einfache ACE-Tests ohne builtin.everyone-Filter. Auf einem Server mit add_ace builtin.everyone command allow überspringt daher jeder Spieler die VPN- und Länderprüfungen. Die Join-Flood-Prüfung läuft trotzdem vor der Umgehung.

Datei für Discord-Webhooks#

configs/anticheat_webhooks.lua liest nur der Server. Sie enthält eine Discord-Webhook-URL pro Log-Kanal und den Embed-Stil. Jede URL wird mit dem Platzhalter WEBHOOK_URL_BURAYA ausgeliefert.

• Der HTTP-Sync des Panels überschreibt jeden Webhook, für den er eine nicht leere URL sendet.
• Andere Ressourcen erhalten die Webhook-URLs über getConfig('webhooks') nur, wenn sie vertrauenswürdige Aufrufer sind.
• Screenshot-Logs beschriften das Detections-Embed mit ts.punishType statt mit der tatsächlich ermittelten Strafe und senden zusätzlich an Webhooks.Bans, sobald ts.punishType BAN ist.
• Webhooks.WebhookAvatar setzt das Avatarbild des Embeds.

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

Wie das Panel die Konfigurationsdatei überschreibt#

Die meisten Werte in configs/anticheat_config.lua sind Standardwerte. Das Webpanel hält eigene Werte in ac_settings und anderen ac_-Tabellen, und diese Werte haben Vorrang. Bearbeiten Sie die Datei nur für Werte, die das Panel nicht verwaltet.

• Etwa 3 s nach dem Start und danach alle ts.ServerPerf.configSyncIntervalSec Sekunden (ausgeliefert 120, Minimum 20, Fallback 60) überschreiben Zeilen aus ac_settings die ts-Werte.
• Schlüssel mit Punkten wie AdminMenu.enable schreiben verschachtelte Felder. Alte flache Schlüssel wie framework oder moneyCheck werden zuerst zugeordnet.
• Ein punishment_-Schlüssel schreibt ts.DetectionPunishments für diese Erkennung. BAN und KICK bleiben erhalten; jeder andere Wert wird zu LOG.
• Aktionsfelder werden auf ban, kick, log, cancel, reject oder stop normalisiert. Jeder andere Wert wird zu log.
• Schlüssel, die mit globalBan. beginnen, werden ignoriert.
• Panel-Listen ersetzen Konfigurationslisten: Waffen, Fahrzeug-Blacklist, Kennzeichen, Trigger-Liste, Event-Limits, Ressourcen auf der Whitelist, OCR-Wörter, die Blacklist-Listen, die Explosionsliste und die Entity-Whitelists. Ressourcen auf der Whitelist und OCR-Wörter aus der Datenbank werden stattdessen zusammengeführt.
• Ausnahme: Die Handler für ts.EventLimiter und ts.ProtectedEvents werden einmal beim Laden aus der Datei registriert. Spätere Änderungen im Panel ändern die serverseitige Durchsetzung dafür nicht.
• Nach einer Änderung werden nur clientsichere Schlüssel erneut an Clients gesendet.
• Führen Sie tosunac_doctor in der Konsole aus, um riskante Werte nach dem Panel-Sync zu prüfen.

• Konfiguration und Leistung
• Panel-Einrichtung

Grundeinstellungen#

Schlüssel der obersten Ebene am Anfang von configs/anticheat_config.lua. Die meisten lassen sich auch im Panel setzen.

Konfigurationsabschnitte: Erkennungen und Strafen#

Abschnitte, die festlegen, was erkannt und wie hart es bestraft wird.

Konfigurationsabschnitte: serverseitige Guards#

Guards, die auf dem Server laufen. Mehrere davon brechen das Event zuerst ab und bestrafen erst nach wiederholten Strikes.

Konfigurationsabschnitte: Verbindung, Admin und Panel#

Abschnitte für beitretende Spieler, das Admin-Menü, die Panel-Verbindung und serverweites Verhalten.

Konfigurationsabschnitte: Ressourcen, Events und Integration#

Abschnitte für Ressourcen-Vertrauen, Scanner und die Entwickler-Integration. Mit „Für Entwickler“ markierte Zeilen sind nur relevant, wenn Ihre eigenen Skripte das AC aufrufen.

• Exports
• Events
• Framework

Konfigurationsabschnitte: Listen#

Standardlisten in configs/anticheat_config.lua. Die meisten werden beim Sync durch die Panel-Tabellen ersetzt.

Schlüssel ohne Wirkung und Schlüssel, die in der Datei fehlen#

Einige Schlüssel in configs/anticheat_config.lua werden vom Code in 9.6.15 nicht gelesen. Sie zu ändern, hat keine Wirkung.

Der Code liest außerdem Schlüssel, die nicht in der Datei stehen. Fügen Sie sie bei Bedarf selbst hinzu: ts.v12.joinFloodWindowSec (60), ts.v12.joinFloodMaxJoins (6), ts.v12.bannedCountries (Ländercodes; eine Geo-Sperrliste), ts.v6Enforcement.heuristic (ersetzt die Liste der Heuristik-Typen), ts.LiveWatch.fps (30), ts.SafeEventMaxArgs (64) und always = true bei Server-Events in ts.DetectionExempt.

Diese Client-Schalter werden gelesen, stehen aber nicht in der Datei, und sind aktiv, solange sie nicht auf false gesetzt werden: ts.antiScreenshotBypass, ts.antiRateOfFire und ts.antiNetOwnership. ts.microJitterMeanMin (0.5) wird ebenfalls gelesen, steht aber nicht in der Datei.

• ts.NetworkJoin.minimalSync
• ts.AdminMenu.espMaxDistance und ts.AdminMenu.screenshotTimeout (das ESP verwendet espMaxDist)
• ts.AdminMenu.permissionLevel (eine veraltete Bezeichnung; der Zugriff ergibt sich aus ACEs, Listen und Freigaben)
• ts.ResourceGuard.strictClientDiff
• ts.LiveWatch.enabled, preferTosunRender und maxConcurrent
• ts.PhoneNotify.enabled, onBan und onDetect

Veraltete Kommentare in der Konfigurationsdatei#

Einige Kommentare in configs/anticheat_config.lua beschreiben älteres Verhalten. Der Code funktioniert wie folgt.

• Laut Kommentar werden Panel-Einstellungen alle 30 s neu synchronisiert. Das Intervall ist ts.ServerPerf.configSyncIntervalSec (ausgeliefert 120 s).
• Laut Kommentar setzt tosunac_setup Events auf die Whitelist. Es katalogisiert sie nur; über den Schutz entscheidet ts.EventScanner.autoProtect.
• Der Kommentar zu ts.ProtectedEvents warnt, Framework-Events führten zu Fehlbanns. Aufrufe ohne Schlüssel werden abgelehnt und protokolliert, nie bestraft.
• Laut Kommentar zu ts.EventLimiter greift er, wenn das Limit überschritten wird. Er greift, wenn der Zähler den Wert erreicht.
• Der Bridge-Kommentar empfiehlt setr für alle vier Bridge-Convars. Nur tosun_ac_resource und tosun_ac_bridge_client_ms benötigen setr.
• Der Kommentar zu ts.Locale lässt ar aus, aber locales/ar.json wird mitgeliefert.

FiveM-Hardening-Convars, die das AC prüft#

Zwei Module lesen beim Start FiveM-Convars. Der Convar-Guard (ts.hardening) läuft etwa 8 s nach dem Start und behandelt einen nicht gesetzten Wert als schwach. Die server.cfg-Prüfung (ts.cfgAudit) läuft 15 s nach dem Start und ist nur lesend.

Hardening-Schalter und Ausgabe#

Beide Prüfungen melden standardmäßig nur. Ändern Sie sie in configs/anticheat_config.lua.

• ts.hardening.enabled = false überspringt den Convar-Guard.
• ts.hardening.autoApply = true (ausgeliefert false) lässt das AC set für die sechs sicheren Convars selbst ausführen. sv_entityLockdown und sv_pureLevel werden nie automatisch angewendet.
• ts.cfgAudit.enabled = false schaltet die server.cfg-Prüfung ab.
• Der Convar-Guard gibt eine Konsolenwarnung aus und schreibt eine ac_detections-Zeile (detection_type hardening_missing), die jede schwache Convar auflistet.
• Die Prüfung gibt eine Konsolenwarnung aus und schreibt eine admin_logs-Zeile mit der Anzahl schwacher Einstellungen.
• Der Konsolentext beider Prüfungen ist fest auf Türkisch. Jede Warnzeile des Guards zeigt die genaue hinzuzufügende set-Zeile.
• tosunac_doctor ist ein separater Konsolenbericht über riskante AC-Einstellungen, nicht über FiveM-Convars.

Häufige Fehler#

Prüfen Sie diese Punkte, bevor Sie ein Support-Ticket eröffnen.

• Zugangsdaten mit setr oder sets gesetzt: Sie erreichen jeden Client oder die öffentlichen Serverinformationen.
• Zugangsdaten nach ensure tosun-ac platziert: Sie werden erst beim nächsten Neustart der Ressource übernommen.
• Ein Panel-Schlüssel in configs/anticheat_config.lua: Die Datei wird an Clients gesendet, und die Konsole gibt eine MIGRATION-Warnung aus.
• tosun_render nicht gestartet: Es ist eine zwingende Abhängigkeit.
• ts.Framework.framework auf einem ESX- oder Qbox-Server bei "qb" belassen.
• ts.Locale auf einem Server, der kein Türkisch verwendet, bei "tr" belassen.
• ts.appealDiscord beim Discord-Link des Herstellers belassen.
• ts.punishType auf LOG oder KICK gesetzt: Auch manuelle Banns werden zu Logs oder Kicks.
• add_ace builtin.everyone command allow: Jeder Spieler überspringt die VPN- und Länderprüfungen.
• Erwartet, dass tosun.admin tosunac_setup freischaltet: Dafür sind tosunac.admin plus command.tosunac_setup nötig.
• Erwartet, dass txAdmin-Admins das AC-Menü öffnen können: txAdmin-ACEs geben nur Staff-Status. Fügen Sie tosun.admin oder eine Panel-Freigabe hinzu.
• set tosun_db_bridge_enabled "0" ohne tosun_db_bridge_manual "1": Die Zeile wird ignoriert.
• ts.Debug auf true belassen: Die Umgehungen für Staff und Whitelist sind aus.

• Start
• Befehle