From d0c001d1e2215a23d1e1c31bc813398e66b48dc3 Mon Sep 17 00:00:00 2001 From: gastinelt <264859180+gastinelt@users.noreply.github.com> Date: Wed, 14 Oct 2026 09:23:41 +0200 Subject: [PATCH] GastinelGarde 0.3.0 : version, README, journal des corrections Co-Authored-By: Claude Opus 5.5 --- README.md | 129 +++++++++++------- audit/CORRECTIONS.md | 12 +- gradle.properties | 2 +- .../resources/META-INF/neoforge.mods.toml | 4 +- 4 files changed, 95 insertions(+), 52 deletions(-) diff --git a/README.md b/README.md index d259223..f3a4adb 100644 --- a/README.md +++ b/README.md @@ -1,57 +1,88 @@ # 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. +`../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é, 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. +**É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`, `TraceLigne` / `TraceFichier` | +| `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, marque de téléportation), `RiptideMoveMixin` (tolérance riptide, reprise de GastinelClaims) | +| `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 (phase 1) +## 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 | -| `cadence` | coups par seconde | plus de 20 sur 2 s consécutives | +| `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, version 0.2.0) +### 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`, tolérance 0,05, plus de 10 ticks anormaux consécutifs. Détecte le flottement, la montée constante et le plané lent. | +| `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 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. +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 (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. +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 @@ -59,10 +90,11 @@ sur le serveur réel**) ; 2 s après une téléportation, un recul ou un dégât |---|---|---| | au-dessus de 0 | journal | journal | | 5 | alerte aux ops | alerte aux ops | -| 10 | alerte | coup annulé / retour à la dernière position valide | +| 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. +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) @@ -78,60 +110,61 @@ Plafond configurable (`sanctionMax`). Les points décroissent de 0,5 par seconde ## Fichiers -- Configuration : `config/gastinelgarde-server.toml` (rechargée à chaud, plus `/garde reload`). +- 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`. **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é. +- 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.2.0.jar com.gastinelgarde.core.Rejeu trace-2026-10-14.jsonl +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 -volant Create, combat) et une session avec le client de triche, rejouer les deux, puis ajuster les seuils +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. Le timer n'est pas rejouable (la trace n'a pas le temps réel des paquets). Un test JUnit -(`RejeuTest`) couvre le principe. +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.2.0.jar -bash ../deployer-garde-0-2-0.sh # sur cornafserver, par Théo (non lancé) +.\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) -1. `/garde status` répond, tous les contrôles en OBSERVE. -2. Marcher, sprinter, nager, prendre une perle : aucune alerte. -3. Avec ton client de triche : killaura (`killaura-angle`, `killaura-cibles`, `cadence`), timer, speed (`vitesse`), - fly (`vol`) et no-fall lèvent des infractions dans `logs/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. -4. Riptide : plus de retour en arrière (le mixin est repris de GastinelClaims 1.1.6). -5. 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`. -6. Lancer une session honnête (marche, combat, riptide, élytres, bateau volant) pour amorcer le corpus de traces. +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 : GastinelClaims 1.1.6 contient le même mixin +### Riptide : retirer le mixin de GastinelClaims 1.1.6 -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é). +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. -- 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`. +- 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 diff --git a/audit/CORRECTIONS.md b/audit/CORRECTIONS.md index 9481064..b493bc8 100644 --- a/audit/CORRECTIONS.md +++ b/audit/CORRECTIONS.md @@ -20,7 +20,7 @@ Base avant corrections : 98 tests verts. | F20 véhicules | corrigée (bornes [À VÉRIFIER]) | `git log --grep F20` | `AuditFaillesTest.F20_*` (6) ; `MixinsAppliquesTest` couvre la nouvelle injection ; 128 verts | essai en jeu n° 14 + bateau sur glace bleue, cheval rapide, chameau (dash), cochon, arpenteur : aucune fausse alerte ; rejeu des lignes `veh` non écrit | | F11 rotation silencieuse | corrigée (seuils [À VÉRIFIER]) | `git log --grep F11` | `AuditFaillesTest.F11_*` (3) ; 127 verts | essai en jeu n° 11 ; PvP honnête rapide sans ligne `rotation` | | F19, F22, F25 | essais en jeu préparés, code non modifié | `git log --grep ESSAIS` | aucun (non testable sans le jeu) | `audit/ESSAIS-EN-JEU.md` à dérouler par Théo | -| Version 0.3.0, jar, README, script | à faire | | | | +| Version 0.3.0, jar, README, script | fait | `git log --grep 0.3.0` | `gradlew clean build` : 128 verts, `build/libs/gastinelgarde-neoforge-1.21.1-0.3.0.jar` | déployer : `bash ../deployer-garde-0-3-0.sh` (hors dépôt, **non lancé**) ; retirer le mixin riptide de GastinelClaims 1.1.6 | ## Détail @@ -82,3 +82,13 @@ Base avant corrections : 98 tests verts. - Suite (revue de sécurité du commit F20) : (1) la distance permise se compte en ticks serveur écoulés : un solde (crédit plafonné à 2 ticks, dette au-delà de 1,5 bloc = infraction) remplace le tampon par paquet ; dix paquets dans un tick ne valent plus dix fois la distance (`F20_paquets_multiples_dans_un_tick_vus`, gigue honnête incluse). (2) Sur la glace, borne du type (bateau 4,0 ; monture ×2) au lieu de l'infini, élan plafonné à 4,0 (`F20_elan_de_glace_borne`). (3) En véhicule, la position de retour n'est mémorisée qu'après un paquet de véhicule sans verdict. (4) Changer de véhicule ou remonter ne remet le temps en l'air et le solde à zéro qu'après 2 s sans véhicule. - F11 suite (revue de sécurité du commit F11) : le regard de référence est le regard de fin de tick des 4 derniers ticks serveur, et non plus des 8 derniers paquets : une inondation de paquets de rotation ne le chasse plus (`F11_inondation_de_rotations_vue`). - Seconde revue de F20 : (1) l'élan décroît à chaque tick écoulé et la distance permise d'un paquet de n ticks est la somme tick par tick (`F20_elan_decroit_sur_chaque_tick_ecoule`) ; (2) la position de retour suit le joueur comme avant dès que son véhicule n'est pas contrôlé (passager non pilote, véhicule de mod, contrôles `vehicule-*` sur OFF, exemption manuelle) ; (3) changer de véhicule en moins de 2 s efface l'élan et le crédit (la dette et le temps en l'air restent). + +### Version 0.3.0 +- `gradle.properties` et `META-INF/neoforge.mods.toml` en 0.3.0 ; jar reconstruit (`gradlew clean build`, 128 tests verts). +- README à jour (corrections, nouveaux contrôles `rotation`, `vehicule-vitesse`, `vehicule-vol`, exemptions, rejeu). +- `../deployer-garde-0-3-0.sh` (dans `mods-serveur/`, hors dépôt GastinelGarde, comme le script 0.2.0) : met le jar 0.2.0 de côté s'il est présent, le remplace par le 0.3.0, vérifie le démarrage, retour arrière automatique (remet le 0.2.0). **Non lancé**, aucune connexion aux serveurs. + +## Bilan +- Corrigées : F01, F04, F05, F06, F07, F08, F02, F12, F13, F20, F11 (11 failles, avec les suites demandées par les revues de sécurité). +- Restantes : F03, F09, F10, F14, F15, F16, F17, F18, F21, F23, F24 (code), F19, F22, F25 (essais en jeu préparés). +- Tests : 98 au départ, 128 à la fin, tous verts. diff --git a/gradle.properties b/gradle.properties index 59d3a1e..7f21470 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,7 +1,7 @@ org.gradle.jvmargs=-Xmx2G org.gradle.parallel=true -mod_version=0.2.0 +mod_version=0.3.0 mod_group_id=com.gastinelgarde mod_id=gastinelgarde diff --git a/src/main/resources/META-INF/neoforge.mods.toml b/src/main/resources/META-INF/neoforge.mods.toml index a750b6e..6c6395f 100644 --- a/src/main/resources/META-INF/neoforge.mods.toml +++ b/src/main/resources/META-INF/neoforge.mods.toml @@ -4,10 +4,10 @@ license="MIT" [[mods]] modId="gastinelgarde" -version="0.2.0" +version="0.3.0" displayName="GastinelGarde" authors="Théo Gastinel" -description='''Anti-triche maison : combat, cadence, timer (phase 1), no-fall, vitesse et vol (phase 2), points d'infraction avec décroissance, setback puis expulsion, jamais de bannissement automatique. Mod côté serveur uniquement.''' +description='''Anti-triche maison : combat, cadence, rotation, timer (phase 1), no-fall, vitesse, vol et véhicules (phase 2), points d'infraction avec décroissance, setback puis expulsion, jamais de bannissement automatique. Mod côté serveur uniquement.''' # Les clients n'ont pas besoin du mod : ne pas exiger sa présence côté client. displayTest="IGNORE_ALL_VERSION"