7.5 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.2.0 : phases 0, 1 et 2 du plan.
État : compilé, 90 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é.
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.