server.cfg, convars et permissions

Où se trouve la configuration#

Tosun AntiCheat lit ses réglages depuis server.cfg, quatre fichiers de la ressource et le panel web. Les identifiants secrets n'ont leur place que dans des emplacements réservés au serveur. configs/anticheat_config.lua est un script partagé : le serveur l'envoie donc à chaque client.

• Installation
• Configuration du panel
• Clé de licence

Exemple complet de server.cfg#

Un bloc complet pour une installation type. L'ordre compte : les dépendances et les convars d'identifiants doivent venir avant ensure tosun-ac, car les identifiants sont résolus une seule fois au chargement de la ressource. Les lignes qui commencent par un seul # sont facultatives ; retirez le # pour les utiliser.

## ---------- Tosun AntiCheat : bloc server.cfg ----------
## OneSync est une dépendance du manifeste (txAdmin peut aussi l'activer).
set onesync on

## Dépendances : démarrez-les avant tosun-ac.
## oxmysql et tosun_render sont des dépendances obligatoires.
## screenshot-basic est le ts.screenshotModule par défaut.
## Configurez mysql_connection_string avant ensure oxmysql (voir le guide MySQL).
ensure oxmysql
ensure screenshot-basic
ensure tosun_render

## Identifiants : utilisez set (jamais setr ni sets) et placez-les AU-DESSUS de ensure tosun-ac.
## Ils sont lus une seule fois au chargement de la ressource.
## Format de licence : tac_live_ suivi de 40 caractères hexadécimaux en minuscules.
set tosun_ac_license "YOUR_LICENSE_KEY"
## Facultatif : si elle est vide, la clé du panel est chargée depuis panel_settings dans la base du jeu.
# set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
# set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
## Facultatif : utilisé uniquement par ts.licenseLock.
# set tosun_ac_server_id "server-1"

## Ressources autorisées à appeler les exports protégés de l'AC (séparées par des virgules).
set tosun_ac_trusted_resources "my-housing,my-clothing"

## Facultatif : adresse https publique du panel pour l'envoi des captures et des preuves.
# set ts_public_panel_url "https://panel.example.com"

## Facultatif : contrôler le DB bridge Tosun Connect depuis ce fichier.
## Sans la ligne manual (et avec ts.panelMirror désactivé), les deux convars du bridge sont forcées à "1".
# set tosun_db_bridge_manual "1"
# set tosun_db_bridge_enabled "1"
# set tosun_db_bridge_money_write "0"

## Facultatif : désactiver l'enregistrement du temps de jeu (qb, qbcore et qbox uniquement).
# set tosun_panel_playtime "0"

## Facultatif, pour les intégrateurs qui utilisent les fichiers bridge. Les clients les lisent : utilisez donc setr.
# setr tosun_ac_resource "tosun-ac"
# setr tosun_ac_bridge_client_ms "60000"

ensure tosun-ac

## ---------- Permissions du staff ----------
## Statut staff et menu admin en jeu :
add_ace group.admin tosun.admin allow
## tosunac_setup, les scans manuels et l'aperçu de l'écran de ban :
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
## Une ligne par membre du staff :
add_principal identifier.license:YOUR_LICENSE_HEX group.admin

## ---------- Convars de durcissement FiveM vérifiées par l'AC au démarrage ----------
set sv_stateBagStrictMode true
set sv_filterRequestControl 2
set sv_enableNetworkedSounds false
set sv_enableNetworkedPhoneExplosions false
set sv_enableNetworkedScriptEntityStates false
set sv_scriptHookAllowed false
## Testez d'abord : relaxed ou strict peut casser les scripts qui font apparaître des véhicules depuis le client.
set sv_entityLockdown relaxed
set sv_pureLevel 1
## L'audit de server.cfg avertit tant que cette valeur est vide :
# set sv_enforceGameBuild YOUR_GAME_BUILD

• Configuration MySQL
• Guide de configuration

