Fichiers
gastinel-claims/README.md
T
Théo GastineletClaude Opus 5.5 2682d0cb3d GastinelClaims 1.1.3 a 1.1.6 : tolerance riptide (mixin RiptideMoveMixin, RiptideTolerance)
Commit groupe : les etats intermediaires 1.1.3, 1.1.4, 1.1.5 n'ont jamais ete
sauvegardes (code modifie en place, seul 1.1.6 existe), donc non reconstituables.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 01:04:52 +02:00

GastinelClaims

Protection de terrains par chunk pour NeoForge 1.21.1 (21.1.234). Mod côté serveur uniquement : les clients n'ont rien à installer (displayTest="IGNORE_ALL_VERSION", aucun bloc/objet/paquet réseau, messages en texte brut).

Commandes

  • /claim : protège le chunk courant (toute la hauteur). Refus si déjà pris (avec le nom du propriétaire) ou limite atteinte.
  • /claim info : à qui est le chunk + claims restants.
  • /unclaim : libère le chunk courant s'il est à toi.
  • /friend, /friend add <pseudo>, /friend unadd <pseudo> : un ami a accès à tous tes claims. Le pseudo doit être connu du serveur (en ligne ou déjà venu). Stocké par UUID.
  • Pseudos spéciaux (depuis 1.1.1) : un pseudo avec un caractère non tapable (ex. gabybou201") se vise sans ce caractère (/friend add gabybou201). Ordre : pseudo exact, puis forme normalisée (minuscules, hors [A-Za-z0-9_] retiré) parmi les joueurs en ligne, puis usercache.json. Un seul compte correspond -> utilisé (UUID du vrai profil, vrai pseudo affiché). Plusieurs -> refus avec la liste des candidats (jamais de choix au hasard). Tab propose la forme sans guillemet. Logique pure : core/PseudoMatcher.java (tests PseudoMatcherTest).
  • Serveur hors-ligne (depuis 1.1.2) : dans usercache.json, seuls les profils dont l'UUID est l'UUID hors-ligne du pseudo (OfflinePlayer:<pseudo>, version 3) sont gardés (PseudoMatcher.garderHorsLigne). Les UUID Microsoft venus de la whitelist ou de ops.json ne peuvent pas se connecter, et rendaient le pseudo ambigu (« Plusieurs joueurs ressemblent à… »). En online-mode=true, rien n'est filtré.

Config

config/gastinelclaims-server.toml : maxClaimsParJoueur = 25.

Protections (si ni propriétaire, ni ami, ni op niveau 2+)

Casser/poser des blocs, clic droit sur un bloc (coffres, portes, leviers, boutons, machines Create...), case voisine du clic quand on tient un objet (feu, liquide), seaux visant le claim, piétinement des cultures, perles de l'Ender qui atterrissent dans le claim, frapper ou interagir avec les entités non hostiles (animaux, cadres, supports d'armure). Commerce avec les villageois autorisé. Les explosions ne cassent pas les blocs claimés ni les entités non hostiles dedans. Marcher reste autorisé.

Données

<monde>/data/gastinelclaims.dat (overworld, toutes dimensions dedans).

