Commandes

Avant de commencer#

Tosun AC ajoute une commande principale, /ts, avec de nombreuses sous-commandes. Il ajoute aussi des commandes de modération autonomes, des commandes de maintenance réservées à la console et quelques commandes client pour le menu admin. Chaque groupe a sa propre vérification de permission et son propre endroit d'affichage du résultat : lisez donc cette section en premier.

• La plupart des sous-commandes /ts et toutes les commandes de modération ts_* écrivent leur résultat dans la console du serveur. Un admin en jeu ne voit rien dans le chat, sauf la carte d'aide /ts et la carte d'absence de permission.
• Les outils joueur (mute, sethp, giveweapon et les autres) et les commandes ac* répondent dans le chat quand vous les utilisez en jeu.
• Beaucoup de réponses sont codées en dur en turc. La carte d'absence de permission affiche toujours « Bu komutu kullanmak için yetkiniz yok! ».
• Les commandes autonomes comme /freeze ou /mute ne sont pas des sous-commandes /ts. /ts freeze 5 affiche seulement « Unknown command » dans la console.
• Les noms courts comme revive, warn, players, freeze, mute, broadcast, setweather, settime, giveweapon, capture et emergency peuvent entrer en conflit avec les commandes d'autres ressources. En cas de doute, utilisez la forme ts_.
• Si le menu admin est désactivé (ts.AdminMenu.enable ou ts.AdminMenu.enabled = false), les commandes client tsmenu, unspectate, stopspectate, tsdelaimed et tsfreecam, le raccourci DELETE et la touche F7 ne sont pas enregistrés du tout.

Niveaux de permission#

Chaque commande vérifie l'un des niveaux ci-dessous. La console du serveur passe toutes les vérifications côté serveur, sauf pour les deux commandes de téléportation réservées au jeu. Les commandes client ne peuvent pas être lancées depuis la console. Cette page utilise ces noms de niveau dans tous les tableaux.

• tosun.admin (STAFF et MENU) et tosunac.admin (commandes de maintenance) sont deux ACE différents. Donnez les deux aux admins complets.
• Les ACE accordés à builtin.everyone ne comptent jamais comme STAFF ou MENU.
• group.admin et les autres noms de groupe sont testés comme objets ACE. Accordez un ACE explicite comme tosun.admin au lieu de compter uniquement sur l'appartenance au groupe.

• Configuration du serveur

Accorder l'accès dans server.cfg#

Le premier bloc ci-dessous est la partie ACE du modèle d'installation type. Il donne au principal group.admin l'accès staff, menu, maintenance et test de l'écran de ban, puis ajoute un joueur à ce groupe. Remplacez <HEX> par la licence du joueur. Les deux lignes facultatives ne sont pas dans le modèle ; ajoutez-les seulement si le staff doit lancer ts_setlang ou ts_v9_help en jeu.

Vous pouvez aussi accorder l'accès sans ACE. Un identifiant dans admins/anticheat_admins.lua (Admins) ou dans ts.AdminMenu.allowedIds donne STAFF et MENU. Un identifiant dans ts.AdminBypassIdentifiers donne seulement STAFF. Une autorisation admin dans le panel web donne STAFF et MENU.

Les valeurs « all » et « staff » dans ts.AdminMenu.allowedIds ne sont pas des identifiants et n'accordent rien.

add_ace group.admin tosun.admin allow
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
add_principal identifier.license:<HEX> group.admin

# facultatif, absent du modèle : les deux commandes d'aide restreintes
add_ace group.admin command.ts_setlang allow
add_ace group.admin command.ts_v9_help allow

• Configuration du serveur
• Configuration du panel

Où s'affichent les résultats#

Regardez la console du serveur quand une commande semble ne rien faire en jeu.

La commande /ts#

/ts est une seule commande serveur. Le premier mot qui suit choisit la sous-commande et n'est pas sensible à la casse. Dans la console du serveur, tapez la même ligne sans la barre oblique, par exemple ts banlist.

