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)

  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.

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-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%