Fichiers
gastinel-claims/README.md
T
Theo GastineletClaude Sonnet 5.5 4fff64919e GastinelClaims 1.1.0 : zones protégées (spawn incassable)
Zones configurables (config/gastinelclaims-zones.json, /zoneprotegee liste|ici|recharger),
zone « spawn » x 3284..3320 y 185..204 z -615..-566. Non-ops : ni casse, ni pose, ni seau/briquet,
interactions limitées à une liste. Explosions, pistons, mobs, liquides venus de l'extérieur et feu
(mixins FlowingFluid/FireBlock) n'y modifient rien. /claim inchangé.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-09 20:34:38 +02:00

43 lignes
5.6 KiB
Markdown

# 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.
## 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-1.1.0.jar`.
## 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).