• /ts ou /ts menu en jeu ouvre ou ferme le menu admin et nécessite MENU. Dans la console, la commande affiche la liste d'aide.
• Toutes les autres sous-commandes nécessitent STAFF en jeu. Sans ce niveau, vous recevez la carte d'absence de permission et rien ne se passe.
• Une sous-commande inconnue affiche « Unknown command. Type ts help. For extra commands: ts_v9_help » dans la console du serveur uniquement.
• Alias : evtlist = faketriggerlist = evtliste ; evtwhitelist = faketriggeroff = evtoff ; evttrap = faketriggeron = evton ; evtscan = faketriggerscan = evtara ; sigpatterns = sigexc_help ; quarantine = karantina ; release = serbest ; quarantines = karantinalar ; sous sigexc et sigskip, del = remove.
• La liste d'aide de la console (ts help) est incomplète. Elle omet quarantine, release, quarantines, les alias et les secondes facultatives de ts whitelist. La carte d'aide /ts en jeu ne liste que /ts, ban, kick, unban et help. Cette page contient la liste complète.

/ts ban 12 aimbot          (in game)
ts banlist 2               (server console)

/ts : menu, aide et état#

Sous-commandes générales. La sortie s'affiche dans la console du serveur, sauf indication contraire dans le tableau.

/ts : bans et expulsions#

Les bans manuels utilisent le même circuit de sanction que les détections. La sortie s'affiche dans la console du serveur.

• Les ID de ban ont la forme XXXX-XXXX, ou #NNNN quand ts.banIDFormat = 2.
• ts.punishType contrôle aussi les bans manuels. Si vous le réglez sur LOG ou KICK, /ts ban ne fait que journaliser ou expulser.
• Les cibles du staff (tant que ts.AdminBypassDetections est actif), en liste blanche ou en liste blanche du panel sont ignorées en silence, sauf si ts.Debug est actif. La ligne [BAN] s'affiche quand même.

/ts : liste blanche, exemption et quarantaine#

Utilisez ces commandes pour suspendre les sanctions d'un joueur pendant un temps, ou pour isoler un suspect au lieu de le bannir. Les entrées de liste blanche et d'exemption sont gardées en mémoire, indexées par ID serveur, et prennent fin à la déconnexion du joueur.

• La durée de quarantaine est de 300 s par défaut et bornée entre 30 s et ts.quarantine.maxSeconds (1800 par défaut). Le motif par défaut est « admin karantinasi ».
• La quarantaine refuse les joueurs exemptés de sanction : staff, joueurs en liste blanche, en liste blanche du panel ou exemptés temporairement.
• Avec ts.quarantine.enabled = false, le module de quarantaine n'est pas chargé et la commande affiche la ligne d'échec.
• Un joueur déjà en quarantaine produit quand même une ligne de succès.

/ts : supprimer des entités#

Ces sous-commandes suppriment des entités sur tout le serveur d'un coup. Il n'y a aucune étape de confirmation. La sortie s'affiche dans la console du serveur.

/ts : événements honeypot#

Les honeypots sont de faux événements de trigger que les vrais scripts ne devraient jamais déclencher : un joueur qui en déclenche un peut donc être banni. La liste active est stockée dans la table ac_protected_events. La sortie s'affiche dans la console du serveur.

/ts : exceptions du scanner de signatures#

Utilisez ces commandes quand le scanner de signatures signale un script légitime. Le code de signature apparaît dans la ligne de log [Signature Scanner]. Les exceptions et les exclusions sont stockées en base de données. La sortie s'affiche dans la console du serveur.

/ts sigexc ou /ts sigskip sans deuxième mot valide affiche une aide d'usage.

ts sigexc add my-job lua_loadstring client/main.lua
ts sigskip add my-escrow-pack

Commandes de modération (forme ts_ et nom court)#

Ces 17 commandes ne sont pas des sous-commandes /ts. Chacune existe sous la forme ts_<name> et sous le nom court <name>, par exemple /ts_freeze 7 ou /freeze 7. Les deux nécessitent STAFF en jeu, et la console peut les lancer. Tous les résultats vont dans la console du serveur.

• Un ts_<name> refusé affiche « [ts_<name>] Yetersiz yetki. » dans la console. Un nom court refusé ne fait rien.
• Le nom court relance ts_<name> comme commande serveur après avoir retiré les points-virgules, les guillemets doubles et les sauts de ligne. Cette commande imbriquée s'exécute très probablement en tant que console. Résultat : /tphere et /tpto échouent, /adminsync exige un ID, /kickall vous expulse aussi et /warn enregistre l'émetteur comme console. Utilisez la forme ts_ pour ces commandes et vérifiez une fois en jeu.
• ts_v9_help liste ces commandes sous la forme « ts freeze <id> », etc. Cette syntaxe ne fonctionne pas ; tapez ts_freeze ou freeze.

