Documentation ZeroDev Sentinel

ZeroDev Sentinel : installation et utilisation

ZeroDev Sentinel est une resource anti-cheat côté serveur pour FiveM. Elle enregistre ce que voit le serveur, le juge avec des règles qui s'expliquent elles-mêmes en phrases claires, et donne les preuves à votre staff avant que quiconque soit sanctionné. Elle démarre au niveau de protection Watch : elle journalise et ne sanctionne personne tant que vous n'en décidez pas autrement. Ce guide couvre la version 0.1.2 sur les serveurs ESX, QBCore, Qbox et standalone.

Pour ZeroDev Sentinel 0.1.223 min de lectureMis à jour le

1. Prérequis

  • OneSync activé (set onesync on dans server.cfg). La resource déclare OneSync comme dépendance, donc FXServer ne la démarre pas sans OneSync.
  • Un artifact FXServer qui exécute des scripts Node 22 (n'importe quel artifact recommandé actuel ; le manifest demande node_version '22'). Node s'occupe du hashing, de la compression, du listage des fichiers et de la route web des appels.
  • Optionnel : oxmysql. Avec lui, Sentinel conserve ses données dans votre base de données et crée ses propres tables au premier démarrage. Il n'y a aucun fichier SQL à importer. Sans lui, tout est stocké dans le key-value store propre à la resource.
  • Optionnel : pma-voice, pour écouter le chat vocal d'un joueur depuis la console ou le panneau navigateur.

Le framework ne compte que pour deux choses : la trace de l'argent et des items (argent et items qu'aucune boutique, aucun job ni aucun script n'a versés, boucles de récompenses, rollbacks) et qui fait partie de votre staff (groupes ACE, utilisés par tous les frameworks). La détection, les dossiers, les clips, la console, le panneau navigateur, Discord et le bureau du propriétaire fonctionnent de la même façon sur tous les frameworks.

2. Installation en cinq minutes

Rien ne demande de SQL, aucune modification du config n'est nécessaire pour le premier démarrage, et aucune autre resource n'est modifiée.

Étape 1 : Placez le dossier dans resources

Copiez le dossier zerodev_sentinel dans votre dossier resources. Gardez exactement ce nom de dossier : le fichier guard remonte ses informations à zerodev_sentinel, et sentinel:guard vous avertit si le dossier porte un autre nom.

Étape 2 : Ajoutez-le à server.cfg

Démarrez-la après oxmysql et votre framework, pour que le stockage et la trace de l'argent les trouvent au démarrage. L'ordre exact pour votre framework se trouve à la section 3.

Étape 3 : Démarrez le serveur

La console affiche un cadre de démarrage et un code propriétaire à usage unique. Chaque ligne du cadre est une vraie vérification ; la dernière ligne indique READY, ou NOT READY avec le nombre de problèmes (section 15).

Étape 4 : Prenez la place de propriétaire

Rejoignez le serveur et tapez /sentinel owner <code> dans le chat. Vous occupez maintenant la place de propriétaire (section 4).

Étape 5 : Ouvrez le bureau du propriétaire

Appuyez sur F7 en jeu (ou tapez sentinel:console dans F8) et ouvrez OWNER. La feuille First run indique ce qui est fait et ce qui ne l'est pas : Discord, stockage des clips, votre staff et ses permissions. Chaque ligne a un bouton. Jouez ensuite quelques jours en Watch, lisez ce que Sentinel a trouvé sur la feuille Right now, puis passez le niveau de protection à Recommended sur le même bureau (section 6).

3. Votre framework

Sentinel détecte seul le framework et l'inventaire au démarrage. Il n'y a rien à régler. sentinel:trail dans la console du serveur indique l'adapter choisi.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Argent et items : lus depuis les server events propres à ESX (argent de compte ajouté, retiré ou défini ; items d'inventaire ajoutés ou retirés ; items donnés de joueur à joueur, avec les deux côtés liés). Le rollback utilise les méthodes joueur propres à ESX et relit le résultat.
  • ESX avec ox_inventory : l'argent est suivi de la même façon. Dans ce mode, les méthodes d'items d'ESX ne renvoient aucun résultat, donc Sentinel décide uniquement à partir de la relecture.
  • Staff : donnez à vos admins la permission ACE (section 5). Le group.admin propre à ESX fonctionne comme groupe ACE dès que vous ajoutez la ligne correspondante.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Argent : lu depuis l'event de changement d'argent de QBCore (ajout, retrait et définition, avec la raison). Une perte et un gain égal au même moment sont liés comme un transfert, car QBCore n'a pas d'event de transfert à lui.
  • Items : avec ox_inventory, les items sont suivis via ses hooks. Avec qb-inventory, les changements d'items ne sont pas suivis (le payload de son listener n'est pas documenté), mais un rollback peut quand même déplacer des items avec les exports documentés de qb-inventory.
  • Staff : les groupes de permissions de QBCore sont des groupes ACE (group.admin, group.god). Ajoutez les lignes ACE de la section 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Argent : lu depuis l'event de changement d'argent de Qbox ; les soldes sont relus avec les exports propres à qbx_core. L'argent modifié pour un personnage hors ligne (par citizen id) ne déclenche aucun event, il n'apparaît donc pas dans la trace.
  • Items : Qbox utilise ox_inventory, et Sentinel suit ses items via les hooks d'ox_inventory. Les items qui représentent de l'argent du framework sont laissés à la partie framework.
  • Staff : groupes ACE, comme sur QBCore.

