Fichiers
gastinel-garde/audit/00-SYNTHESE.md
T

Brut Annotations Historique

Synthèse de l'audit GastinelGarde 0.2.0 (2026-10-14)

Détails : 01-inventaire-triches.md, 02-failles-detection.md, preuves : tests-proposes/AuditFaillesTest.java (17 tests verts dans une copie jetable). Rien n'a été modifié dans src/, rien n'est déployé.

Verdict

Le cœur (VL, paliers, exemptions, OBSERVE par défaut) est sain et testé. Mais le mod ne doit pas passer en ENFORCE en l'état : un bug de thread (F01) fait lever le timer sur tous les joueurs honnêtes, et plusieurs exemptions sont déclenchables par le client lui-même (riptide tenu, téléportation, dégâts, ping). Les contrôles actuels attrapent les triches grossières, pas un client réglé.

Les 5 failles à corriger en premier

# Faille Pourquoi d'abord Effort
1 F01 : le HEAD du mixin s'exécute aussi sur le thread réseau (paquets comptés ×2) Faux positif chez tous les joueurs ; état non thread-safe corrompu ; expulsion immédiate en ENFORCE 0,5 h (garde isSameThread)
2 F04 : trident Impulsion en main = seuil vanilla de 100 blocs/paquet et exemption totale du mouvement Désactive la protection vanilla ET le mod avec un objet courant 2-3 h (suivre l'utilisation réelle du trident, plafond physique)
3 F05 : toute téléportation vanilla (dont « moved too quickly » provoqué) ouvre 2 s d'exemption Un client peut s'exempter en continu 2 h
4 F07 : ping falsifiable = tous les seuils ×1,5 Un module courant (PingSpoof) affaiblit tout 1 h
5 F14 + F19 : faux positifs d'atterrissage (élytres) et de grandes contraptions Sans ça, la fiabilité sur ce serveur (Create, élytres, riptide) est nulle ; il faut avoir zéro fausse alerte avant ENFORCE 3-4 h + essais

À suivre ensuite : F08 (vol aveugle), F02/F03 (timer), F11 (rotation silencieuse), F20 (véhicules).

Les 5 triches à ajouter en premier (phase 3 et suivantes)

# Contrôle Idée Estimation
1 Balance de timer (remplace timer) Solde +50 ms − delta réel par paquet ; couvre 1,05x, blink, lag switch ; remise à zéro sur gel/téléportation 1 soirée + rejeu
2 Anti-knockback (velocity) Comparer le déplacement après chaque vélocité envoyée (dégâts, explosion, Wind Charge) à celle attendue ; sert aussi à corriger F06 et F14 1-2 soirées
3 Reach et rotation Distance œil-boîte à chaque coup (vanilla tolère 4 blocs) ; snap de rotation avant coup contre la rotation silencieuse (F11) 1 soirée
4 Élytres (déjà phase 3) Modèle de plané : gain d'altitude ou de vitesse sans fusée ni riptide ; remplace l'exemption totale 2-3 soirées
5 Véhicules + marche sur l'eau Accrocher handleMoveVehicle ; plafond par milieu (Jesus, boat fly, NoSlow) 2 soirées

Hors liste mais utile et peu coûteux : événements de blocs (nuker, fastbreak, scaffold : BlockEvent.BreakEvent, PlayerInteractEvent) : 2 soirées, valeur moyenne sur un serveur d'amis.

Ce qui ne pourra jamais être détecté côté serveur

Dit clairement :

  • X-ray, ESP, fullbright, freecam, zoom, minimap : aucun paquet ne change. Seule une défense par masquage du contenu (AntiXray) agit, jamais par détection. Une heuristique de minage donne un soupçon statistique, pas une preuve.
  • Aimbot / triggerbot / autoclicker bien réglés : indiscernables d'un joueur humain très bon, hors statistiques sur de longues sessions.
  • Safewalk, AutoTool, AutoSprint, AutoEat, étiquettes d'objets : comportement identique à une action légitime.
  • Cartes et automatisation (Baritone bien réglé) : trajectoire plausible.
  • Identité : en online-mode=false, rien dans le comportement n'établit qui est derrière un pseudo. L'usurpation et le retour sous un autre pseudo ne se corrigent que par une authentification (online-mode, ou un second facteur de type mot de passe de session).
  • Un client sous le seuil : tout seuil fixe se contourne par un client patient ; l'objectif réaliste (plan, section 5) est de bloquer les triches visibles, pas de rivaliser avec Grim.

Essais en jeu à faire par Théo (points [À VÉRIFIER])

Client honnête = client vanilla/Fabric sans triche. Client de triche = celui de Théo. Garder tous les contrôles en OBSERVE, traces actives, lire logs/gastinelgarde.log.

  1. Client honnête : marcher et courir 20 s sur un terrain plat. Attendu : aucune ligne timer (si des lignes timer apparaissent à ~40 paquets/s, F01 est confirmé).
  2. Client honnête avec un trident Impulsion en main (sans l'utiliser) : marcher 10 s. Attendu : ligne journal « riptide : seuil relevé » en debug ; confirme F04 (le seuil est relevé à tort).
  3. Client de triche, module PingSpoof à 400 ms : courir à vitesse x1,5 (speed réglé juste au-dessus du seuil). Attendu : pas d'infraction avec ping 400, infraction avec ping 30 (F07).
  4. Client honnête : voler en élytres avec fusée à pleine vitesse puis atterrir en marchant. Attendu : ligne vitesse à l'atterrissage (F14).
  5. Client honnête : frapper une araignée ou un bébé zombie derrière une clôture, une trappe, un demi-bloc. Attendu : lignes attaque-impossible malgré le coup légitime (F18).
  6. Client honnête sur un grand train ou une grande contraption Create (plus de 6 blocs de long), debout à l'extrémité, en mouvement. Attendu : lignes vitesse ou vol si F19 est réel ; relever pocheContraption dans la ligne (liste des exemptions).
  7. Client de triche, module NoFall en mode « petit saut » ou équivalent, chute de 20 blocs : Attendu : dégâts de chute malgré no-fall OBSERVE ; noter si les dégâts sont absents (F22). Refaire avec no-fall en ENFORCE sur un seul joueur testeur.
  8. Client honnête sur un dirigeable Aeronautics (monter, tourner, se déplacer à bord, descendre, marcher dessus à l'arrêt, atterrir) : Attendu : aucune ligne. Sinon, noter les noms de classe d'entités proches (prefixesContraption) et les exemptions listées (F25).
  9. Client honnête : sprinter, sauter en courant, nager, glace, échelle, slime, riptide, perle, Wind Charge, puis chute. Attendu : aucune ligne (hors Wind Charge, signalé comme non géré).
  10. Client honnête : combat contre 5 zombies ou un banc de poissons, 30 s. Attendu : aucune ligne killaura-cibles (sinon seuil de 3 cibles trop bas pour ce serveur).
  11. Client de triche : killaura avec rotation silencieuse activée (« server-side rotation » ou « silent »), puis sans. Attendu : lignes killaura-angle uniquement sans la rotation silencieuse (F11).
  12. Client de triche : fly en hover, puis hover avec un paquet tous les deux ticks (module de lag/timer à 0,5). Attendu : vol vu dans le premier cas seulement (F08).
  13. Client de triche : timer à 1,05x puis 1,10x pendant 60 s, puis blink (retenir 5 s, relâcher). Attendu : rien (F03 confirmé) ; avec timer à 2x : timer vu.
  14. Client de triche : tricher dans un bateau (boat fly, vitesse). Attendu : rien de la part du mod, seul vanilla (10 blocs/paquet) intervient (F20).
  15. Un op : /garde status, /garde mode vitesse enforce puis off, /garde reload. Attendu : réponses correctes, fichier de configuration mis à jour.
  16. Laisser les traces actives 24 h avec 2 joueurs : vérifier la taille du dossier gastinelgarde-traces (F15) ; Attendu : < 1 Go, sinon plafond non appliqué.

Résumé (10 lignes)

  1. Le cœur est propre et testé ; le défaut majeur est à l'adaptateur : le mixin s'exécute aussi sur le thread réseau (F01), donc timer ×2, état corrompu.
  2. Ne pas passer en ENFORCE avant F01, F04, F05, F07, F14.
  3. Trident Impulsion tenu = 100 blocs/paquet autorisés et exemption totale (F04).
  4. Grâce de téléportation et de dégâts : déclenchables par le client (F05, F06).
  5. Ping falsifié = seuils ×1,5 (F07) ; vol aveugle si un paquet tous les 2 ticks (F08).
  6. Fenêtres circulaires saturables : plus on envoie, moins c'est vu (F02, F12, F13).
  7. Killaura à rotation silencieuse passe killaura-angle (F11) ; reach 3-4 blocs jamais mesuré.
  8. Véhicules jamais contrôlés (F20) ; élytres exemptées en bloc.
  9. Create et Aeronautics : exemption par proximité manquée pour les grandes structures et exploitable (F19, F25), à valider en jeu.
  10. 17 tests de preuve dans audit/tests-proposes/, 16 essais en jeu listés ci-dessus.