48 lignes
3.0 KiB
Markdown
48 lignes
3.0 KiB
Markdown
# 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
|
|
```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-<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.
|