11 KiB
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 enOBSERVEau 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énementsmove,atket, 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-impossiblene couvre que les cas à courte portée : vanilla refuse déjà les coups à plus de 3 blocs sans ligne de vue.