はじめに

Minecraftのworldを別のサーバに移行したときに、「え、playerdataがない･･･！」ってなったかつ調べてもあんまり情報がでてこなかったので備忘録🤓
（友達みんなと今更マイクラにハマっているのであった･･･）

Minecraft Serverの基本情報

まずマイクラフトのデータ移行にあたって理解しておくべき、ディレクトリ構成やファイルの内容( ..)φメモメモ

環境構成

Ubuntu 22.04.3 LTS
Java版 ver 1.20.4

Minecraft Serverのディレクトリ構成

↓がサーバーのディレクトリ構成
他にもいろいろファイルはあるけど、移行で使ったところだけ記載

- /opt/minecraft_server/    
    - logs
        - yyyy-mm-dd-x.log.gz
        - ...
    - server.properties
    - usercache.json
    - world/
        - playerdata/
        - xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx.dat
        - ...

各ファイルの解説

logs : クライアントが接続失敗したときとかに見るログ
server.properties: マイクラサーバーの難易度・Seed値とかの設定ファイル
usercache.json: playerのUUIDが書いてあるファイル
world: マイクラのワールドデータ
playerdata：各プレイヤーの装備・インベントリ・最後に切断した位置を保持しているファイル

↑このへんは調べたら、いろんなサイトで出てくる！！📚

worldの移行でやったこと

移行元のworldをローカル環境にダウンロード
worldをzip圧縮
WinSCPでローカル → 移行先サーバの/opt/minecraft_server/にworld.zipを転送
転送したzipファイル解凍

なんかちょっと前にこういう仕事してた気がするな･･･と複雑な気持ちと懐かしさを感じながら作業😂

移行で詰まったところ

よっしゃワールドのデータは移行したぞー！いざ、接続～！！...と思ったら色々問題発生💣

問題①： Connection Refused でワールドに接続できない
問題②：ワールド接続後、装備やらアイテムやらが何もない

問題①： Connection Refused でワールドに接続できない

まずは、そもそもワールドに接続できない問題である。
なんでよ～😿

原因

色々見てみたらworldフォルダの所有者が違うために、ファイルの読み書き・実行できていないことがわかった。

解決方法

world/*の所有者をminecraftにする

コマンド

chown -R minecraft:minecraft ./world/*

実際にやったこと

まずは/opt/minecraft_server/logsの最新ファイルを見てみた。
（ちなみにgzipで圧縮されているので gunzip yyyy-mm-dd-x.log.gz で解凍）

なんかエラーでてる

[Server console handler/ERROR]: Exception handling console input
java.io.IOException: Input/output error

もしかして･･･！と思って ls -l /opt/minecraft_server/でフォルダの所有者の情報をみてみた

-rw-r--r-- 1 minecraft minecraft 1234 Dec 16 02:06 server.properties
drwxr-xr-x 12 user user 1234 Dec 16 16:38 world

おーやっぱり、所有者他のファイルと違う！となったので、所有者をminecraftに変更

コマンド

chown -R minecraft:minecraft ./world/

接続してみる･･･
ワールド接続成功！！！やったー！これで始められるぞー！！

....と思ったら、次の問題が発生。

問題②：ワールド接続後、装備やらアイテムやらが何もない

座標 0 にリスポーンするし、装備も持ち物も何にもないじゃん😤どうして～～

原因

移行元のサーバと移行先のサーバでユーザーの識別子が異なるため、playerdataが復元できていない。

解決方法

移行元のplayerdata（datファイル）を移行先のdatファイルに上書きする

playerdata/

cp {移行元サーバのUUID}.dat {移行先サーバのUUID}.dat

実際にやったこと

色々調べてみて、各プレイヤーのデータは、/opt/minecraft_server/world/playerdataに格納されていることがわかった。

playerdata配下には、こんな感じでdatファイルが複数ある。
そしてどうやらdatファイルのファイル名は、{プレイヤーのUUID}.datになっているらしい。

00000000-0000-0000-0000-00000000000.dat
00000000-0000-0000-0000-00000000000.dat_old
11111111-1111-1111-1111-111111111111.dat
11111111-1111-1111-1111-111111111111.dat_old

UUIDはどこで調べられるかというとusercache.json に記載されていることがわかった。
↓こんな感じで書いてある

usercache.json

[
   {
      "name":"player1",
      "uuid":"00000000-0000-0000-0000-000000000000",
      "expiresOn":"2024-01-16 15:43:09 +0900"
   },
   {
      "name":"player2",
      "uuid":"11111111-1111-1111-1111-111111111111",
      "expiresOn":"2024-01-16 15:34:45 +0900"
   },
   { ... }
]

ここで移行元サーバの自分のUUIDを調べてみた

{
"name":"player1",
"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
...
}

ほーん、移行先サーバの自分のUUID と移行元サーバのUUIDが違うからユーザーデータが復元されないのね🤔

そこで、playerdataを{移行元サーバの自分のUUID}.dat→{移行先サーバの自分のUUID}.datに上書きしてみる。

command

cp xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dat 00000000-0000-0000-0000-000000000000.dat

データの上書きに成功したら、ワールドに接続してみる。

元の装備とアイテムが復活し、最後にマイクラを切断した位置でリスポーンした！！！やったー！建築するぞー！
というわけで、worldとplayerdataの移行が完了✨

まとめ

趣味のゲームとはいえ、色々調べたりサーバで試行錯誤したので記事にしてみました📝
worldとplayerdataは別で移行するというのがわかったので、これからいくらでもマイクラのデータ移行ができるぞ！

playerdataの移行方法は、ググっても「これだ！」っていう情報があんまりなかったので、誰かの役に立つといいな💁‍♀️🍣

参考文献