Fichiers
gastinel-tpa/README.md
T

Brut Annotations Historique

GastinelTpa

Téléportations pour NeoForge 1.21.1 (21.1.234). Mod côté serveur uniquement.

Commandes

  • /tpa <joueur>, /tpahere <joueur>, /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 : <monde>/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

<monde>/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 <copie-du-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.