Règles pour le bloc server.cfg#

Suivez ces règles quand vous adaptez l'exemple à votre serveur.

• Démarrez oxmysql et tosun_render avant tosun-ac. Le manifeste déclare comme dépendances le build serveur 4890 ou plus récent, OneSync, oxmysql et tosun_render.
• Démarrez screenshot-basic si vous gardez le ts.screenshotModule par défaut.
• Placez chaque ligne set tosun_ac_ d'identifiant avant ensure tosun-ac. Les valeurs sont lues une seule fois au chargement ; un changement ultérieur nécessite un redémarrage de la ressource.
• Utilisez set pour les identifiants. setr réplique la valeur vers chaque client, et sets la publie dans les informations publiques du serveur.
• N'utilisez setr que pour les convars lues par les clients : ts_screen_upload, tosun_ac_resource et tosun_ac_bridge_client_ms.
• Aucune ligne de DB bridge n'est nécessaire. Depuis la 9.6.14, le bridge est actif par défaut, et les lignes set ... "0" sont ignorées sauf si tosun_db_bridge_manual vaut "1" ou si ts.panelMirror.enabled = true.
• Les anciens guides d'installation (INSTALLER-READY.md, INSTALLER-LICENSE.md, INSTALL-MULTILANG.md, CONFIG-PERFORMANCE-GUIDE.md) placent ensure avant les identifiants, mettent la clé du panel dans configs/anticheat_config.lua et omettent tosun_render. Suivez plutôt cette page.

Référence des convars#

Toutes les convars lues par Tosun AntiCheat que vous pouvez définir. Utilisez set, sauf si la colonne Remarques indique setr. L'AC écrit et lit aussi quelques convars internes qui lui sont propres ; elles sont protégées et vous ne devez pas les définir.

Identifiants : priorité et bonnes pratiques#

Trois identifiants sont résolus une seule fois au chargement de la ressource : la clé de licence, la clé API du panel et le jeton central. Pour chacun, l'AC prend la première valeur non vide dans cet ordre.

L'avertissement MIGRATION vous demande de vider la valeur partagée et de renouveler tout identifiant qui y a été stocké un jour, car ce fichier est envoyé à chaque client.

Une valeur de plus de 4096 caractères, ou qui contient des caractères de contrôle, arrête le chargement avec une erreur Invalid server credential setting.

Clé du panel uniquement : si elle est encore vide après ces étapes, l'AC copie panel_settings.ac_api_key depuis la base du jeu. À chaque démarrage, l'AC écrit la clé résolue en clair dans la ligne webPanelKey de ac_settings. Si quelqu'un modifie cette ligne dans le panel, la valeur modifiée remplace la vôtre jusqu'au redémarrage suivant.

Clé de licence uniquement : le verrou de licence accepte les formats tac_live_ plus 40 caractères hexadécimaux en minuscules (49 caractères), TOSUN-AC-YYYY-... et TOSUN-.... La vérification du format ne s'exécute que lorsque ts.licenseLock.enabled = true, et elle ne vérifie que le format.

1. La convar du serveur : tosun_ac_license, tosun_ac_panel_key ou tosun_ac_central_token.
2. La valeur dans configs/anticheat_server.lua : licenseKey, panelKey ou centralToken.
3. L'ancienne valeur dans le fichier partagé configs/anticheat_config.lua : ts.licenseLock.licenseKey, ts.webPanelKey ou ts.Central.token. Toute valeur à cet endroit affiche un avertissement MIGRATION dans la console.

• Clé de licence

configs/anticheat_server.lua#

Utilisez ce fichier réservé au serveur si vous préférez ne pas mettre les identifiants dans server.cfg. Il se charge avant les scripts serveur de l'AC et s'arrête immédiatement sur les clients. Laissez un emplacement vide pour continuer à utiliser la convar ou la récupération depuis la base.

