P3.7 (partie completion) : nouveau controle completion (OBSERVE par defaut)

- Vanilla 1.21.1 (handleCustomCommandSuggestions, sources NeoForge 21.1.234)
  analyse chaque demande de completion (jusqu'a 32 500 caracteres) sans
  limite de debit : un client force peut faire tirer le serveur.
- Nouveau mixin CompletionMixin, injecte juste apres
  ensureRunningOnSameThread (regle F01, verifiee par MixinsThreadTest).
- Seau a jetons : completionParSecondeMax 20/s, completionRafaleMax 40 ;
  0,25 point par demande en exces. En ENFORCE chaque demande en exces est
  ignoree (pas seulement la premiere) ; en OBSERVE rien ne change.
- Le reste de 3.7 (livres, NBT) : couvert par vanilla, voir le rapport.
- Tests : CompletionP3Test (5), MixinsThreadTest (+1).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Cette révision appartient à :
gastineltetClaude Sonnet 5.5 a révisé 2026-10-24 03:13:47 +02:00
1 Parent b6aecade29
révision 691d0a3d42
11 fichiers modifiés
+201 -5

Aucun fichier ne correspond à votre recherche

+14
Voir le fichier
@@ -502,6 +502,20 @@ public final class Garde {
return annulerNuker || Cablage.sanctionDeMouvement(s);
}
/**
* 0.5 (P3.7) : demande de complétion de commande (mixin, après ensureRunningOnSameThread). Vrai si le paquet doit
* être ignoré (completion en ENFORCE et débit dépassé, ou expulsion en cours).
*/
public static boolean noterCompletion(ServerPlayer p) {
if (!surThreadServeur(p)) return false;
if (CONFIG.mode(Controle.COMPLETION) == Mode.OFF) return false;
if (MOTEUR.estExpulse(p.getUUID())) return true;
List<Verdict> v = MOTEUR.completion(p.getUUID(), System.currentTimeMillis(), etat(p, false));
Sanction s = traiter(p, v);
if (s == Sanction.EXPULSION) appliquerSanctionMouvement(p, s, v);
return MOTEUR.completionAIgnorer(p.getUUID());
}
// 0.5 (P3.1) : tick d'apparition des cristaux de l'End récents (id d'entité -> tick serveur). Thread serveur seulement.
private static final java.util.Map<Integer, Integer> CRISTAUX = new java.util.HashMap<>();
+9 -1
Voir le fichier
@@ -38,7 +38,8 @@ public final class GardeSpec {
private static final ModConfigSpec.DoubleValue FAST_PLACE_REGULARITE, INTER_MARGE;
private static final ModConfigSpec.IntValue INTER_SERIE, TOTEM_ECHANT, TOTEM_ECART, TOTEM_REG_MAX;
// 0.5 (P3)
private static final ModConfigSpec.IntValue NUKER_MAX, NUKER_SERIE, CRISTAL_DELAI, CRISTAL_SERIE, TOWER_INTERVALLE, TOWER_SERIE;
private static final ModConfigSpec.IntValue NUKER_MAX, NUKER_SERIE, CRISTAL_DELAI, CRISTAL_SERIE, TOWER_INTERVALLE, TOWER_SERIE,
COMPLETION_PAR_S, COMPLETION_RAFALE;
private static final ModConfigSpec.DoubleValue ANGLE_MAX;
private static final ModConfigSpec.IntValue CIBLES_MAX;
@@ -339,6 +340,11 @@ public final class GardeSpec {
.defineInRange("towerIntervalleMinTicks", 6, 2, 9);
TOWER_SERIE = b.comment("Tower : intervalles courts de suite avant que chaque pose rapide suivante compte (et soit annulable en ENFORCE).")
.defineInRange("towerSerie", 5, 1, 50);
COMPLETION_PAR_S = b.comment("0.5 (P3.7) completion : demandes de complétion de commande par seconde soutenues permises.",
"Vanilla analyse chaque demande sans limite de débit ; le client vanilla en envoie une par frappe. En ENFORCE l'excès est ignoré.")
.defineInRange("completionParSecondeMax", 20, 5, 1000);
COMPLETION_RAFALE = b.comment("Completion : rafale permise (capacité du seau à jetons).")
.defineInRange("completionRafaleMax", 40, 5, 1000);
b.pop();
b.comment("0.5 (P2.10) x-ray statistique : alerte seulement, jamais de setback ni d'expulsion (même en ENFORCE).").push("xray");
@@ -548,6 +554,8 @@ public final class GardeSpec {
c.cristalSerieMin = CRISTAL_SERIE.get();
c.towerIntervalleMinTicks = TOWER_INTERVALLE.get();
c.towerSerie = TOWER_SERIE.get();
c.completionParSecondeMax = COMPLETION_PAR_S.get();
c.completionRafaleMax = COMPLETION_RAFALE.get();
c.graceApresExpulsionTicks = GRACE_APRES_EXPULSION.get();
c.setbackSolSiPasDePosition = SETBACK_SOL.get();
c.graceReculTicks = GRACE_RECUL.get();
+39
Voir le fichier
@@ -0,0 +1,39 @@
package com.gastinelgarde.core;
/**
* 0.5 (P3.7) : spam de demandes de complétion de commande (ServerboundCommandSuggestionPacket, touche Tab et frappe
* dans le chat après « / »). Vanilla 1.21.1 (ServerGamePacketListenerImpl.handleCustomCommandSuggestions, sources
* NeoForge 21.1.234) analyse la commande complète (jusqu'à 32 500 caractères) à chaque paquet, sans aucune limite de
* débit : un client forgé peut faire tirer le serveur. Le client vanilla en envoie une par frappe de touche.
*
* Seau à jetons : capacité {@link GardeConfig#completionRafaleMax} (40), rempli à
* {@link GardeConfig#completionParSecondeMax} (20) jetons par seconde. Un paquet sans jeton est en excès : 0,25 point
* chacun ; en ENFORCE il est ignoré (pas de réponse), quel que soit le palier.
*/
public final class Completion {
private double jetons = Double.NaN;
private long dernierMs;
private int excesTotal;
/** Une demande de complétion reçue. @return vrai si elle est en excès */
public boolean demande(long nowMs, GardeConfig cfg) {
double capacite = Math.max(1, cfg.completionRafaleMax);
if (Double.isNaN(jetons)) {
jetons = capacite;
} else if (nowMs > dernierMs) {
jetons = Math.min(capacite, jetons + (nowMs - dernierMs) * Math.max(1, cfg.completionParSecondeMax) / 1000.0);
}
dernierMs = Math.max(dernierMs, nowMs);
if (jetons >= 1) {
jetons -= 1;
return false;
}
excesTotal++;
return true;
}
public int excesTotal() {
return excesTotal;
}
}
+4 -2
Voir le fichier
@@ -51,7 +51,9 @@ public enum Controle {
/** 0.5 (P3.1) : cristaux de l'End frappés en série dès leur apparition (AutoCrystal / CrystalAura). */
AUTO_CRISTAL("auto-cristal"),
/** 0.5 (P3.2) : pilier monté plus vite que le saut vanilla, blocs posés sous les pieds (Scaffold Tower). */
TOWER("tower");
TOWER("tower"),
/** 0.5 (P3.7) : demandes de complétion de commande au-delà d'un débit humain (spam de Tab, paquets forgés). */
COMPLETION("completion");
private final String id;
@@ -81,7 +83,7 @@ public enum Controle {
// 0.5 : nouveaux contrôles P1 au plafond « faible » tant qu'ils n'ont pas été validés en jeu.
case TIMER, ROTATION, ATTAQUE_IMPOSSIBLE, VEHICULE_VITESSE, VEHICULE_VOL, ELYTRES, VELOCITE, STEP, CRITICALS, ANTI_FAIM,
NO_SLOW, FAST_BREAK, FAST_PLACE, INTERACTION_BLOC, AUTO_TOTEM_REGULIER,
JESUS, OMNISPRINT, XRAY, NUKER, AUTO_CRISTAL, TOWER -> 2; // 0.5 (P2) : idem
JESUS, OMNISPRINT, XRAY, NUKER, AUTO_CRISTAL, TOWER, COMPLETION -> 2; // 0.5 (P2) : idem
};
}
+4
Voir le fichier
@@ -238,6 +238,10 @@ public final class GardeConfig {
public int towerIntervalleMinTicks = 6;
/** Tower : intervalles courts de suite avant que chaque pose rapide suivante compte. */
public int towerSerie = 5;
/** Complétion : demandes par seconde soutenues permises (le client vanilla en envoie une par frappe). */
public int completionParSecondeMax = 20;
/** Complétion : rafale permise (capacité du seau). */
public int completionRafaleMax = 40;
// --- 0.5 (P1.13, section [diagnostic]) : journal seulement, jamais de sanction ---
/** Journaliser les ABORT de casse de bloc sans START correspondant (« Mismatch in destroy block pos »). */
+23
Voir le fichier
@@ -608,6 +608,29 @@ public final class Moteur {
return v;
}
/**
* 0.5 (P3.7) : demande de complétion de commande reçue (horloge réelle : plusieurs paquets par tick). Aucune
* exemption de jeu (rien ne dépend du mouvement). Voir {@link #completionAIgnorer}.
*/
public List<Verdict> completion(UUID joueur, long nowMs, EtatJoueur etat) {
if (expulses.contains(joueur) || cfg.mode(Controle.COMPLETION) == Mode.OFF) return List.of();
Suivi s = suivi(joueur);
boolean exces = s.completion.demande(nowMs, cfg);
s.completionExces = exces;
List<Verdict> v = new ArrayList<>(1);
ajouter(v, s, Controle.COMPLETION, exces ? 0.25 : 0, nowMs, Exemptions.evaluer(etat, cfg, Exemptions.Famille.TIMER),
String.format(Locale.ROOT, "demande de completion au-dela de %d/s (rafale %d), %d en exces depuis la connexion",
cfg.completionParSecondeMax, cfg.completionRafaleMax, s.completion.excesTotal()));
return v;
}
/** La dernière demande de complétion était en excès et le contrôle est en ENFORCE : le paquet est ignoré. */
public boolean completionAIgnorer(UUID joueur) {
if (expulses.contains(joueur)) return true;
Suivi s = suivis.get(joueur);
return s != null && s.completionExces && cfg.mode(Controle.COMPLETION) == Mode.ENFORCE;
}
/** Un bloc vient d'être posé par le joueur (BlockEvent.EntityPlaceEvent) : fast-place. */
public List<Verdict> poseBloc(UUID joueur, long nowMs, long tick, EtatJoueur etat) {
if (expulses.contains(joueur) || cfg.mode(Controle.FAST_PLACE) == Mode.OFF) return List.of();
+3
Voir le fichier
@@ -87,6 +87,9 @@ public final class Suivi {
public final AutoCristal autoCristal = new AutoCristal();
/** 0.5 (P3.2) : tower. */
public final Tower tower = new Tower();
/** 0.5 (P3.7) : complétion de commande. */
public final Completion completion = new Completion();
public boolean completionExces;
/** 0.5 (P1.6) : déploiements d'élytres répétés. */
public final DeploiementsElytres deploiements = new DeploiementsElytres();
/** 0.5 (P1.13) : diagnostic des actions de casse de bloc. */
+33
Voir le fichier
@@ -0,0 +1,33 @@
package com.gastinelgarde.mixin;
import com.gastinelgarde.Garde;
import net.minecraft.server.level.ServerPlayer;
import net.minecraft.server.network.ServerGamePacketListenerImpl;
import org.spongepowered.asm.mixin.Mixin;
import org.spongepowered.asm.mixin.Shadow;
import org.spongepowered.asm.mixin.injection.At;
import org.spongepowered.asm.mixin.injection.Inject;
import org.spongepowered.asm.mixin.injection.callback.CallbackInfo;
/**
* 0.5 (P3.7) : débit des demandes de complétion de commande. Vanilla analyse chaque demande sans limite de débit.
* En ENFORCE, une demande en excès est ignorée (pas de réponse) ; sinon rien ne change.
*
* Règle (F01) : injecté juste APRÈS ensureRunningOnSameThread (cible unique dans la méthode, sources NeoForge
* 21.1.234), donc une seule fois, sur le thread serveur.
*/
@Mixin(ServerGamePacketListenerImpl.class)
public abstract class CompletionMixin {
@Shadow public ServerPlayer player;
@Inject(method = "handleCustomCommandSuggestions",
at = @At(value = "INVOKE",
target = "Lnet/minecraft/network/protocol/PacketUtils;ensureRunningOnSameThread(Lnet/minecraft/network/protocol/Packet;Lnet/minecraft/network/PacketListener;Lnet/minecraft/server/level/ServerLevel;)V",
shift = At.Shift.AFTER),
cancellable = true)
private void gastinelgarde$completion(net.minecraft.network.protocol.game.ServerboundCommandSuggestionPacket packet,
CallbackInfo ci) {
if (player != null && Garde.noterCompletion(player)) ci.cancel();
}
}
+1 -1
Voir le fichier
@@ -3,6 +3,6 @@
"minVersion": "0.8",
"package": "com.gastinelgarde.mixin",
"compatibilityLevel": "JAVA_21",
"mixins": ["MovePacketMixin", "RiptideMoveMixin", "MinecartPushMixin"],
"mixins": ["MovePacketMixin", "RiptideMoveMixin", "MinecartPushMixin", "CompletionMixin"],
"injectors": {"defaultRequire": 1}
}
+12 -1
Voir le fichier
@@ -73,7 +73,8 @@ class MixinsThreadTest {
@Test
void F01_aucune_injection_HEAD_dans_un_handle() throws Exception {
for (String classe : new String[] {"com.gastinelgarde.mixin.MovePacketMixin", "com.gastinelgarde.mixin.RiptideMoveMixin"}) {
for (String classe : new String[] {"com.gastinelgarde.mixin.MovePacketMixin", "com.gastinelgarde.mixin.RiptideMoveMixin",
"com.gastinelgarde.mixin.CompletionMixin"}) {
for (Injection i : injections(lire(classe))) {
if (!visePaquet(i) || i.at() == null) continue;
assertFalse("HEAD".equals(valeur(i.at(), "value")),
@@ -82,6 +83,16 @@ class MixinsThreadTest {
}
}
@Test
void F01_completion_apres_ensureRunningOnSameThread() throws Exception {
Injection i = injections(lire("com.gastinelgarde.mixin.CompletionMixin")).stream()
.filter(x -> x.methode().equals("gastinelgarde$completion")).findFirst().orElseThrow();
assertEquals("INVOKE", valeur(i.at(), "value"));
assertEquals(ENSURE, valeur(i.at(), "target"));
Object shift = valeur(i.at(), "shift");
assertTrue(shift instanceof String[] s && s.length == 2 && "AFTER".equals(s[1]), "shift = AFTER");
}
@Test
void F01_debut_du_mouvement_apres_ensureRunningOnSameThread() throws Exception {
Injection avant = injections(lire("com.gastinelgarde.mixin.MovePacketMixin")).stream()
+59
Voir le fichier
@@ -0,0 +1,59 @@
package com.gastinelgarde.core;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.UUID;
import org.junit.jupiter.api.Test;
/** 0.5, P3.7 : débit des demandes de complétion de commande. */
class CompletionP3Test {
private final GardeConfig cfg = new GardeConfig();
private final UUID joueur = UUID.randomUUID();
/** n demandes espacées de pasMs ; renvoie [points, ignorées]. */
private double[] demandes(Moteur m, int n, long pasMs) {
double pts = 0;
int ignorees = 0;
for (int i = 0; i < n; i++) {
for (Verdict v : m.completion(joueur, 1_000_000L + i * pasMs, EtatJoueur.normal())) pts += v.points();
if (m.completionAIgnorer(joueur)) ignorees++;
}
return new double[] {pts, ignorees};
}
@Test
void observeParDefaut() {
assertEquals(Mode.OBSERVE, cfg.mode(Controle.COMPLETION));
assertEquals(Controle.COMPLETION, Controle.parse("completion"));
}
@Test
void frappeHumaineJamaisVue() {
// 15 frappes par seconde pendant une minute.
assertEquals(0, demandes(new Moteur(cfg), 900, 66)[0], 1e-9);
}
@Test
void rafaleCourteToleree() {
assertEquals(0, demandes(new Moteur(cfg), 40, 0)[0], 1e-9);
}
@Test
void spamVuMaisRienIgnoreEnObserve() {
double[] r = demandes(new Moteur(cfg), 2000, 1);
assertTrue(r[0] > 0);
assertEquals(0, r[1], 1e-9);
}
@Test
void enforceIgnoreChaqueDemandeEnExces() {
cfg.mode(Controle.COMPLETION, Mode.ENFORCE);
Moteur m = new Moteur(cfg);
double[] r = demandes(m, 1000, 0); // 1000 demandes au même instant : 40 servies, 960 ignorées
assertEquals(960, r[1], 1e-9);
assertFalse(new Completion().demande(0, cfg));
}
}