Fichiers
gastinel-tpa/README.md
T
Theo GastineletClaude Sonnet 5.5 53cfd9f02f GastinelTpa 1.1.0 : /spawn, /rtp, /rtp spawn (blocs de commande), notation des beaux spots
- /spawn : spawn du monde (getSharedSpawnPos), délai annulé si mouvement/blessure, recharge.
- /rtp : zone déjà générée uniquement (chunk + 8 voisins complets sur disque, région absente
  jamais lue), atterrissage sûr, évite les claims GastinelClaims, recharge, messages FR.
- /rtp spawn : réservé aux blocs de commande, tirage pondéré parmi le top N de beaux-spots.json.
- /rtp diagnostic (op) : recherche sans téléportation, avec motifs de rejet.
- outils/beaux_spots.py : notation de beauté v0 sur une copie du monde.

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

23 lignes
3.2 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).
- `/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`.
## 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.1.0.jar`.