• Une convar non vide l'emporte toujours sur la valeur de ce fichier.
• Laissez vides les emplacements correspondants dans configs/anticheat_config.lua : ts.webPanelKey, ts.Central.token et ts.licenseLock.licenseKey.
• Gardez privées les sauvegardes de ce fichier.
• Le fichier ne fait que remplir ts.webPanelKey, ts.Central.token et ts.licenseLock.licenseKey. Les autres scripts lisent ces valeurs, pas le fichier.

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

URL du panel et envoi des captures d'écran#

ts.webPanelURL dans configs/anticheat_config.lua est l'URL de base du panel. Vous pouvez la laisser vide : dans ce cas, l'AC charge panel_url ou site_url depuis panel_settings dans la base du jeu et la stocke dans ac_settings. La synchro HTTP des réglages ne s'exécute que lorsque l'URL et la clé du panel sont toutes deux définies.

Définissez ts_public_panel_url uniquement quand les captures d'écran, les preuves de ban et les vidéos en direct doivent aller vers une autre adresse publique. Elle doit être en https. Les jetons d'envoi ne sont émis pour https://host/api/screen_upload.php que lorsque la base est égale à cette convar ou à ts.webPanelURL.

ts_screen_upload est un chemin distinct utilisé par l'export screenCapture et les commandes /capture et /ts_capture. Elle nécessite setr, et sa valeur par défaut pointe vers localhost. Rien dans l'AC ne traite le résultat de cet envoi.

Les anciens noms ts.PanelUrl, ts.panelUrl et ts.webPanelUrl sont toujours lus en solution de repli.

• Configuration du panel

Convars du DB bridge Tosun Connect#

Depuis la 9.6.14, le DB bridge à la demande est actif par défaut et ne nécessite aucune ligne dans server.cfg. Au chargement, editable/server/tosun_db_bridge_defaults.lua règle tosun_db_bridge_enabled et tosun_db_bridge_money_write sur "1" : les lignes "0" des anciens guides sont donc ignorées.

Vous pouvez aussi couper la connexion pour un serveur dans le panel : Servers, puis le serveur, puis la carte Tosun Connect.

Le bridge interroge https://admin.tosundev.com/api/server_db_bridge.php, envoie votre clé de licence comme jeton Bearer et n'exécute que ces opérations : players.list, player.detail, player.vehicles, bans.list, logs.list et player.money.set.

Avec ts.panelMirror.enabled = true, l'AC ne force pas l'activation du bridge : l'ancien miroir continue donc de fonctionner. Le miroir lui-même ne tourne pas tant que tosun_db_bridge_enabled vaut "1".

Les commandes console tosunac_db_status et tosunac_db_check affichent l'état du bridge et testent oxmysql.

1. Pour contrôler le bridge depuis server.cfg, ajoutez set tosun_db_bridge_manual "1" avant ensure tosun-ac.
2. Ajoutez set tosun_db_bridge_enabled avec "1" ou "0".
3. Ajoutez set tosun_db_bridge_money_write avec "1" ou "0". Sans "1", player.money.set échoue avec write_disabled et n'est pas annoncé au panel.

• Configuration MySQL

Convars pour les développeurs de scripts#

Ces convars ne comptent que lorsqu'une autre ressource appelle l'AC. tosun_ac_trusted_resources décide quelles ressources peuvent appeler les exports protégés ; les convars du bridge configurent les fichiers bridge facultatifs.

Les exports protégés incluent SetExempt, SetPlayerExempt, les exports Pause, BypassDetection, addAdmin, whitelistPlayer, approveResource, ban, offlineBan, les exports webBridge et quarantine.

La console du serveur et tosun-ac lui-même sont toujours de confiance. Un appel non fiable est refusé ; pour chaque couple ressource et export, l'AC affiche un avertissement dans la console et écrit une ligne de log dans le panel qui cite cette convar. Avec ts.EnforceExportCallerWhitelist = false, l'appel s'exécute et n'est journalisé qu'une fois.

