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.
1. Prérequis
- OneSync activé (
set onesync ondans 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 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
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.adminpropre à ESX fonctionne comme groupe ACE dès que vous ajoutez la ligne correspondante.
QBCore
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
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)
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 :
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 :
- Watch pendant quelques jours de jeu normal.
- 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) etsentinel:diag decisions 100. - Épinglez sur Shadow toute règle qui a signalé quelqu'un en qui vous avez confiance, et dites-le-nous.
- Passez en Recommended. Le staff voit maintenant les dossiers et les preuves ; personne n'est sanctionné automatiquement.
- 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 :
- 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>. - 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, mettezset sentinel_http_proxy truepour 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.
sentinel:auditliste 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.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' }
- Redémarrez cette resource.
sentinel:guard <resource>indique maintenant "guarded since ...".sentinel:guardseul liste toutes les resources protégées. - 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 :
- Sauvegardez, dans le dossier
zerodev_sentinel, les dossiersconfig/etdata/(archives, clips, signalements, baselines apprises) et, avec oxmysql, les tableszds_. - Arrêtez le serveur, remplacez le dossier
zerodev_sentinelpar le nouveau (gardez le nom du dossier) et remettez votre dossierdata/. 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. - 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
- Retirez la ligne du guard de chaque resource que vous avez protégée (
sentinel:guardles liste) et redémarrez ces resources. Faites-le en premier : le fichier du guard disparaît en même temps que le dossier. - Retirez
ensure zerodev_sentinelet les lignessentinel.admin/sentinel.staffde server.cfg, puis arrêtez la resource. Sisentinel:lockdowna modifié l'entity lockdown, l'arrêt de Sentinel remet le mode d'origine. - Supprimez le dossier
zerodev_sentinel. Cela supprimedata/avec toutes les archives, tous les clips et tous les signalements, alors copiez d'abord ce que vous voulez garder. - 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.