GastinelGarde

Anti-triche maison pour le serveur NeoForge 1.21.1 de Théo (mod côté serveur uniquement). Plan et décisions : ../PLAN-GASTINELGARDE.md. Version 0.3.0 : phases 0, 1 et 2 du plan, plus les corrections de l'audit du 2026-10-14 (audit/).

État : compilé, 128 tests JUnit verts (cœur pur, commandes, configuration, application réelle des mixins, preuves de l'audit). Jamais testé en jeu. Tous les contrôles démarrent en OBSERVE (journal et message aux ops, aucune sanction). Il n'y a jamais de bannissement automatique.

Nouveautés 0.3.0 (corrections de l'audit)

Détail faille par faille : audit/CORRECTIONS.md. Essais en jeu à faire : audit/ESSAIS-EN-JEU.md.

Faille Correction
F01 Le début du mouvement ne s'exécute plus sur le thread réseau (injection après ensureRunningOnSameThread) : fin du timer compté deux fois
F04 Riptide : tolérance seulement pendant la vrille vue par le serveur, ou 2 s après le relâchement d'un trident chargé (eau ou pluie). Tenir le trident ne fait plus rien
F05 Grâce de téléportation : seulement pour une téléportation externe (commande, perle, TPA, autre mod), plus pour un refus vanilla provoqué par le client
F06 Grâce de recul : seulement pour un vrai recul (coup, projectile, explosion, Wind Charge) ; une charge de vent à ses pieds : une grâce par 3 s
F07 Le ping (falsifiable) n'élargit plus les seuils : seul le TPS du serveur compte
F08 Le contrôle de vol s'évalue quel que soit l'écart entre paquets
F02 Timer compté par tranches de 50 ms : une inondation de paquets ne l'aveugle plus
F12 Cadence comptée par tranches de 50 ms, plafond de 3 coups par tick (deux ticks de suite)
F13 Cibles distinctes mémorisées par entité : frapper une cible en boucle ne chasse plus les autres
F20 Nouveaux contrôles vehicule-vitesse et vehicule-vol (bateaux, montures)
F11 Nouveau contrôle rotation (rotation silencieuse d'une killaura)

Restent ouvertes : F03, F09, F10, F14 à F19, F21 à F25 (voir audit/02-failles-detection.md). F19, F22 et F25 demandent des essais en jeu (audit/ESSAIS-EN-JEU.md).

Architecture

Couche Contenu
core/ (Java pur, sans Minecraft, testé en JUnit) Moteur, contrôles, points d'infraction (VlCompteur, décroissance), Paliers, Exemptions, grâces (GraceTeleport, GraceRecul, RiptideSuivi), CompteurTranches, TraceLigne / TraceFichier
Garde, GardeEvents, GardeCommands, GardeSpec lecture de l'état du serveur, événements NeoForge, commandes, configuration
mixin/ MovePacketMixin (lecture seule : débit des paquets, position acceptée, origine des téléportations, véhicules), RiptideMoveMixin (tolérance riptide)

Règle des mixins (F01, vérifiée par MixinsThreadTest) : rien n'est injecté en HEAD d'une méthode handle* ; on injecte après PacketUtils.ensureRunningOnSameThread, ou en TAIL. Toute cible est vérifiée par javap sur le jar NeoForge 21.1.234 et par MixinsAppliquesTest.

Les décisions de langage (Java, Rust seulement après benchmark) sont à la section 8 du plan. L'interface du cœur ne contient aucun type Minecraft (tableaux, primitifs, enregistrements) pour pouvoir porter un module plus tard.

Contrôles de combat (phase 1)

Id Idée Seuils par défaut
killaura-angle angle entre le regard et la silhouette de la cible 60° d'excédent
killaura-cibles entités différentes touchées plus de 3 en 1 s
rotation regard qui saute vers la cible au coup puis revient (rotation silencieuse) écart de 45° au coup, retour à 15° près en 3 ticks
cadence coups par seconde plus de 20 sur 2 s consécutives, ou plus de 3 coups dans deux ticks consécutifs
regularite intervalles quasi identiques à cadence rapide écart type < 12 ms et moyenne < 150 ms
attaque-impossible coup en mangeant ou en buvant, ou cible non visible sans seuil
timer paquets de mouvement par seconde plus de 22 sur 3 s consécutives

Contrôles de mouvement (phase 2)

Id Idée Détail
no-fall le client déclare « au sol » en pleine chute sans bloc dessous Corrige, ne punit pas : en ENFORCE, le serveur remplace le drapeau transmis aux dégâts de chute (mixin @ModifyArg sur doCheckFallDamage). En OBSERVE, rien n'est modifié. Faible poids (0,5 point).
vitesse déplacement horizontal supérieur au maximum attendu Tampon d'excès sur 20 ticks (1,5 bloc par défaut). Bornes : marche 0,23, course 0,30, saut en courant 0,42 bloc par tick, modulées par Vitesse et Lenteur. Valeurs de départ généreuses, à resserrer avec les traces.
vol en l'air, la vitesse verticale ne suit pas la gravité Modèle vy suivante = (vy − 0,08) × 0,98 itéré sur les ticks écoulés, tolérance 0,05 par tick, plus de 10 ticks anormaux consécutifs.
vehicule-vitesse véhicule piloté plus rapide que son type Bateau 0,45 bloc/tick (glace : 4,0), monture 2,65 × attribut de vitesse (au moins 0,4 ; glace : × 2). Distance permise comptée en ticks serveur, élan gardé à × 0,95 par tick. Bornes [À VÉRIFIER] en jeu.
vehicule-vol véhicule en l'air qui ne tombe pas Plus de 40 ticks en l'air sans tomber d'au moins 0,2 bloc par tick. Véhicules de mods inconnus non contrôlés.

Exemptions propres au mouvement : eau, lave, échelle, nage, vol créatif, toile, neige poudreuse, baie sucrée, slime, lit (milieu spécial) ; glace, âmes, miel (friction ou facteur de vitesse différents) ; plus les exemptions communes ci-dessous. Non gérés (fausses alertes possibles en OBSERVE) : propulsion par des mods tiers, pistons et blocs de slime, vitesses imposées par des blocs de commande.

Les temps de combat sont ceux du serveur (tick × 50 ms) : la régularité est donc mesurée au tick, ce qui rend l'écart type de 12 ms équivalent à « exactement constant ». Une arme à cadence fixe lente n'est pas suspecte.

Exemptions (une seule fonction : core/Exemptions)

Créatif, spectateur ; riptide (vrille vue par le serveur, ou relâchement d'un trident Impulsion chargé avec de l'eau ou de la pluie, puis 2 s) ; élytres ; lévitation, chute lente ; véhicule (pour les contrôles du joueur ; le véhicule piloté a ses propres contrôles) ; contraption Create / Aeronautics à moins de 3 blocs (détection par préfixe de nom de classe, à valider sur le serveur réel) ; 2 s après une téléportation externe ; 1 s après un vrai recul ; gel du serveur (tick de plus de 250 ms, 5 s de grâce). Serveur sous 18 TPS : seuils × 1,5. Le ping est journalisé mais n'élargit plus rien (la clé pingLagMs est ignorée).

Sanctions

Palier (points d'un contrôle) OBSERVE ENFORCE
au-dessus de 0 journal journal
5 alerte aux ops alerte aux ops
10 alerte coup annulé / retour à la dernière position valide (en véhicule : descente puis retour)
20 alerte expulsion

Plafond configurable (sanctionMax). Les points décroissent de 0,5 par seconde. rotation ne peut que journaliser et alerter (le coup a déjà eu lieu quand l'aller-retour est vu).

Commandes (ops, niveau 2)

/garde                          état
/garde status [joueur]          modes, ou points d'infraction d'un joueur
/garde alertes on|off           messages de l'anti-triche pour toi
/garde mode <contrôle> off|observe|enforce   (écrit dans la configuration)
/garde exempter <joueur> <minutes>
/garde traces on|off            enregistreur (jusqu'au redémarrage)
/garde reload

Fichiers

  • Configuration : config/gastinelgarde-server.toml (rechargée à chaud, plus /garde reload). Les clés des nouveaux contrôles (rotation, vehicule-vitesse, vehicule-vol) sont ajoutées en OBSERVE au premier démarrage de la 0.3.0.
  • Journal : logs/gastinelgarde.log (une ligne par infraction : contrôle, points, exemptions actives).
  • Traces : gastinelgarde-traces/trace-AAAA-MM-JJ.jsonl (événements move, atk et, depuis 0.3.0, veh). Enregistrement continu pour tous (décision T7 de Théo). Ce sont des positions de joueurs, donc des données personnelles : conservation 7 jours et 1 Go au maximum par défaut ([traces] dans la configuration). Ordre de grandeur : 20 lignes par seconde et par joueur, environ 150 octets par ligne, donc environ 10 Mo par heure et par joueur connecté.

Régler les seuils avec les traces (rejeu)

Les traces JSONL se rejouent dans le moteur, sans serveur :

java -cp build/libs/gastinelgarde-neoforge-1.21.1-0.3.0.jar com.gastinelgarde.core.Rejeu trace-2026-10-14.jsonl

Sortie : nombre de mouvements et d'attaques, infractions et points maximaux par contrôle, vingt exemples. Méthode : enregistrer une session honnête (marche, course, sauts, chute, glace, échelle, eau, riptide, élytres, bateau, cheval, combat) et une session avec le client de triche, rejouer les deux, puis ajuster les seuils (excesVitesseBlocs, angleMaxDegres, …) jusqu'à zéro infraction sur la première et des infractions franches sur la seconde. Ne se rejouent pas : le timer (pas de temps réel des paquets), rotation (la trace n'a pas le regard) et les véhicules (lignes veh ignorées pour l'instant). Un test JUnit (RejeuTest) couvre le principe.

Construire et déployer

sh build-sur-cornafserver.sh        # sur cornafserver, conteneur JDK 21 jetable
.\gradlew.bat build                 # ou sur le PC (JDK 21) : build/libs/gastinelgarde-neoforge-1.21.1-0.3.0.jar
bash ../deployer-garde-0-3-0.sh     # sur cornafserver, par Théo (non lancé) ; remplace le jar 0.2.0 s'il est là

À vérifier en jeu (jamais fait)

Tout est dans audit/ESSAIS-EN-JEU.md : vérification de chaque correction (faux positifs et triches attendues) et protocoles pour F19 (grandes contraptions Create), F22 (no-fall par petite montée) et F25 (dirigeables Aeronautics).

Riptide : retirer le mixin de GastinelClaims 1.1.6

GastinelClaims 1.1.6 contient l'ancien RiptideMoveMixin (seuil vanilla relevé dès que le trident est tenu). Tant qu'il est chargé, F04 reste ouverte côté vanilla, même avec GastinelGarde 0.3.0. À faire : une 1.1.7 de GastinelClaims sans RiptideMoveMixin ni RiptideTolerance (non fait : le code de GastinelClaims 1.1.2 à 1.1.6 n'est pas commité).

Limites connues

  • Phase 3 non commencée : élytres, débogage d'AntiXray, heuristique de minage. Contrôles suggérés par l'audit et non faits : balance de timer (F03, blink), anti-knockback, reach.
  • Jamais essayé sur de vrais mouvements : les bornes de vitesse (joueur et véhicules), le modèle de vol et les seuils de rotation viennent des formules vanilla, pas de mesures. Les traces permettront de les ajuster avant tout ENFORCE.
  • Riptide : sous une vraie pluie, une boucle de riptides honnête et une boucle de triche se ressemblent ; le seuil vanilla relevé à 100 blocs par paquet pendant la vrille est gardé.
  • La grâce « gel du serveur » se base sur la durée d'un tick (> 250 ms), pas sur le message vanilla « Can't keep up ».
  • online-mode=false : un tricheur expulsé peut revenir sous un autre pseudo de la whitelist.
  • Le contrôle attaque-impossible ne couvre que les cas à courte portée : vanilla refuse déjà les coups à plus de 3 blocs sans ligne de vue.
S
Description
Aucune description fournie
Lisez-moi
641 KiB
0 Favoris 1 Observateurs 0 Bifurcations
Langues
Java 99.9%
Shell 0.1%