Standalone (sans framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Tout fonctionne sauf la trace de l'argent et des items : déplacement, monde, events, events appâts, godmode, state bags, armes, dossiers, clips, replay, console, panneau, Discord, rôles et bans.
  • Avec ox_inventory et sans framework, les items sont suivis via ox_inventory.
  • Stockage : le key-value store, ou oxmysql si vous le démarrez avant.

Vérifier que ça marche

  • sentinel:health : à nouveau le cadre de démarrage. Chaque ligne est une vraie vérification ; READY signifie que rien ne manque.
  • sentinel:diag : pourquoi le stockage, les adapters et le niveau ont été choisis, chaque règle avec ses compteurs, et les dernières décisions.
  • sentinel:trail : l'adapter d'argent et d'items utilisé, et les derniers changements d'un joueur.

En mode de stockage automatique, Sentinel utilise oxmysql seulement si oxmysql est déjà démarré (il attend jusqu'à 15 secondes pendant le démarrage d'oxmysql) ; si oxmysql démarre plus tard, il utilise le key-value store.

4. Premier lancement : la place de propriétaire

Le premier démarrage affiche dans la console du serveur un code à usage unique, valable 30 minutes (sentinel:owner code en affiche un nouveau). Rejoignez le serveur et tapez /sentinel owner <code> : la place est liée à votre compte et le code n'est plus valable.

Seule la place de propriétaire peut modifier les clés, le niveau de protection, les rôles et les permissions. sentinel:owner reset dans la console du serveur libère la place si vous devez la transférer à un autre compte.

5. Staff et permissions

Sur le bureau du propriétaire, STAFF : choisissez un joueur en ligne, choisissez un rôle, appuyez sur GRANT. Quatre rôles sont fournis :

Rôle Peut, par défaut
Support voir les dossiers, traiter les signalements, la carte de service
Moderator comme Support, plus les replays, le kick et la quarantaine
Admin comme Moderator, plus révéler, blanchir, vue en direct, demandes de ban, appels
Senior admin comme Admin, plus un ban qui s'applique immédiatement

C'est vous qui choisissez les permissions. Chaque rôle est une liste d'interrupteurs que vous pouvez modifier. Créez vos propres rôles à partir d'une copie (par exemple "Trial mod"), renommez n'importe quel rôle, et donnez à une personne un interrupteur en plus ou retirez-lui-en un sans changer son rôle. Les interrupteurs marqués dangereux (ban immédiat, écoute du chat vocal, paramètres, gestion du staff) demandent un second appui. Chaque modification est écrite dans le journal du staff, vous pouvez donc toujours voir qui a changé quoi.

ACE fonctionne toujours pour les serveurs qui l'utilisent déjà, et il est lu à chaque vérification :

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Permission Rôle donné
sentinel.admin Admin (Senior admin tant que la place de propriétaire n'est pas prise) et toutes les commandes sentinel:* en jeu
sentinel.staff Moderator ; les règles de déplacement considèrent les propres déplacements d'un membre du staff comme expliqués

Quelques commandes (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) sont enregistrées comme restreintes : en jeu, elles demandent aussi command.<name>. La ligne habituelle add_ace group.admin command allow couvre cela. La console du serveur peut lancer toutes les commandes.

6. Le niveau de protection

Un seul interrupteur sur le bureau du propriétaire (OWNER, PROTECTION), ainsi que sentinel:level dans la console du serveur et Config.Protection dans config/config.lua. Ce que vous réglez sur le bureau est enregistré et l'emporte sur la ligne du config après un redémarrage.

  • Watch : chaque règle observe et note ce qu'elle aurait fait ; personne n'est alerté et il n'arrive rien à personne. Pendant ce temps, Sentinel apprend ce qui est normal sur votre serveur : l'observateur d'events (fréquence et forme de chaque event) et la vérification à la connexion n'apprennent qu'en Watch ; les limites d'entités, de combat et d'argent continuent d'apprendre du jeu propre.
  • Recommended : toutes les règles sont actives. Le staff reçoit des alertes avec les preuves, et un dossier s'ouvre. Sentinel ne sanctionne jamais de lui-même ; c'est votre staff qui décide.
  • Strict : comme Recommended, et un score élevé met le joueur en quarantaine jusqu'à ce que le staff regarde ; un constat de niveau preuve (Tier A : un event appât déclenché, une requête falsifiée) met en plus un ban en file d'attente pour la ban wave.

Sous l'interrupteur, le bureau liste chaque règle avec son état et l'origine de cet état. Vous pouvez y épingler une règle sur Live ou Shadow si votre serveur en a besoin (une règle qui signale sans cesse un de vos propres scripts, par exemple) ; une ligne state dans Config.Rules l'épingle dans le fichier de config et l'emporte sur le bureau.

Un ordre raisonnable :

  1. Watch pendant quelques jours de jeu normal.
  2. Lisez ce que les règles auraient fait : la feuille Right now, sentinel:diag rules (la colonne shadow compte les fois où une règle aurait marqué des points) et sentinel:diag decisions 100.
  3. Épinglez sur Shadow toute règle qui a signalé quelqu'un en qui vous avez confiance, et dites-le-nous.
  4. Passez en Recommended. Le staff voit maintenant les dossiers et les preuves ; personne n'est sanctionné automatiquement.
  5. Strict quand vous faites confiance à ce que Recommended vous montre.

Pour revenir en arrière à tout moment : Watch sur le bureau, ou sentinel:level watch.

7. La console staff (F7)

Appuyez sur F7 en jeu (ou tapez sentinel:console dans F8). Chaque joueur peut changer la touche dans les paramètres du jeu (Key Bindings, FiveM). Échap la ferme.

  • Right now dit en termes simples ce qui se passe sur votre serveur : qui ressemble à une menace et pourquoi, ce qui a été prouvé, ce qui a été expliqué (un revive, un téléport d'un de vos scripts) et ce qui a besoin de vous. Chaque joueur qui compte a une ligne : ce qu'il a fait, ce que c'est probablement, à quel point Sentinel est sûr (Unusual, Suspicious, Very likely, Proven), ce que Sentinel a déjà fait, et une prochaine étape.
  • Dossiers : les dossiers ouverts d'abord, chacun avec son constat, les preuves, les clips d'écran, le sceau (si la chaîne de hash du dossier se vérifie toujours) et les touches REVEAL, QUARANTINE, CLEAR et BAN (CLEAR et BAN demandent une deuxième pression).
  • Carte de service : les joueurs en ligne sur un modèle 3D de l'île. Le terrain est mesuré par le jeu du premier membre du staff et conservé dans data/map/.
  • Play replay ferme la console et rejoue l'incident dans un monde privé ; appuyez sur Backspace pour revenir.
  • Propriétaire (place de propriétaire uniquement) : First run, Protection, Keys, Staff, Internal affairs et Server check.

Les commandes en jeu se tapent dans F8 sans slash, ou dans le chat avec un slash (/sentinel:diag).

8. Le panneau navigateur

Le même bureau dans un navigateur web, pour quand vous n'êtes pas en jeu :

  • sur le PC du serveur : http://127.0.0.1:<port>/zerodev_sentinel/panel/ (le port est celui de votre serveur, 30120 par défaut)
  • depuis ailleurs : http://<server address>:<port>/zerodev_sentinel/panel/, ou votre propre adresse HTTPS placée devant

Connexion. Utilisez un code à usage unique : tapez /sentinel panel en jeu (le code n'est affiché qu'à vous, fonctionne une fois, pendant 5 minutes), ou lancez sentinel:panel <id or account> dans la console du serveur. Une session dure 8 heures ; SIGN OUT et END ALL MY SESSIONS y mettent fin. Votre rôle et vos interrupteurs s'appliquent dans le navigateur exactement comme en jeu.

Vue en direct. Le staff qui a l'interrupteur de vue en direct peut regarder l'écran de n'importe quel joueur en ligne depuis le panneau ou la console. Rien n'est conservé sur le disque, sauf si vous appuyez sur Save to case.

Écoute. Écouter le chat vocal de ce joueur nécessite l'interrupteur d'écoute (propriétaire uniquement par défaut) et pma-voice. Le son passe par votre propre jeu, donc soyez en jeu sur le même serveur.

Chaque vue en direct et chaque écoute est inscrite dans le registre du staff et dans le dossier du joueur, et les joueurs sont prévenus à leur première connexion que le staff peut regarder et écouter (l'avis d'enregistrement, Config.Notice).

9. Dossiers, quarantaine, kick, ban et appels

Quand quelque chose est détecté, Right now nomme le joueur en clair : ce qu'il a fait, à quel point Sentinel est sûr, et ce qu'il a fait en réponse. Ouvrez le dossier pour voir les preuves (positions, clips d'écran scellés avec SHA-256, un replay 3D) et utilisez les touches :

  • REVEAL : affiche les identifiants du joueur.
  • QUARANTINE : sort le joueur du monde réel et le place dans un routing bucket privé jusqu'à ce que le staff regarde. sentinel:release <server id> le fait revenir.
  • CLEAR : pas de triche ; ferme le dossier et arrête son ban en attente.
  • KICK : hors du serveur, avec une raison que le joueur lit.
  • BAN : via la ban wave, avec un code d'appel.

La ban wave. Les bans, y compris un BAN appuyé dans la console, sont mis en attente pour la ban wave et appliqués uniquement sur Strict, par défaut à un moment aléatoire 2 à 24 heures plus tard (Config.Actions). sentinel:wave les liste, sentinel:wave now <account> en applique un tout de suite, sentinel:wave cancel <account> l'annule.

Appels. Un joueur banni voit un code d'appel dans le message de refus (8 lettres et chiffres). Il ne peut pas se connecter pour faire appel, donc l'appel vous arrive depuis l'extérieur du jeu :

  1. Par votre staff. Le joueur envoie le code à votre staff (un ticket Discord, un mail). Un membre du staff l'enregistre avec sentinel:appeal <code> <text>.
  2. Par la route web. Sentinel répond sur l'adresse même de votre serveur : http://<server address>:<port>/zerodev_sentinel/appeal. Elle n'accepte qu'un POST avec du JSON { "code": "...", "text": "...", "contact": "optional" } (texte de 10 à 2000 caractères), elle est donc prévue pour un formulaire sur votre site, pas comme une page vers laquelle envoyer les joueurs. Chaque requête acceptée reçoit la même réponse, 202 "received", que le code corresponde à un ban ou non. Trop de requêtes depuis une adresse (5 en 10 minutes) ou au total (30 par minute) reçoivent 429. Derrière votre propre reverse proxy HTTPS, mettez set sentinel_http_proxy true pour que les limites comptent l'adresse du visiteur.

Le texte de refus ne dit pas où faire appel. Indiquez-le aux joueurs dans votre règlement, ou écrivez votre propre texte avec votre lien dans Config.Bans.message (gardez le %s, il devient le code), par exemple 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Le staff décide dans la console ou avec sentinel:decide <case or code> accept|reject [note]. Accept lève tous les bans actifs de ce compte ou de ce dossier et annule un ban de wave en attente ; reject maintient le ban. Une décision est définitive et inscrite dans le journal du dossier. sentinel:appeals liste les appels ouverts.

10. Signalements et affaires internes

Signalements des joueurs. N'importe quel joueur tape /report <server id> <what happened> pour signaler un joueur ou un membre du staff. Les deux dernières minutes autour des deux joueurs sont enregistrées dans un dossier. Le staff clôt un signalement comme traité, pas d'infraction, pas de preuve ou doublon. Les signalements visant le staff vont uniquement au propriétaire.

Affaires internes (propriétaire uniquement, sur le bureau du propriétaire) : ce que chaque membre du staff a fait, et ce qui mérite un coup d'œil (attributions à soi-même, se cacher en combat, bans sans dossier, téléports vers des joueurs). Un rapport d'équité hebdomadaire est écrit dans data/reports/ ; sentinel:staff report l'écrit tout de suite. Rien dans le registre du staff ne sanctionne le staff.

11. Protéger une resource

Sans aucune configuration, Sentinel observe chaque event que les joueurs peuvent envoyer à vos scripts et juge le joueur. Il ne peut pas empêcher le handler d'une autre resource de s'exécuter. Pour bloquer un mauvais appel avant qu'un script ne s'exécute, ajoutez le guard à ce script.

  1. sentinel:audit liste les events de chaque resource démarrée que les clients peuvent déclencher, classés selon ce que font leurs handlers (par exemple un handler qui donne de l'argent avec un montant choisi par le client). Servez-vous-en pour décider quelles resources protéger en premier.
  2. sentinel:guard <resource> affiche la ligne à ajouter et les server_scripts de la resource tels qu'ils seraient alors. La ligne du guard doit être le premier server script. La commande ne fait qu'afficher ; elle ne modifie aucun fichier.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. Redémarrez cette resource. sentinel:guard <resource> indique maintenant "guarded since ...". sentinel:guard seul liste toutes les resources protégées.
  2. Ajoutez des règles avec sentinel:patch. Tant qu'une resource n'a pas de règles, son guard laisse passer tous les appels, sauf ceux des joueurs en quarantaine, que chaque guard rejette. Exemple : au maximum 3 achats en 10 secondes, un nom d'item de 32 caractères au plus et une quantité de 1 à 10 ; un appel refusé compte comme preuve ("hard": true) :

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Pour un callback de framework, écrivez callback:<name> comme event : sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> liste les règles d'une resource ; sentinel:patch <resource> <event> off en supprime une.

Le guard ne modifie jamais de fichiers et ne change jamais ce que reçoit un handler. C'est du Lua simple et lisible dans guard/guard.lua.

12. Clés Discord et de stockage des clips

Le plus simple est le bureau du propriétaire, KEYS : collez chaque valeur et appuyez sur SAVE. Les clés sont conservées uniquement sur le serveur ; le bureau et chaque réponse disent seulement "set" et n'affichent plus jamais une clé.

Ligne sur le bureau Ce que c'est Ou dans server.cfg (utilisez set, jamais setr)
Token du bot Discord un bot que vous avez créé sur discord.com/developers et invité sur votre serveur set sentinel_discord_token "..."
Id du serveur Discord clic droit sur votre serveur, Copy Server ID (mode développeur activé) set sentinel_discord_guild "..."
Id du salon d'alertes où les dossiers sont publiés, avec des boutons pour votre staff set sentinel_discord_channel "..."
Id du salon d'appels où les appels sont publiés set sentinel_discord_appeals "..."
Clé FiveManage une clé média de fivemanage.com ; les clips y sont envoyés set sentinel_fivemanage_key "..."
Webhook des clips à la place de FiveManage : un webhook Discord qui reçoit les clips set sentinel_clip_webhook "..."
Stockage des clips fivemanage, discord, off ou automatic (le premier qui est défini) set sentinel_clip_storage "..."

Une clé dans server.cfg l'emporte sur le bureau, et le bureau l'indique. Les boutons Discord suivent les mêmes rôles et interrupteurs que la console. Sans aucun de ces éléments, les dossiers et les clips restent sur votre serveur (data/) et la console et le panneau les affichent.

Les alertes webhook plus simples fonctionnent toujours : set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" ou sentinel:webhook set <url> dans la console du serveur. sentinel:webhook test envoie un message de test ; sentinel:webhook affiche l'état sans jamais afficher l'URL ; sentinel:webhook clear supprime celle qui est enregistrée.

13. Ce que détecte chaque règle

Chaque règle écrit une phrase claire quand elle se déclenche, qui dit ce qu'elle a vu et ce qu'elle a écarté. Avant qu'une règle ne compte contre quelqu'un, Sentinel vérifie les raisons qui l'expliqueraient (un respawn, un revive, une action du staff, un de vos propres scripts qui déplace ou paie des joueurs). Un constat expliqué est journalisé et ne compte jamais dans le score.

  • Niveau A est une preuve : quelque chose que seule une triche fait (un event appât qu'aucun vrai script n'appelle, une requête falsifiée).
  • Niveau B est fort : un membre du staff devrait regarder. Seul, il n'ouvre un dossier que si deux familles différentes concordent, ou si la même se répète.
  • Niveau C est faible : il s'ajoute au score et n'agit jamais seul.

Mouvement

Règle Détecte Expliqué par Niveau
teleport Un saut de plus de 150 m (ou 3x le possible) entre deux mesures spawn, respawn ou revive, changement de routing bucket, staff, l'event de téléport de votre script B
foot_speed Courir à plus de 12 m/s pendant 1.5 s à pied, sans tomber, sans ragdoll spawn, respawn, staff, votre script B
air_float Se déplacer en étant figé (noclip) ; « tomber » sans redescendre (fly) ; se déplacer vite selon les coordonnées alors que le jeu dit que le joueur est immobile (menus de vitesse) spawn, respawn, staff, votre script B
foot_rise Monter tout droit à plus de 4 m/s à pied pendant 3 s spawn, respawn, staff, votre script B
vehicle_speed Un véhicule au-delà de 1.3x la vitesse maximale que sa classe atteint sur votre serveur staff, votre script B

Monde

Règle Détecte Expliqué par Niveau
entity_blocked Faire apparaître un modèle que vous avez bloqué vos scripts qui le font apparaître B
entity_rate / entity_model_rate Faire apparaître beaucoup plus d'entités (ou d'un même modèle) par minute que ne le font les joueurs et les scripts vos scripts de spawn B
entity_untrusted Des entités créées par un client sans qu'aucun script ne les fasse apparaître vos scripts de spawn B
entity_disguised Une rafale du même modèle de ped ambiant autour d'un joueur (un menu qui déguise ses spawns en trafic) spawn, respawn, changement de bucket B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Des explosions que l'arme tenue ne peut pas produire, trop nombreuses, invisibles ou loin du joueur les explosions de vos scripts B
projectile_weapon / projectile_rate Des projectiles que l'arme ne peut pas tirer, ou trop nombreux B
ptfx_rate Des floods d'effets de particules (une attaque courante pour crash et lag) B
fire_rate Des incendies allumés plus vite qu'aucune arme ne le permet B

Combat

Règle Détecte Niveau
damage_plausibility Des dégâts au-dessus de la valeur possible de l'arme B
hit_range Des touches au-delà de la portée de l'arme B
shot_rate / kill_rate Tirer plus vite que l'arme ; des kills par minute bien au-dessus de la normale de votre serveur B
silent_aim Des touches là où le joueur ne visait pas, répétées B
aim_stats / aim_stats_backed Part de headshots et angles de snap très en dehors des joueurs de votre serveur sur 30+ combats C (B avec une autre famille)
esp_los_backed Viser à répétition des joueurs que les témoins signalent cachés derrière des murs C à B

Events et requêtes

Règle Détecte Niveau
bait_event Appeler un event piégé qu'aucun vrai script n'utilise (les menus de triche les cherchent et les déclenchent) A
bait_statebag / statebag_write Écrire des state bags que seul le serveur devrait écrire (se mettre admin, flags de godmode), ou des state bags trop volumineux A / B
events_before_ready / _trap Des events envoyés avant même que le joueur soit apparu (injectés avant la connexion) B / A
event_rate / event_shape Un event appelé bien plus vite que la normale, ou avec des arguments d'une forme différente des appels habituels de votre serveur B
event_flood 500+ appels en 10 s ; lors du kick pour overflow de FiveM lui-même, les events les plus appelés sont listés B
guard_rule / guard_hard Enfreindre une règle que vous avez posée sur un event protégé (montant, fréquence, distance) B / A

Économie

Règle Détecte Niveau
money_nowhere / item_nowhere De l'argent ou des items qu'aucune boutique, aucun job ni aucun script n'a donnés (events de dev, ventes de boutique leakées) B
economy_repeat Un event de récompense ou de job payé 10 fois en 30 s (farm en l'appelant en boucle) B
money_jump / money_rate Un bond soudain du solde ou un rythme de gains bien au-dessus de la normale de votre serveur B
economy_trap Réclamer une récompense piégée qu'aucun vrai job ne paie A
weapon_not_owned Tenir une arme que l'inventaire n'a jamais donnée B

Le jeu du joueur (témoin)

Règle Détecte Niveau
godmode Le serveur voit le joueur invincible pendant 30 s (hors safe zone partagée) B
witness_backed Des signes venant du jeu confirmés par ce que voit le serveur lui-même (godmode, invisibilité, pas de collision) B
witness_bait Le jeu répond à une vérification dont il ne devrait pas connaître l'existence A
witness_tamper Les propres vérifications de Sentinel dans le jeu ont été hookées ou modifiées B

Identité et fichiers

Règle Détecte Niveau
ban_fingerprint Un joueur banni revenu sur un nouveau compte (hardware tokens, identifiants, empreinte du navigateur) A / flag
young_account Un compte tout neuf (ajoute seulement du poids) C
scanner_error / too_large Des resources que le scanner de scripts n'a pas pu lire, ou des fichiers trop volumineux qui méritent un coup d'œil info

Ce qu'aucune règle ne promet

Sentinel juge ce que le serveur peut voir et ce que le jeu d'un joueur signale. Il ne lit pas les autres programmes sur le PC d'un joueur, et aucun anti-cheat ne peut promettre que chaque triche sera détectée. Chaque constat est accompagné de ses preuves, pour que votre staff décide sur des faits.

14. Commandes et configuration

Toutes les commandes sont sur la page des commandes et toutes les clés de config sur la page de configuration, toutes deux générées à partir de la resource elle-même. Celles que vous utiliserez le plus :

Commande Ce qu'il fait
/sentinel owner <code> prendre la place de propriétaire en jeu avec le code de la console
/sentinel panel un code de connexion à usage unique pour le panneau navigateur (staff uniquement)
/report <server id> <what happened> n'importe quel joueur signale un joueur ou un membre du staff
sentinel:health à nouveau le cadre de démarrage
sentinel:diag ce que Sentinel a décidé et pourquoi
sentinel:level watch\|recommended\|strict changer le niveau de protection et l'enregistrer
sentinel:wave les bans en attente pour la ban wave
sentinel:appeals les appels ouverts
sentinel:audit les events à risque de chaque resource démarrée
sentinel:guard <resource> la ligne qui protège une resource
sentinel:advisor les paramètres FiveM qui valent la peine d'être changés sur votre serveur

Les fichiers de config dans config/ (config.lua, protection.lua, watch.lua) et les traductions dans config/locales/ vous sont ouverts, tout comme les adaptateurs de framework dans bridge/ et le fichier du guard dans guard/. Gardez-les en Lua valide et redémarrez zerodev_sentinel après une modification. Aucune modification de la config n'est nécessaire pour le premier démarrage.

15. Le cadre de démarrage et le conseiller de durcissement

Un instant après que le stockage est prêt, Sentinel affiche un cadre dans la console du serveur. Une ligne FAIL signifie que Sentinel ne peut pas fonctionner correctement ; une ligne WARN signifie qu'il fonctionne avec moins (par exemple des preuves sans empreintes digest). Affichez-le à nouveau à tout moment avec sentinel:health.

Ligne Ce qu'elle vérifie Quand elle n'est pas OK
Build La version et le libellé de build issus de fxmanifest.lua. -
OneSync La convar onesync. Sentinel lit les positions, les entités et les événements du jeu via OneSync. mettez onesync sur on dans server.cfg
Copies lancées Combien de copies de la resource sont démarrées, quel que soit le nom de leur dossier. Doit être 1. gardez une seule copie de Sentinel ; arrêtez l'autre dossier
Stockage Quel stockage a été choisi (mysql ou kvp) et s'il est prêt. voir sentinel:diag storage
Dossier des preuves Une écriture et une lecture de test dans data/archive à l'intérieur de la resource. créez le dossier data/archive dans la resource Sentinel et vérifiez que le serveur peut y écrire
SHA-256 Si node/util.js répond ; il calcule l'empreinte de chaque preuve. les preuves sont enregistrées sans empreintes digest ; cherchez une erreur Node dans la console
Protection Le niveau de protection, son mode et sa provenance. -
Règles Combien de règles sont en Live et combien en Shadow. -

Après le cadre de démarrage, le conseiller affiche les paramètres FiveM qui valent la peine d'être changés sur votre serveur (avec Config.Advisor.atStartup = false, il ne les affiche qu'avec sentinel:advisor). Pour chaque paramètre, il montre la valeur actuelle, la valeur recommandée, ce qu'elle bloque, ce qu'elle pourrait casser et la ligne à copier. Il ne fait que lire les valeurs ; il ne modifie jamais server.cfg. Testez une ligne sur votre serveur avant de la garder.

16. Langues, et ce qui est enregistré

Les textes pour les joueurs et le staff viennent de config/locales/<code>.lua, 25 langues dans ce build. Config.Locale choisit la langue ; avec Config.GameLanguage = true, un joueur dont le jeu tourne dans une langue proposée par GTA lit Sentinel dans cette langue une fois en jeu.

Sentinel garde en mémoire, pour chaque joueur, environ les deux dernières minutes de positions et d'events (Config.Recorder), et les écrit dans une archive dans data/archive/ quand un dossier s'ouvre ou que le staff utilise sentinel:save. Pendant un examen, il demande au jeu du suspect des clips d'écran (segments de 20 secondes) et les stocke dans data/clips/. Il stocke les identifiants que FiveM donne au serveur (une adresse IP est enregistrée mais n'est jamais utilisée par défaut pour refuser une connexion) et, quand Discord tourne, l'id Discord. À leur première connexion, tous les joueurs reçoivent un court avis dans leur langue indiquant que le serveur enregistre la partie et que le staff peut regarder et écouter (Config.Notice = false le désactive ; prévenez-les alors dans votre règlement). Mentionnez-le aussi dans votre politique de confidentialité.

Les anciennes archives et les anciens clips ne sont pas supprimés automatiquement dans ce build : videz vous-même data/archive/ et data/clips/ quand vous n'en avez plus besoin.

Avec oxmysql, les données de Sentinel sont dans les tables zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report et zds_trail. Sans oxmysql, les mêmes données sont dans le stockage clé-valeur de la resource (clés commençant par zds:). Les bans sont toujours copiés aussi dans le stockage clé-valeur, ils restent donc appliqués pendant que la base de données est hors service.

17. Mise à jour

Les nouvelles versions sont publiées sur le même asset Keymaster. Sentinel garde ses preuves dans son propre dossier, donc avant de le remplacer :

  1. Sauvegardez, dans le dossier zerodev_sentinel, les dossiers config/ et data/ (archives, clips, signalements, baselines apprises) et, avec oxmysql, les tables zds_.
  2. Arrêtez le serveur, remplacez le dossier zerodev_sentinel par le nouveau (gardez le nom du dossier) et remettez votre dossier data/. Reportez les réglages que vous avez modifiés dans les nouveaux fichiers de config plutôt que de copier les anciens fichiers par-dessus.
  3. Démarrez le serveur et lisez le cadre de démarrage (sentinel:health).

Lisez les notes de version de la nouvelle version dans le changelog avant de mettre à jour.

18. Désinstallation

  1. Retirez la ligne du guard de chaque resource que vous avez protégée (sentinel:guard les liste) et redémarrez ces resources. Faites-le en premier : le fichier du guard disparaît en même temps que le dossier.
  2. Retirez ensure zerodev_sentinel et les lignes sentinel.admin / sentinel.staff de server.cfg, puis arrêtez la resource. Si sentinel:lockdown a modifié l'entity lockdown, l'arrêt de Sentinel remet le mode d'origine.
  3. Supprimez le dossier zerodev_sentinel. Cela supprime data/ avec toutes les archives, tous les clips et tous les signalements, alors copiez d'abord ce que vous voulez garder.
  4. Avec oxmysql, supprimez les tables zds_ listées à la section 16 si vous ne voulez plus les bans et les dossiers. Les entrées clé-valeur restent dans le stockage du serveur sous le nom de la resource et ne font rien sans elle.

Sentinel n'écrit que dans son propre dossier, ses tables de base de données et son stockage clé-valeur. Il ne modifie ni les autres resources ni server.cfg.

Questions fréquentes

Sentinel bannit-il ou kicke-t-il quelqu'un de lui-même ?

Pas sur Watch ni sur Recommended. Il démarre sur Watch, où il ne fait qu'enregistrer ce qu'il aurait fait. Sur Recommended, le staff reçoit les preuves et décide. Ce n'est que sur Strict qu'un score élevé met un joueur en quarantaine jusqu'à ce que le staff regarde, et qu'une détection au niveau preuve met un ban en attente pour la ban wave.

Ai-je besoin d'une base de données ?

Non. Avec oxmysql, Sentinel garde ses données dans votre base et crée ses propres tables au premier démarrage ; il n'y a aucun fichier SQL à importer. Sans lui, tout est stocké dans le stockage clé-valeur propre de la resource.

Fonctionne-t-il sur QBCore et Qbox ?

Oui. La détection, les dossiers, les clips, la console, le panneau navigateur, Discord et le bureau du propriétaire sont identiques sur chaque framework. La trace de l'argent et des items a son propre adaptateur pour ESX, QBCore, Qbox et ox_inventory.

Comment donner l'accès à mes admins ?

Sur le bureau du propriétaire, STAFF : choisissez un joueur en ligne, choisissez un rôle, appuyez sur GRANT. Ou continuez avec ACE : sentinel.admin donne Admin et sentinel.staff donne Moderator.

Un joueur banni peut-il faire appel ?

Oui. Le message de refus affiche un code d'appel. Le joueur l'envoie à votre staff, qui l'enregistre avec sentinel:appeal, ou votre site l'envoie à la route d'appel de Sentinel. Le staff l'accepte ou le rejette dans la console ou avec sentinel:decide.

Peut-il voir des logiciels de triche sur le PC d'un joueur ?

Non. Sentinel juge ce que le serveur peut voir et ce que le jeu d'un joueur rapporte. Il ne lit pas les autres programmes sur le PC d'un joueur.

L'écoute du chat vocal est-elle prête ?

Elle nécessite pma-voice et l'interrupteur d'écoute (réservé au propriétaire par défaut), et le son passe par votre propre jeu.

Que voient les joueurs ?

À leur première connexion, un court avis dans leur langue indiquant que le serveur enregistre la partie et que le staff peut regarder et écouter (Config.Notice). Rien d'autre ne change pour un joueur clean.

Traduit de l'anglais. En cas de désaccord entre cette page et la page en anglais, c'est la page en anglais qui fait foi. English