139 lignes
8.3 KiB
Markdown
139 lignes
8.3 KiB
Markdown
# 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.
|