Les appelants de confiance obtiennent aussi MarkTeleport sans le budget par joueur.

INTEGRATION.md et bridge/INTEGRATION.txt indiquent set pour tosun_ac_resource et tosun_ac_bridge_client_ms. Utilisez plutôt setr : le bridge client lit les deux sur le client.

Des événements et exports internes de l'AC existent aussi. Ils sont protégés et ne doivent pas être appelés depuis vos ressources.

# Ressources autorisées à appeler les exports protégés (séparées par des virgules ou des espaces)
set tosun_ac_trusted_resources "my-housing,my-clothing"

# Fichiers bridge dans votre propre 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
• Référence des exports
• Événements

Permissions ACE#

Tous les ACE vérifiés par Tosun AntiCheat. Accordez les ACE à un groupe et ajoutez le staff à ce groupe avec add_principal. Un ACE que builtin.everyone possède aussi ne fait jamais de quelqu'un un membre du staff.

• Commandes

Commandes restreintes et réservées à la console#

Dix commandes de l'AC sont enregistrées comme restreintes. En jeu, FiveM exige alors l'ACE de commande correspondant en plus de la vérification propre à l'AC. Cinq des dix ignorent complètement les joueurs.

banscreentest n'est pas restreinte. La forme console banscreentest playerId ne nécessite aucun ACE ; /banscreentest en jeu nécessite tosunac.banscreen.test ou tosunac.admin. Les refus de tosunac_setup, des deux scans et de banscreentest sont silencieux.

tosunac_setup n'approuve rien si le scan de backdoors ou de signatures ne se termine pas, y compris quand ts.BackdoorGuard est désactivé. Un second lancement pendant qu'un premier est en cours est refusé.

• Commandes

Comment le staff est reconnu#

L'AC a deux niveaux d'accès distincts. Le statut staff donne l'exemption de sanction et les commandes du staff (sous-commandes /ts et commandes ts_). L'accès au menu ouvre le menu admin en jeu. Certaines sources n'accordent que l'un des deux.

L'exemption de sanction du staff ne s'applique que tant que ts.AdminBypassDetections = true (valeur fournie) et ts.Debug = false (valeur fournie).

L'accès au menu nécessite aussi que ts.AdminMenu.enable et ts.AdminMenu.enabled restent à true. Si l'un des deux vaut false, le menu, la touche F7 et les commandes client des outils d'administration ne sont pas enregistrés.

Les membres du staff qui ont le statut staff sans accès au menu, par exemple le staff uniquement txAdmin, peuvent quand même appuyer sur F7. La demande est refusée et journalisée.

• Commandes

Listes d'identifiants : Admins, allowedIds et AdminBypassIdentifiers#

Utilisez des identifiants complets, comme des valeurs license:, steam:, discord: ou fivem:. Préférez admins/anticheat_admins.lua ou les autorisations du panel pour le staff : ce fichier est réservé au serveur, alors que configs/anticheat_config.lua est envoyé à chaque client.

• Admins : une entrée correspond à l'identifiant complet (sans tenir compte de la casse) ou à la partie après le préfixe. Elle accorde le statut staff et le menu.
• ts.AdminMenu.allowedIds : statut staff et menu. Les valeurs "all" et "staff" n'accordent rien.
• ts.AdminBypassIdentifiers : statut staff et exemption uniquement, pas de menu.

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

-- configs/anticheat_config.lua (partagé, envoyé aux clients)
ts.AdminMenu = {
    -- les autres clés du menu restent telles que fournies
    allowedIds = {
        "license:YOUR_EXACT_PLAYER_IDENTIFIER",
    },
}
ts.AdminBypassIdentifiers = {}  -- statut staff et exemption, pas de menu

Autorisations du panel et export addAdmin#

Les autorisations du panel sont des lignes de ac_v7_admin_grants que vous créez dans le panel web. Une autorisation active correspond à la license ou à la license2 du joueur, avec ou sans préfixe, et donne le statut staff et l'accès au menu.

