Fichiers
2026-10-11 01:57:24 +02:00

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 <uuid>.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

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-<date>/ (+ 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.