Outils joueur (mute, sethp, giveweapon ...)#

Ces 11 commandes existent sous la forme ts_<name> et <name>, et les deux formes vous voient comme émetteur : les noms courts fonctionnent donc en jeu. Elles nécessitent STAFF ; la console peut les lancer. Un refus est silencieux. La réponse va dans votre chat, ou dans la console sous la forme « [AC] ... ». Les réponses sont surtout en turc.

Commandes rapides (acwarn, acfreeze, acstats ...)#

Cinq commandes courtes qui répondent dans le chat. Toutes sauf /acping nécessitent STAFF ou la console, et un refus est silencieux.

Commandes de maintenance et de diagnostic#

Lancez-les depuis la console du serveur. Quelques-unes peuvent aussi être lancées en jeu avec les ACE indiqués. La sortie va toujours dans la console du serveur, sauf pour banscreentest.

Les refus de tosunac_setup, tosunac_backdoorscan, tosunac_eventscan et banscreentest sont silencieux. Un second tosunac_setup lancé pendant qu'un premier tourne est refusé.

Les commandes restreintes nécessitent à la fois l'ACE de commande FiveM et la vérification de l'AC. Par exemple, un joueur qui a seulement tosunac.admin ne peut pas lancer tosunac_setup.

• Installation
• Config et performances
• Exports

Lancer tosunac_setup en toute sécurité#

tosunac_setup fait confiance à ce qui est installé à ce moment. Lancez-la uniquement sur un serveur que vous savez sain.

1. Démarrez le serveur avec uniquement les ressources de confiance.
2. Vérifiez que le Backdoor Guard est activé. S'il est désactivé, l'installation s'interrompt sans rien approuver.
3. Tapez tosunac_setup dans la console du serveur. Le scan de backdoors peut prendre jusqu'à 120 s.
4. Lisez le résumé. Chaque ressource ignorée est journalisée par son nom ; vérifiez-les une par une dans le panel web.
5. Lancez tosunac_doctor pour contrôler les réglages appliqués et repérer les risques de faux bans et de sécurité.

• Guide de configuration

Tester et prévisualiser#

Ces commandes vous permettent de vérifier l'AC sans sanctionner personne.

• Écran de ban : /banscreentest en jeu l'affiche sur votre propre écran ; banscreentest <id> dans la console l'affiche sur ce joueur. Les réglages de l'écran de ban viennent du panel web.
• Réglages risqués : tosunac_doctor.
• Base de données : tosunac_db_check pour la connexion SQL locale, tosunac_db_status pour le DB bridge et l'état du panel.
• Confiance des exports pour vos propres scripts : tosunac_integration.
• AC en fonctionnement : /acping (tout le monde) ou /acstats (staff). /ts status affiche aussi l'état du verrouillage.

• MySQL
• Configuration du panel

Ouvrir le menu admin#

Ouvrez le menu admin en jeu avec /ts, /ts menu, /tsmenu ou F7. La même commande ou touche le ferme. Le serveur vérifie MENU à chaque ouverture du menu.

• N'importe qui peut taper /tsmenu ; c'est le serveur qui décide. Les demandes sont limitées à une toutes les 1,5 s par joueur.
• Une demande /tsmenu ou F7 refusée est mise en cache 10 s et journalisée : une ligne de log en base, un enregistrement d'événement staff et un avertissement dans la console.
• Le joueur n'est sanctionné pour une demande refusée que si ts.NuiNeverBanUnauthorized = false (true par défaut). ts.punishType s'applique alors.
• Un /ts refusé affiche la carte d'absence de permission et n'est pas journalisé.
• Les membres du staff qui ont STAFF mais pas MENU (par exemple seulement des ACE txAdmin) peuvent appuyer sur F7, mais chaque demande est refusée et journalisée.
• Les interrupteurs ts.AdminMenu allowFreecam, allowDelete et allowEsp ne sont appliqués que par le client.

• Configuration du serveur