Une réponse positive est mise en cache 5 s et une négative 30 s : une nouvelle autorisation peut donc mettre jusqu'à 30 s à s'appliquer à un joueur déjà vérifié.

Une ressource de confiance peut appeler l'export addAdmin pour donner à un joueur le statut staff et l'accès au menu jusqu'à l'appel de removeAdmin. Tant que ts.EnforceExportCallerWhitelist vaut true, l'appelant doit être listé dans tosun_ac_trusted_resources ou ts.ExportCallerWhitelist.

• Configuration du panel
• Exports

La liste blanche des joueurs n'est pas le staff#

La liste blanche des joueurs du panel (ac_whitelist) et les identifiants ajoutés à l'exécution par les exports de liste blanche ne font que suspendre les sanctions. Ils ne donnent ni commandes du staff ni menu admin.

• Une ligne compte tant que expires_at est vide ou dans le futur.
• Valeurs acceptées : un identifiant license, discord, steam ou fivem, ou un citizenid. Les préfixes sont retirés.
• Les entrées ajoutées à l'exécution sont gardées en mémoire et perdues au redémarrage.
• Les deux listes sont ignorées tant que ts.Debug = true.

Réglages qui modifient le traitement du staff#

Ces clés de configs/anticheat_config.lua modifient la façon dont sont traités le staff et les utilisateurs du menu non autorisés.

builtin.everyone et la vérification d'IP à la connexion#

Toutes les vérifications d'ACE pour le staff et le menu ignorent un ACE que builtin.everyone possède aussi. Ainsi, add_ace builtin.everyone command allow ne fait pas des joueurs des membres du staff. La vérification d'IP à la connexion fonctionne différemment.

Tant que ts.v12.bypassStaffIpCheck n'est pas false, un joueur qui se connecte échappe à la liste de pays refusés et aux refus VPN, proxy et hébergeur dans chacun de ces cas : le joueur est staff ; le joueur a l'ACE command, txadmin, tx.admin, txadmin.menu, command.kick, command.ban ou l'un des noms group.admin, group.superadmin, group.moderator ou group.god ; ou une autorisation active du panel correspond exactement à la licence du joueur.

Cette vérification utilise de simples tests d'ACE sans filtre builtin.everyone. Sur un serveur avec add_ace builtin.everyone command allow, chaque joueur échappe donc aux vérifications VPN et pays. La vérification anti-afflux de connexions s'exécute quand même avant cette exception.

Fichier des webhooks Discord#

configs/anticheat_webhooks.lua est réservé au serveur. Il contient une URL de webhook Discord par canal de log et le style des embeds. Chaque URL est livrée avec la valeur de remplacement WEBHOOK_URL_BURAYA.

• La synchro HTTP du panel écrase tout webhook pour lequel elle envoie une URL non vide.
• Les autres ressources ne reçoivent les URL des webhooks via getConfig('webhooks') que si elles sont des appelants de confiance.
• Les logs de capture d'écran étiquettent l'embed Detections avec ts.punishType plutôt qu'avec la sanction réellement appliquée, et publient aussi dans Webhooks.Bans chaque fois que ts.punishType vaut BAN.
• Webhooks.WebhookAvatar définit l'image d'avatar de l'embed.

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

Comment le panel remplace le fichier de config#

La plupart des valeurs de configs/anticheat_config.lua sont des valeurs par défaut. Le panel web garde ses propres valeurs dans ac_settings et dans d'autres tables ac_, et ce sont elles qui l'emportent. Ne modifiez le fichier que pour les valeurs que le panel ne gère pas.

