# GastinelTpa Téléportations pour NeoForge 1.21.1 (21.1.234). **Mod côté serveur uniquement.** ## Commandes - `/tpa `, `/tpahere `, `/tpaccept [joueur]`, `/tpadeny [joueur]` : demandes entre joueurs (expiration 1 min). - **Pseudos spéciaux (depuis 1.2.1)** : `/tpa gabybou201` vise le joueur en ligne `gabybou201"` (pseudo exact d'abord, puis forme normalisée : minuscules, hors `[A-Za-z0-9_]` retiré). Plusieurs comptes correspondent -> refus avec la liste des candidats. Tab et boutons [Accepter]/[Refuser] utilisent la forme sans guillemet. Logique pure : `core/PseudoMatcher.java`. - `/spawn` : téléporte au point de spawn du monde (lu dans le monde via `getSharedSpawnPos()`, celui de `/setworldspawn`, aucune coordonnée en dur). Délai 3 s annulé si le joueur bouge ou est blessé, recharge 60 s. - `/rtp` : endroit aléatoire dans la zone **déjà générée**, jamais de nouveau chunk. Délai 3 s (annulable), recharge 300 s. Atterrissage sûr : sol solide, pas d'eau (ni profonde à côté), pas de lave/feu/magma/cactus/baies/neige poudreuse/stalactite/rose du wither autour, pas de falaise > 3 blocs, pas sur les feuilles. Évite les claims GastinelClaims des autres (par réflexion, sans dépendance). - `/rtp spawn [joueurs]` : **blocs de commande uniquement** (plaque de pression de l'entrée) ; joueur ou console -> refus avec un message clair. Sans argument : le joueur le plus proche du bloc (4 blocs). Choisit un « beau spot » de `beaux-spots.json` parmi les N meilleurs, tirage pondéré par le score (repli sur la zone /rtp si fichier absent). - `/rtp diagnostic [spawn]` (op 2) : cherche un point comme /rtp sans téléporter personne et affiche les motifs de rejet. `/rtp recharger` (op 2) : relit `beaux-spots.json`. - `/tpacancel [joueur]` : annule la dernière demande /tpa ou /tpahere envoyée (ou celle vers ce joueur) ; la cible est prévenue. - `/sethome [nom]`, `/home [nom]`, `/delhome [nom]`, `/homes` : 3 homes par joueur (`homes.maximum`). Nom = lettres sans accent, chiffres, tiret (16 max, insensible à la casse) ; sans nom, premier libre parmi 1, 2, 3. Refusé dans un chunk claimé par un autre (ami autorisé), dans une zone protégée de GastinelClaims (spawn) et hors Overworld/Nether/End. `/home` : même délai que /spawn, annulé si on bouge ou est blessé ; l'arrivée est vérifiée (pas de bloc plein, lave, feu, vide). Fichier : `/gastineltpa-homes.json` (écriture atomique). - Protection après /rtp et /rtp spawn : `rtp.protectionSecondes` (15), invulnérable sauf vide et /kill, arrêtée si le joueur attaque (`rtp.protectionFinSiAttaque`). - Message de mort privé « Tu es mort en X Y Z (Overworld). » (cliquable : copie les coordonnées), envoyé à la réapparition. ## Comment /rtp évite toute génération Un point n'est examiné que si le chunk **et ses 8 voisins** sont déjà chargés, ou présents sur le disque avec le statut `minecraft:full` (lecture asynchrone du NBT). Fichier région absent -> pas lu du tout (sinon Minecraft crée un `r.X.Z.mca` vide). Charger un chunk dont un voisin manque créerait un proto-chunk voisin pour l'éclairage, d'où la règle des voisins. Vérifié sur une copie du monde : 115 925 chunks avant/après, aucun fichier créé. ## Config `/serverconfig/gastineltpa-server.toml` (rechargé à chaud) : délais, recharges, `essais` (100), zone `zoneXMin/XMax/ZMin/ZMax` (-512..6831 × -5632..1167, étendue mesurée le 09/10/2026 : 89 397 chunks complets, beaucoup d'océan), disque optionnel `zoneCentreX/Z` + `zoneRayon` (0 = rectangle seul), `rtpSpawn.topN` (60), `fichierSpots` (`config/gastineltpa/beaux-spots.json`). ## Beaux spots (notation v0) `outils/beaux_spots.py` (+ `nbt_anvil.py`, `beaux-spots-config.json`) : lit une **copie** des fichiers région (jamais le monde en service), note chaque chunk complet (relief, vue, eau 5-30 %, végétation, variété/rareté des biomes, Terralith, sûreté ; pénalités océan profond, désert plat, danger), garde 300 spots espacés d'au moins 96 blocs, score 0-10. Lancer sur cornafserver : `nice -n 19 python3 -I beaux_spots.py --monde --config beaux-spots-config.json --sortie beaux-spots.json` (82 s pour 89 397 chunks). Limite : les scores saturent près de 10 en tête (42 spots ≥ 9,5), le tirage pondéré du top 60 est donc presque uniforme. ## Build (sur cornafserver) `sh envoyer-et-compiler.sh` depuis le PC, ou `sh build-sur-cornafserver.sh` sur le serveur (JDK 21 jetable, `nice`, 4 Go max). Tests JUnit (`core/`) puis `build/libs/gastineltpa-neoforge-1.21.1-1.2.1.jar`.