Outils d'administration en jeu#

La caméra libre, la suppression visée, le noclip et le mode spectateur ne fonctionnent que pour le staff. La caméra libre et le noclip nécessitent aussi une session de menu : le menu doit s'être ouvert avec succès au moins une fois depuis votre connexion.

Si votre accès au menu est retiré pendant que vous êtes en caméra libre ou en mode spectateur, la sortie de ce mode envoie un log de menu que le serveur traite comme non autorisé. Cela peut entraîner une tentative de sanction.

Raccourcis et touches par défaut#

Tosun AC enregistre une seule touche réassignable (DELETE). La touche du menu est un ID de contrôle fixe défini dans la config. Les autres touches ne fonctionnent qu'à l'intérieur d'un outil.

• F7 est vérifiée toutes les 50 ms sur un état de touche qui dure une seule frame : un appui peut donc être manqué. Appuyez de nouveau si le menu ne s'ouvre pas.
• L'ID de contrôle de F7 est lu une seule fois au démarrage du script client. Un changement depuis le panel ne prend effet qu'après la reconnexion du joueur.

ts.AdminMenu.openKeyControl = 166 -- F5

Contrôles de la caméra libre#

Tous les autres contrôles sont désactivés tant que la caméra libre est active. L'entité visée (jusqu'à 120 m) est marquée et étiquetée, et le jeu charge la zone autour de la caméra. Le texte du HUD est en turc et affiche une distance par frame, pas des m/s.

Contrôles du noclip#

Activez et désactivez le noclip dans le menu admin. Tant qu'il est actif, l'attaque, la visée, la sélection d'arme, le corps à corps et X (contrôle 73) sont désactivés. Le HUD affiche la vitesse sous la forme « N m/sx speed » à cause d'une erreur de modèle de texte.

Raccourcis clavier du menu admin#

Ces touches fonctionnent quand le menu admin est ouvert. Elles sont ignorées pendant que vous tapez dans un champ, quand la visionneuse est ouverte ou quand Ctrl, Alt ou Meta est maintenu (sauf Ctrl/Cmd+K).

Touches bloquées et commandes sur liste noire#

Deux listes de la config agissent sur les touches et les commandes client des joueurs. Le panel peut remplacer les deux listes.

Les commandes de tosun-ac, les commandes intégrées (sans ressource propriétaire) et les commandes des ressources que le Resource Guard considère comme autorisées sont ignorées. Aucune commande n'est évaluée avant que la baseline du Resource Guard soit prête. L'intitulé de ts.BlacklistKeys dans la config parle d'une combinaison de touches de menu, mais chaque contrôle listé est bloqué individuellement.

Pièges courants#

Liste courte des comportements qui surprennent le plus souvent les propriétaires de serveur.

• /ts reload casse l'AC en cours d'exécution jusqu'au redémarrage. Redémarrez plutôt tosun-ac.
• Les gels de /freeze, /acfreeze et /massfreeze durent peu pour les joueurs non admin, car la vérification anti-freeze de l'AC lui-même les dégèle en 10 s environ.
• Le verrouillage (via /ts_lockdown ou /emergency) empêche aussi le staff de se connecter et se réinitialise au redémarrage. Vérifiez une fois que les nouvelles connexions sont bien refusées sur votre serveur.
• Les mutes sont liés à l'ID serveur. Un joueur muté qui se reconnecte peut de nouveau écrire dans le chat.
• /clearinv ne vide rien sans ox_inventory.
• Les résultats de /capture ne sont pas stockés par l'AC ; consultez la cible d'envoi définie dans ts_screen_upload.
• /ts exempt raccourcit une /ts whitelist permanente à la durée de l'exemption.
• /acping est ouverte à tous les joueurs et affiche la version de l'AC.
• Les noms courts v9 (tphere, tpto, kickall, adminsync, warn) ne se comportent pas comme la forme ts_. Préférez la forme ts_.

Événements et exports internes#

Tosun AC enregistre aussi des événements réseau et des exports internes pour le menu admin, le pont avec le panel web et sa propre protection. Ce ne sont pas des commandes. Ils sont protégés par des vérifications de permission et de jeton, et les autres scripts ne doivent pas les appeler. Utilisez plutôt les exports et événements publics.

• Référence des exports
• Événements