# Migration d'UUID (totoche10) Script : `migrer-uuid.py` (Python 3 stdlib, NBT lu/écrit à la main) + `retour.sh`. Sur le serveur : `~/staging/migration-uuid/` (copie de test dans `copie/`, marquée par le fichier `COPIE-MIGRATION`). | UUID | Origine | |---|---| | `25b71084-eb1b-4988-8cfe-458026f7e514` | Microsoft (online-mode=true, données jusqu'au 09/10 21:20) | | `e1769fd1-91f1-377b-b2ac-999a4a7c9c9e` | hors-ligne `OfflinePlayer:totoche10` (données depuis le 09/10) | ## Quand l'utiliser **Uniquement** au moment de repasser en `online-mode=true` (ou l'inverse), **serveur ARRÊTÉ**, **avec le feu vert de Théo**. Ne jamais lancer `--appliquer` serveur en marche : le serveur réécrirait playerdata/claims à l'arrêt. ## Ce qui est traité ops.json, whitelist.json, usercache.json, usernamecache.json, banned-players.json (doublons retirés), `neW512/gastineltpa-homes.json`, tous les `neW512/data/*.dat` contenant l'UUID (dont `gastinelclaims.dat` : 18 `owner` = 17 claims + 1 liste d'amis), `playerdata/*.dat|.dat_old`, `advancements`, `stats`, `skinrestorer`. UUID reconnus sous forme int[4], chaîne, clé de compound et paires `…Most/…Least`. Non traité : régions `.mca` (entités apprivoisées/propriétaires dans le monde), autres mods (gravestone, etc.). ## Playerdata - `--garder les-deux` (défaut) : l'inventaire de l'UUID **source** gagne ; l'ancien fichier de l'UUID cible et le fichier source sont conservés en `.dat.avant-migration`. - `--garder source` : idem (la source gagne). - `--garder cible` : l'inventaire déjà présent sous l'UUID d'arrivée gagne (ex. en `--vers-microsoft`, l'ancien inventaire Microsoft du 09/10 plutôt que le récent hors-ligne). ## Commandes ```bash cd ~/staging/migration-uuid D=~/server-infra/stacks/minecraft-neoforge/data python3 migrer-uuid.py --dossier "$D" --vers-microsoft # À BLANC (défaut) : n'écrit rien, OK serveur en marche # le jour J, serveur arrêté + feu vert : python3 migrer-uuid.py --dossier "$D" --vers-microsoft --appliquer --serveur-arrete-confirme bash retour.sh "$D" "$D/sauvegarde-migration-AAAAMMJJ-HHMMSS" # retour arrière ``` `--appliquer` refuse si `docker ps` montre `minecraft-neoforge` (ou si docker ne répond pas), et refuse un dossier qui n'est pas une copie sans `--serveur-arrete-confirme`. Sauvegarde préalable dans `sauvegarde-migration-/` (+ `MANIFESTE.json` utilisé par `retour.sh`). ## PIÈGE : l'ami à pseudo spécial La liste d'amis de totoche10 contient `e65f2350-…` = `OfflinePlayer:gabybou201` (sans guillemet). Or le joueur se connecte réellement en `gabybou201"` (avec guillemet) → UUID hors-ligne `128c0f10-9643-37ff-941d-afa49cdb30ec` (usercache du 10/10 00:28). **L'amitié actuelle ne vise donc pas le compte réellement utilisé.** Le script ne touche pas aux UUID des amis. En repassant en online-mode, gabybou aura un 3ᵉ UUID (Microsoft, inconnu ici) : il faudra refaire `/friend add` une fois qu'il s'est connecté, ou ajouter un mappage dédié après vérification.