Fichiers
gastinel-tpa/README.md
T

28 lignes
4.5 KiB
Markdown
Brut Annotations Historique

Ce fichier contient des caractères Unicode ambigus.
Ce fichier contient des caractères Unicode qui peuvent être confondus avec d'autres caractères. Si vous pensez que c'est intentionnel, vous pouvez ignorer cet avertissement. Utilisez le bouton Échappe pour les dévoiler.
# 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`.