Limites connues

  • FakePlayer (Create deployer...) : la machine agit pour le propriétaire du chunk où elle se trouve. Machine dans ton claim (ou celui d'un joueur dont tu es l'ami) -> OK ; machine hors claim -> refus dans un claim. Ne marche que pour les actions qui passent par les événements NeoForge avec un FakePlayer. Les perceuses/scies Create, les contraptions en mouvement et les pistons ne passent pas par là : ils peuvent casser/déplacer des blocs d'un claim voisin.
  • Propagation du feu : pas bloquée (pas d'événement NeoForge simple). Allumer est bloqué. Conseil : gamerule doFireTick false.
  • Lave/eau qui coule d'un chunk voisin, flèches/projectiles sur les cadres, dispensers : non bloqués.

Build (sur cornafserver, pas sur le PC)

Copier le dossier puis sh build-sur-cornafserver.sh (conteneur eclipse-temurin:21-jdk jetable, cache Gradle dans ~/.cache/gastinelclaims-gradle). Lance les tests JUnit puis produit build/libs/gastinelclaims-neoforge-1.21.1-<version>.jar (version dans gradle.properties et META-INF/neoforge.mods.toml, à changer ensemble). Le ménage du 13/10/2026 a supprimé l'image eclipse-temurin:21-jdk et le cache Gradle : le premier build suivant les retélécharge (environ 4 min au lieu de 15 s).

Riptide (depuis 1.1.3, temporaire : à déplacer dans GastinelGarde)

mixin/RiptideMoveMixin.java + core/RiptideTolerance.java (tests RiptideToleranceTest). Corrige les retours en arrière quand on enchaîne les riptides.

  • Contrôle vanilla « moved too quickly » (ServerGamePacketListenerImpl.handleMovePlayer) : les seuils 100.0f (marche) et 300.0f (élytres) passent à 100 blocs par paquet (10 000 au carré) quand le joueur tient un trident Impulsion dans une main ou est en vrille, et pendant 40 ticks (2 s) après. Chaque constante n'apparaît qu'une fois dans la méthode (vérifié par javap sur NeoForge 21.1.234).
  • On ne se fie pas seulement à isAutoSpinAttack() : le serveur ne lance la vrille que s'il juge le joueur sous la pluie ou dans l'eau (biome, altitude), alors que le client la lance quand même (journaux du 13/10 : vrille=false).
  • Contrôle anti-vol (allow-flight=false) : getMaximumFlyingTicks passe de 80 à 200 ticks (10 s) pendant ces 2 s, pour ne pas expulser un joueur qui plane sur son élan.
  • Journal : [GastinelClaims] riptide : seuil relevé… au niveau DEBUG (logs/debug.log).
  • Limite assumée : un joueur qui tient un trident Impulsion peut aller jusqu'à 100 blocs par paquet sans être renvoyé en arrière.

Historique

Version Date Contenu
1.1.6 13/10/2026 seuil riptide 60 → 100 blocs (sauts de 63 et 66 blocs encore refusés)
1.1.5 13/10/2026 seuil élytres (300) aussi relevé ; délai anti-vol après un riptide ; allow-flight remis à false sur le serveur
1.1.4 13/10/2026 riptide détecté par le trident Impulsion en main (la vrille n'est pas toujours connue du serveur)
1.1.3 13/10/2026 RiptideMoveMixin (seuil 60 blocs pendant la vrille)
1.1.2 13/10/2026 /friend : profils Microsoft du cache ignorés en mode hors-ligne
1.1.1 11/10/2026 pseudos avec caractère non tapable, ambiguïté annoncée
1.1.0 09/10/2026 zones protégées (spawn incassable)

Zones protégées (depuis 1.1.0) — spawn incassable

Module séparé de /claim (fichiers ZonesProtegees.java, ZoneEvents.java, mixin/, core/ZonesConfig.java). Une zone se cumule avec les claims et passe avant eux (priorité HIGHEST) ; /claim n'est pas modifié.

Config : config/gastinelclaims-zones.json (créé au premier démarrage depuis src/main/resources/gastinelclaims/zones-defaut.json). Liste zones : nom, dimension, coin1/coin2 (deux coins opposés [x, y, z], bornes incluses, dans n'importe quel ordre), active (facultatif). Zone livrée : spawn, overworld, x 3284..3320, y 185..204, z -615..-566 (le spawn du monde 3300 189 -586 est dedans, vérifié dans level.dat et au démarrage : ligne Spawn du monde … dans la zone protégée « spawn »). Ajouter une zone : éditer le fichier puis /zoneprotegee recharger. niveau_op_ignore (2) : les ops de ce niveau ne sont pas concernés (les machines / FakePlayer le sont toujours). interactions_autorisees : blocs qu'un joueur peut encore utiliser au clic droit (ids ou tags #…), sans jamais utiliser l'objet en main. Par défaut : boutons, plaques de pression, portes/trappes en bois, portillons, levier, établi, coffre de l'Ender, table d'enchantement. Mettre [] pour tout interdire (marcher sur une plaque de pression reste toujours possible).

Commandes (op 2) : /zoneprotegee liste, /zoneprotegee ici, /zoneprotegee recharger.

Bloqué dans une zone (joueurs non-op, machines) : casser, poser (toute entité : joueur, enderman, machine), outils qui modifient un bloc (écorcer, aplanir, labourer), clic droit sur tout bloc non autorisé (coffres, fours, tonneaux, pupitres, pots…), seaux / briquet / boule de feu visant la zone ou utilisés dedans, piétinement des cultures, frapper ou modifier cadres / tableaux / supports d'armure. Bloqué pour le monde : explosions (TNT, creeper, lit, ancre, wither…) ne détruisent aucun bloc ni décor de la zone ; liquides venus de l'extérieur n'y entrent pas (mixin FlowingFluid.canSpreadTo ; une fontaine posée dedans par un op coule normalement) ; lave+eau ne crée pas de pierre/obsidienne dedans ; feu : ne brûle aucun bloc de la zone et ne s'y propage pas (mixin FireBlock.checkBurnOut / getIgniteOdds) ; pistons (poussée, traction, destruction) touchant la zone ; wither / dragon / ravageur (LivingDestroyBlockEvent) ; « mobGriefing » (enderman, zombie et portes, lapins, moutons…) à moins de 4 blocs de la zone.

Testé le 09/10/2026 sur une copie du monde (serveur jetable, tous les mods du serveur dont Lithium et Create) : TNT dedans/dehors, eau en canal (s'arrête à x=3320), feu (planches dehors brûlées, dedans intactes), pistons vers la zone et témoin hors zone, chargement de la config et vérification du spawn. Non testé en jeu (pas de client) : casse/pose/seau/clic par un vrai joueur, enderman/wither (monde en peaceful).

Limites : les contraptions Create en mouvement (piston mécanique, roulement, chariot) et les perceuses/scies Create qui ne passent pas par un FakePlayer ne sont pas garanties ; les projectiles (flèches sur un cadre) et les dispensers ne sont pas bloqués ; la foudre peut allumer un feu (qui ne brûlera rien dans la zone).