• Environ 3 s après le démarrage, puis toutes les ts.ServerPerf.configSyncIntervalSec secondes (120 par défaut, minimum 20, repli 60), les lignes de ac_settings écrasent les valeurs ts.
• Les clés avec des points, comme AdminMenu.enable, écrivent des champs imbriqués. Les anciennes clés plates comme framework ou moneyCheck sont d'abord converties.
• Une clé punishment_ écrit ts.DetectionPunishments pour cette détection. BAN et KICK sont conservés ; toute autre valeur devient LOG.
• Les champs d'action sont normalisés en ban, kick, log, cancel, reject ou stop. Toute autre valeur devient log.
• Les clés qui commencent par globalBan. sont ignorées.
• Les listes du panel remplacent celles de la config : armes, liste noire des véhicules, plaques, liste des triggers, limites d'événements, ressources en liste blanche, mots OCR, listes Blacklist, liste des explosions et listes blanches d'entités. Les ressources en liste blanche et les mots OCR venant de la base sont fusionnés au lieu d'être remplacés.
• Exception : les gestionnaires de ts.EventLimiter et ts.ProtectedEvents sont enregistrés une seule fois depuis le fichier au chargement. Les changements ultérieurs dans le panel ne modifient pas leur application côté serveur.
• Après un changement, seules les clés sans risque pour le client sont renvoyées aux clients.
• Lancez tosunac_doctor dans la console pour passer en revue les valeurs risquées après la synchro du panel.

• Configuration et performances
• Configuration du panel

Réglages principaux#

Clés de premier niveau au début de configs/anticheat_config.lua. La plupart peuvent aussi être définies depuis le panel.

Sections de configuration : détections et sanctions#

Sections qui décident de ce qui est détecté et de la sévérité de la sanction.

Sections de configuration : guards côté serveur#

Guards qui tournent sur le serveur. Plusieurs d'entre eux annulent d'abord l'événement et ne sanctionnent qu'après des avertissements (strikes) répétés.

Sections de configuration : connexion, administration et panel#

Sections pour les joueurs qui se connectent, le menu admin, la connexion au panel et le comportement global du serveur.

Sections de configuration : ressources, événements et intégration#

Sections pour la confiance accordée aux ressources, les scanners et l'intégration pour les développeurs. Les lignes marquées pour les développeurs ne comptent que lorsque vos propres scripts appellent l'AC.

• Exports
• Événements
• Framework

Sections de configuration : listes#

Listes par défaut de configs/anticheat_config.lua. La plupart sont remplacées par les tables du panel lors de la synchro.

Clés sans effet et clés absentes du fichier#

Certaines clés de configs/anticheat_config.lua ne sont pas lues par le code de la 9.6.15. Les modifier n'a aucun effet.

