Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
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.2.0 : phases 0, 1 et 2 du plan.
État : compilé, 98 tests JUnit verts (cœur pur, commandes, configuration, application réelle des mixins).
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.
Architecture
| Couche | Contenu |
|---|---|
core/ (Java pur, sans Minecraft, testé en JUnit) |
Moteur, contrôles, points d'infraction (VlCompteur, décroissance), Paliers, Exemptions, 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, marque de téléportation), RiptideMoveMixin (tolérance riptide, reprise de GastinelClaims) |
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 (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 |
cadence |
coups par seconde | plus de 20 sur 2 s consécutives |
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, version 0.2.0)
| 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, tolérance 0,05, plus de 10 ticks anormaux consécutifs. Détecte le flottement, la montée constante et le plané lent. |
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 toutes les exemptions
communes ci-dessous. Non gérés pour l'instant (fausses alertes possibles en OBSERVE) : charge de vent
(Wind Charge), propulsion par des mods tiers, 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 (trident Impulsion en main et 2 s après) ; élytres ; lévitation, chute lente ; véhicule ; 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, un recul ou un dégât ; gel du serveur (tick de plus de 250 ms, 5 s de grâce). Serveur sous 18 TPS ou ping de plus de 250 ms : seuils × 1,5.
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 |
| 20 | alerte | expulsion |
Plafond configurable (sanctionMax). Les points décroissent de 0,5 par seconde.
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). - Journal :
logs/gastinelgarde.log(une ligne par infraction : contrôle, points, exemptions actives). - Traces :
gastinelgarde-traces/trace-AAAA-MM-JJ.jsonl. 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.2.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
volant Create, 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. Le timer n'est pas rejouable (la trace n'a pas le temps réel des paquets). 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.2.0.jar
bash ../deployer-garde-0-2-0.sh # sur cornafserver, par Théo (non lancé)
À vérifier en jeu (jamais fait)
/garde statusrépond, tous les contrôles en OBSERVE.- Marcher, sprinter, nager, prendre une perle : aucune alerte.
- Avec ton client de triche : killaura (
killaura-angle,killaura-cibles,cadence), timer, speed (vitesse), fly (vol) et no-fall lèvent des infractions danslogs/gastinelgarde.log. Honnêtement, essayer aussi : sauts en courant, chute, glace, échelle, eau, slime, Wind Charge, élytres avec fusée, riptide, perle. Chaque ligne du journal indique les exemptions actives. - Riptide : plus de retour en arrière (le mixin est repris de GastinelClaims 1.1.6).
- Create Aeronautics : monter dans une contraption, se battre dessus. Aucune fausse alerte, sinon relever les
noms de classe des entités et compléter
prefixesContraption. - Lancer une session honnête (marche, combat, riptide, élytres, bateau volant) pour amorcer le corpus de traces.
Riptide : GastinelClaims 1.1.6 contient le même mixin
Décision T6 : le mixin riptide vit désormais dans GastinelGarde. Tant que les deux mods sont présents, le seuil est
relevé deux fois au même maximum (sans danger). À faire plus tard : 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.
- Phase 2 jamais essayée sur de vrais mouvements : les bornes de vitesse et le modèle de vol viennent des
formules vanilla, pas de mesures. Les traces enregistrées permettront de les ajuster avant tout
ENFORCE. - 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.