Le code lit aussi des clés que le fichier ne contient pas. Ajoutez-les vous-même si vous en avez besoin : ts.v12.joinFloodWindowSec (60), ts.v12.joinFloodMaxJoins (6), ts.v12.bannedCountries (codes pays ; une liste de refus géographique), ts.v6Enforcement.heuristic (remplace la liste des types d'heuristiques), ts.LiveWatch.fps (30), ts.SafeEventMaxArgs (64), et always = true sur les événements serveur de ts.DetectionExempt.

Ces interrupteurs client sont lus mais absents du fichier, et sont actifs sauf s'ils valent false : ts.antiScreenshotBypass, ts.antiRateOfFire et ts.antiNetOwnership. ts.microJitterMeanMin (0.5) est aussi lu mais absent du fichier.

• ts.NetworkJoin.minimalSync
• ts.AdminMenu.espMaxDistance et ts.AdminMenu.screenshotTimeout (l'ESP utilise espMaxDist)
• ts.AdminMenu.permissionLevel (un libellé historique ; l'accès vient des ACE, des listes et des autorisations)
• ts.ResourceGuard.strictClientDiff
• ts.LiveWatch.enabled, preferTosunRender et maxConcurrent
• ts.PhoneNotify.enabled, onBan et onDetect

Commentaires obsolètes dans le fichier de config#

Quelques commentaires de configs/anticheat_config.lua décrivent un ancien comportement. Le code fonctionne comme suit.

• Le commentaire indique que les réglages du panel se resynchronisent toutes les 30 s. L'intervalle est ts.ServerPerf.configSyncIntervalSec (120 s par défaut).
• Le commentaire indique que tosunac_setup met les événements en liste blanche. Elle ne fait que les cataloguer ; c'est ts.EventScanner.autoProtect qui décide de la protection.
• Le commentaire de ts.ProtectedEvents prévient que les événements de framework provoquent de faux bans. Les appels sans clé sont rejetés et journalisés, jamais sanctionnés.
• Le commentaire de ts.EventLimiter indique qu'il se déclenche quand la limite est dépassée. Il se déclenche quand le compteur atteint la valeur.
• Le commentaire du bridge recommande setr pour les quatre convars du bridge. Seules tosun_ac_resource et tosun_ac_bridge_client_ms nécessitent setr.
• Le commentaire de ts.Locale omet ar, mais locales/ar.json est bien fourni.

Convars de durcissement FiveM vérifiées par l'AC#

Deux modules lisent les convars FiveM au démarrage. La garde des convars (ts.hardening) s'exécute environ 8 s après le démarrage et considère une valeur non définie comme faible. L'audit de server.cfg (ts.cfgAudit) s'exécute 15 s après le démarrage et fonctionne en lecture seule.

Interrupteurs et sortie du durcissement#

Par défaut, les deux contrôles se contentent de signaler. Modifiez-les dans configs/anticheat_config.lua.

• ts.hardening.enabled = false désactive la garde des convars.
• ts.hardening.autoApply = true (false par défaut) laisse l'AC exécuter lui-même set pour les six convars sûres. sv_entityLockdown et sv_pureLevel ne sont jamais appliquées automatiquement.
• ts.cfgAudit.enabled = false désactive l'audit de server.cfg.
• La garde des convars affiche un avertissement dans la console et écrit une ligne dans ac_detections (detection_type hardening_missing) qui liste chaque convar faible.
• L'audit affiche un avertissement dans la console et écrit une ligne dans admin_logs avec le nombre de réglages faibles.
• Le texte console des deux contrôles est codé en dur en turc. Chaque ligne d'avertissement de la garde indique la ligne set exacte à ajouter.
• tosunac_doctor est un rapport console distinct sur les réglages risqués de l'AC, pas sur les convars FiveM.

Erreurs fréquentes#

Vérifiez ces points avant d'ouvrir un ticket de support.

• Identifiants définis avec setr ou sets : ils arrivent sur chaque client ou dans les informations publiques du serveur.
• Identifiants placés après ensure tosun-ac : ils ne sont pas pris en compte avant le prochain redémarrage de la ressource.
• Une clé du panel dans configs/anticheat_config.lua : le fichier est envoyé aux clients et la console affiche un avertissement MIGRATION.
• tosun_render non démarré : c'est une dépendance obligatoire.
• ts.Framework.framework laissé à "qb" sur un serveur ESX ou Qbox.
• ts.Locale laissé à "tr" sur un serveur qui n'utilise pas le turc.
• ts.appealDiscord laissé sur le lien Discord de l'éditeur.
• ts.punishType réglé sur LOG ou KICK : les bans manuels deviennent aussi des logs ou des expulsions.
• add_ace builtin.everyone command allow : chaque joueur échappe aux vérifications VPN et pays.
• Penser que tosun.admin débloque tosunac_setup : il faut tosunac.admin plus command.tosunac_setup.
• Penser que les admins txAdmin peuvent ouvrir le menu de l'AC : les ACE txAdmin ne donnent que le statut staff. Ajoutez tosun.admin ou une autorisation du panel.
• set tosun_db_bridge_enabled "0" sans tosun_db_bridge_manual "1" : la ligne est ignorée.
• ts.Debug laissé à true : les exclusions du staff et de la liste blanche sont désactivées.

• Démarrage
• Commandes