
これはJava版・統合版の“プレイヤー識別ID”を整理するための記事です
Java版ではUUID、統合版ではゲーマータグやXUIDを扱う場面が多いです
サーバー管理・データ移行・ホワイトリスト設定で迷った方向けに解説します
こんにちは。ゆずかきです。
マイクラでサーバー設定やプレイヤーデータの移行をしていると、急にUUIDという言葉が出てくることがあります。
「プレイヤー名じゃダメなの?」とか、「統合版でもUUIDってあるの?」とか、最初はかなり分かりにくいですよね。
筆者も最初にplayerdataフォルダを見た時、英数字の長いファイル名がズラッと並んでいて、正直かなり戸惑いました。
でも仕組みを理解すると、これはプレイヤー名よりも大事な“本人確認用の番号”だと分かります。
この記事を読めば、次のことが分かるようになります。
- UUIDとは何かが分かります👍
- プレイヤー名との違いが分かります👌
- Java版でUUIDを確認する方法が分かります
- 統合版で見るべきゲーマータグ・XUIDの考え方も分かります
- サーバー移行やホワイトリスト設定で失敗しにくくなります(^^♪
それでは、やっていきましょう!
※本記事では、Java版1.21.9以降と統合版のBedrock Dedicated Serverを前提に、一般的なサーバー運用で使う範囲を中心に解説します。
※UUIDやXUIDまわりはサーバー環境・プラグイン・クロスプレイ構成によって扱いが変わる場合があります。
目次
1. UUIDとは
2. UUIDとプレイヤー名の違い
3. UUIDが必要になる場面
4. Java版でUUIDを確認する方法
5. 統合版ではUUIDよりゲーマータグ・XUIDを確認する
6. UUIDの見た目と読み方
7. プレイヤー名を変更するとUUIDはどうなる?
8. サーバー移行・データ復旧での注意点
9. よくある勘違いとQ&A
10. まとめ
11. 参考文献
この記事で分かること
・マイクラのUUIDの意味
・Java版と統合版での違い
・サーバー管理でUUIDを確認する方法
1. UUIDとは
UUIDとは、プレイヤーやエンティティなどを識別するための固有IDです。
正式にはUniversally Unique Identifierの略で、マイクラでは128bitの識別番号として扱われます。
見た目は、こんな感じです。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
英数字がたくさん並んでいて、初見だと「何これ?」となりますよね。
でも役割はかなりシンプルです。
プレイヤー名が“表示名”なら、UUIDは“その人本人を見分ける番号”です。
例えば、プレイヤー名は後から変更できます。
でも、サーバー側がプレイヤー名だけでデータを管理していると、名前変更のたびに持ち物・実績・権限・BAN情報などがズレる危険があります。
そこで使われるのがUUIDです。
サーバーはプレイヤー名ではなく、基本的にUUIDを見て同じプレイヤーかどうかを判断します。
👇イメージとしては、下の表のような違いです。
| 項目 | 役割 | 変更される? |
|---|---|---|
| プレイヤー名 | ゲーム内に表示される名前 | 変更できる |
| UUID | アカウントを識別する固有ID | 基本的に変わらない |
| ゲーマータグ | 統合版で表示されるXbox/Microsoft側の名前 | 変更できる |
| XUID | 統合版サーバーで使われるXbox側の識別ID | 基本的に変わらない |
つまり、UUIDは「この人はこの人です」とサーバーが判断するための、かなり重要な情報です。
ただし、パスワードやメールアドレスではありません。
サーバーログや管理ファイルに出てくることもある、管理用の識別子だと思っていただければ大丈夫です。
2. UUIDとプレイヤー名の違い
UUIDとプレイヤー名の一番大きな違いは、変更できるかどうかです。
Java版のプレイヤー名は、Minecraft公式サイトのプロフィールから変更できます。
ただし、何度でも即変更できるわけではなく、変更できるのは30日に1回です。
一方で、UUIDはプレイヤー名を変えても基本的に変わりません。
そのため、サーバー側ではUUIDを使って、次のような情報を同じプレイヤーに紐づけています。
- インベントリ
- エンダーチェスト
- 座標・ゲームモードなどのプレイヤーデータ
- 実績や進捗
- ホワイトリスト
- BANリスト
- 権限プラグインのデータ
- 保護プラグインや経済プラグインのデータ
ここを理解しておくと、名前変更で慌てにくくなります。
体験談
サーバーデータを移した時、筆者は最初「プレイヤー名のファイルを探せばいい」と思っていました。
でもJava版のプレイヤーデータは、名前ではなくUUIDを基準に保存されることが多いです。
ここを知らないと、データ移行でかなり迷います。
プレイヤー名は、あくまで人間が見やすい名前です。
UUIDは、サーバーやゲーム内部が見ている本体の識別IDです。
この違いを覚えておくだけでも、マイクラサーバー管理の理解がかなり進みますよ。
3. UUIDが必要になる場面
普通にシングルプレイで遊ぶだけなら、UUIDを意識することはほとんどありません。
村を作ったり、洞窟を掘ったり、ネザーで迷子になったりしている分には、UUIDなんて知らなくても大丈夫です。
ただし、サーバー運営やデータ復旧をするなら話は別です。
UUIDは、次のような場面で急に必要になります。
サーバーのホワイトリスト管理
Java版サーバーでは、ホワイトリストやBANリストにプレイヤー名とUUIDが保存されることがあります。
名前だけで管理しているように見えても、実際の内部ではUUIDが関係しているケースが多いです。
特に、名前変更をしたプレイヤーを正しく認識させたい時は、UUIDを見た方が安全です。
プレイヤーデータの復旧
サーバーのworld/playerdataフォルダには、プレイヤーごとの.datファイルが保存されます。
このファイル名がUUIDになっているため、誰のデータなのか確認する時にUUIDが必要になります。
world/playerdata/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dat
例えば、サーバー移行後に「自分の持ち物が消えた!」となった場合、古いUUIDの.datファイルが新しい環境で読み込まれていない可能性があります。
この時にUUIDを照合できると、原因を切り分けやすいです。
権限プラグインや保護プラグインの管理
LuckPerms、WorldGuard、LWC系の保護プラグインなどを使っている場合、プレイヤー名ではなくUUIDで管理されることがあります。
これは、プレイヤーが名前を変えても権限や保護情報が崩れにくくなるためです。
サーバー運営ではありがたい仕組みですが、データを手作業で直す時はUUIDを理解していないと迷いやすいです。
データパック・コマンド制作
Java版では、エンティティやプレイヤーをUUIDで指定・確認する場面があります。
/dataコマンドでエンティティのNBTを見ると、UUIDが整数配列の形で出てくることもあります。
コマンド勢・データパック勢の方は、このあたりを見かける機会が多いと思います。
Geyser/Floodgateなどのクロスプレイ環境
Java版サーバーに統合版プレイヤーを入れる構成では、Java版のUUIDと統合版のXUIDが混ざって話に出てきます。
この場合、通常のJava版UUIDだけを見ていると混乱しやすいです。
Java版プレイヤーなのか、統合版プレイヤーなのかを先に分けて考えましょう。
ここ、本当に大事です。
4. Java版でUUIDを確認する方法
ここからは、Java版でUUIDを確認する方法を整理します。
初心者さん向けに、やりやすい順で紹介しますね。
方法1:UUID検索サイトを使う
一番簡単なのは、UUID検索サイトにプレイヤー名を入力して確認する方法です。
検索欄にJava版のプレイヤー名を入れると、UUIDが表示されます。
サーバー管理をしていない方でも使いやすいので、まずはこの方法で十分です。
ただし、外部サイトを使う場合は注意点もあります。
- Java版アカウント向けの検索か確認する
- 統合版のゲーマータグを入れても正しく出ない場合がある
- 名前変更直後は反映に時間がかかる場合がある
- サイトによって表示形式が違う場合がある
ハイフンありとハイフンなしのUUIDが表示されることがありますが、基本的には同じUUIDです。
見た目が違うだけなので、必要な形式に合わせて使ってください。
方法2:Mojang APIで確認する
少し技術寄りですが、Mojang APIを使って確認する方法もあります。
ブラウザやツールから、次の形でアクセスします。
https://api.mojang.com/users/profiles/minecraft/<プレイヤー名>
例えば、<プレイヤー名>の部分にJava版のプレイヤー名を入れると、次のような形式で結果が返ってきます。
{ "id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "name": "PlayerName" }
ここで出てくるidがUUIDです。
ただし、この形式ではハイフンが付いていません。
必要に応じて、次のように区切ります。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
APIを使う方法は正確ですが、公開APIには利用制限があり、一時的な不調で失敗することもあります。
普通に確認したいだけなら、検索サイトの方が楽です。
方法3:サーバーファイルから確認する
自分でJava版サーバーを運営している場合は、サーバーファイルからUUIDを確認できます。
見る場所は主にこのあたりです。
usercache.json whitelist.json banned-players.json ops.json world/playerdata/
usercache.jsonには、過去にサーバーへ参加したプレイヤー名とUUIDが記録されることがあります。
world/playerdata/には、プレイヤーごとのデータがUUID名の.datファイルとして入っています。
注意!
playerdataの.datファイルは、むやみに削除しないでください。
そのプレイヤーの持ち物や位置情報などが初期化される原因になります。
作業前に必ずバックアップを取りましょう。
方法4:ゲーム内コマンドで確認する
Java版で権限がある場合、コマンドでUUIDを確認できることがあります。
代表的なのは、次のコマンドです。
/data get entity @s UUID
@sは自分自身を指すターゲットセレクターです。
実行すると、UUIDが4つの整数に分かれた形で表示されます。
ただし、この表示は普段見慣れているxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx形式ではありません。
コマンドやNBTを扱う方向けの見え方なので、初心者さんは無理にここから変換しなくて大丈夫です。
Java版1.21.9以降では、/fetchprofileコマンドでプレイヤープロフィールを取得する仕組みも追加されています。
プレイヤーの頭やプロフィール情報を扱う用途では便利ですが、単純にUUIDを確認したいだけなら、検索サイトやサーバーファイル確認の方が分かりやすいです。
5. 統合版ではUUIDよりゲーマータグ・XUIDを確認する
ここ、かなり間違えやすいです。
Java版の記事を見て「UUIDを調べればいいんだな」と思って統合版で同じことをしようとすると、うまくいかないことがあります。
なぜなら、統合版ではJava版のUUIDではなく、Xbox/Microsoft側のゲーマータグやXUIDを扱う場面が多いからです。
統合版のマルチでは、プレイヤー名として表示されるものは基本的にゲーマータグです。
Bedrock Dedicated Serverでは、allowlist.jsonにゲーマータグが保存され、XUIDが入ることもあります。
統合版サーバーで見るファイル例はこちらです。
allowlist.json permissions.json server.properties
allowlist.jsonでは、次のような項目が出てきます。
[ { "ignoresPlayerLimit": false, "name": "PlayerGamertag", "xuid": "0000000000" } ]
nameがゲーマータグ、xuidがXbox側の識別IDです。
ただし、allowlist.jsonのxuidは任意項目です。最初はnameだけで登録し、該当するゲーマータグのプレイヤーが参加した時にXUIDが補完される場合もあります。
統合版でホワイトリストや権限設定をする場合は、こちらを確認することが多いです。
統合版でまず確認すること
統合版で「UUIDが分からない」となった時は、次の順番で確認してください。
- そのプレイヤーのゲーマータグは正しいか
- 空白が入るゲーマータグなら、コマンドで引用符を使っているか
- Bedrock Dedicated Serverの
allowlist.jsonに正しく入っているか xuidが必要な場面では、参加ログや管理ツールで確認できるか- Geyser/Floodgate環境なら、その環境用のUUID形式になっていないか
特に、Java版サーバーへ統合版プレイヤーを入れるGeyser/Floodgate環境では、統合版プレイヤーの名前に接頭辞が付いたり、Floodgate用のUUID形式で扱われたりします。
体験談
Java版と統合版のクロスプレイ環境では、「このUUIDは誰のもの?」となりがちです。
まずJavaプレイヤーか統合版プレイヤーかを分けて見るだけで、かなり整理しやすくなります。
統合版では、Java版UUIDの記事をそのまま当てはめない方が安全です。
統合版ならゲーマータグとXUIDを見ると覚えておきましょう。
6. UUIDの見た目と読み方
UUIDは、基本的に32個の16進数で構成されています。
一般的には、ハイフンで区切った形で表示されます。
8桁-4桁-4桁-4桁-12桁
実際の見た目はこうです。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
一方、Mojang APIなどではハイフンなしで返ってくることがあります。
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
この2つは、基本的に同じUUIDです。
違いは、見やすく区切っているかどうかだけです。
ハイフンありUUID
人間が見やすい形式です。
サーバーファイルや設定ファイルで見かけることが多いです。
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ハイフンなしUUID
APIや一部ツールで使われる形式です。
文字数は32文字です。
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Int-array形式
Java版のNBTでは、UUIDが4つの整数配列として表示されることがあります。
[I; 123456789, 123456789, 123456789, 123456789]
これはコマンドやNBT編集で見る形式です。
普通のサーバー管理だけなら、ここまで深く覚えなくても大丈夫です。
ただし、データパックやコマンドで所有者判定を作る場合は、この形式が関わることがあります。
コマンド勢の方は「UUIDには複数の表現形式がある」と覚えておくと後で助かります。
7. プレイヤー名を変更するとUUIDはどうなる?
Java版では、プレイヤー名を変更してもUUIDは基本的に変わりません。
ここがUUIDの一番大事なところです。
プレイヤー名が変わっても、サーバー側はUUIDを見て同じプレイヤーだと判断できます。
つまり、通常のオンラインモードのJava版サーバーであれば、名前変更をしても次のようなデータは引き継がれることが多いです。
- 持ち物
- エンダーチェスト
- 進捗
- OP権限
- ホワイトリスト
- BAN情報
- プラグインの権限情報
もちろん、プラグイン側が古いプレイヤー名だけで管理している場合は別です。
古いプラグインや独自設定では、名前変更で不具合が出ることもあります。
名前変更直後に起きやすいこと
名前を変更した直後は、サーバーや外部ツール側の反映に時間がかかる場合があります。
例えば、次のようなことが起きることがあります。
- 検索サイトで古い名前が表示される
- サーバーの
usercache.jsonに古い名前が残っている - プラグインの表示だけ古い名前のままになる
- 外部サイトのスキン表示が遅れて更新される
慌ててデータを消したり、.datファイルをいじったりする前に、まずは時間を置いて確認しましょう。
注意!
名前変更直後にプレイヤーデータを手作業で触るのは危険です。
原因が反映待ちなのか、UUID不一致なのか、プラグイン側の問題なのかを先に切り分けましょう。
オフラインモードのサーバーは別物です
ここも重要です。
Java版サーバーでも、online-mode=falseのサーバーでは、オンラインモードで取得されるUUIDと異なるUUIDになる場合があります。
そのため、外部のUUID検索サイトで調べたUUIDと、サーバー内のUUIDが一致しないことがあります。
この場合は、外部サイトのUUIDではなく、そのサーバー内のusercache.jsonやプレイヤーデータ側のUUIDを確認してください。
通常の公式ログイン前提のUUIDと、オフラインモードのUUIDは混ぜないようにしましょう。
8. サーバー移行・データ復旧での注意点
UUIDを意識する場面で一番トラブルが起きやすいのは、サーバー移行やデータ復旧です。
ここでは、実際に確認した方が良いポイントをまとめます。
まずバックアップを取る
これは必須です。
playerdata、usercache.json、whitelist.json、ops.json、プラグインフォルダを触る前に、必ずサーバー全体のバックアップを取りましょう。
world/ plugins/ server.properties whitelist.json banned-players.json ops.json usercache.json
このあたりは、まとめて退避しておくと安心です。
特にworld/playerdata/は、プレイヤーの持ち物や位置情報に直結します。
playerdataのUUIDを確認する
Java版のプレイヤーデータは、UUID名の.datファイルとして保存されます。
world/playerdata/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.dat
移行後に持ち物が消えたように見える場合、以下を確認してください。
- 移行前と移行後でUUIDが同じか
playerdataフォルダを正しくコピーしたか- ワールド名や読み込み先が変わっていないか
- オフラインモードからオンラインモードへ変更していないか
- プラグイン側のデータも移行したか
特に、オフラインモードとオンラインモードを切り替えた場合は、同じプレイヤー名でもUUIDが変わることがあります。
この場合、古い.datファイルが読み込まれず、新規プレイヤー扱いになることがあります。
権限プラグインは別途確認する
サーバー本体のplayerdataを移しただけでは、プラグインの権限や保護情報までは復元できないことがあります。
例えば、次のようなものです。
- LuckPermsの権限データ
- WorldGuardの保護設定
- チェスト保護系プラグインの所有者情報
- 経済プラグインの所持金データ
- ホーム地点やワープ設定
これらはpluginsフォルダ側に保存されていることが多いです。
ワールドだけを移しても復元されない場合があるので、プラグインデータも忘れずに確認しましょう。
統合版サーバーはallowlist.jsonとpermissions.jsonを見る
統合版のBedrock Dedicated Serverでは、Java版のwhitelist.jsonやops.jsonと同じ感覚で見ていると少し違います。
統合版では、主に次のファイルを確認します。
allowlist.json permissions.json server.properties
allowlist.jsonでは、ゲーマータグとXUIDが関係します。
permissions.jsonでは、オペレーターなどの権限設定にXUIDが関係することがあります。
Java版のUUID検索だけで解決しようとせず、統合版は統合版のファイルを確認してくださいね。
9. よくある勘違いとQ&A
ここでは、UUIDまわりでよくある勘違いを整理します。
トラブル時のチェック用にお使いください。
Q. UUIDは自分で変更できますか?
基本的に変更できません。
Java版の通常アカウントでは、UUIDはアカウントに紐づく識別IDです。
プレイヤー名のように自由に変更するものではありません。
Q. プレイヤー名を変更したらUUIDも変わりますか?
Java版の通常環境では、基本的に変わりません。
名前変更後も同じUUIDなので、サーバー側のデータは引き継がれることが多いです。
ただし、オフラインモードや一部の特殊なサーバー構成では、外部検索サイトのUUIDと一致しない場合があります。
Q. UUIDを人に見せても大丈夫ですか?
UUIDはパスワードではありません。
サーバーの管理ファイルやログ、外部検索サイトで確認できることもあります。
ただし、UUIDはプレイヤーを識別する情報です。
むやみに晒す必要はありませんし、サーバー管理ファイルを丸ごと公開するのは避けましょう。
Q. 統合版のUUIDが検索サイトで出ません
統合版では、Java版のUUID検索サイトでそのまま出ないことがあります。
統合版はゲーマータグやXUIDを確認する方が実用的です。
Bedrock Dedicated Serverなら、allowlist.jsonや参加ログを確認しましょう。
Geyser/Floodgateを使っている場合は、その環境用の確認方法を見る必要があります。
Q. UUID検索サイトで出るUUIDとサーバー内のUUIDが違います
まず、サーバーがオンラインモードか確認してください。
online-mode=falseのサーバーでは、通常のオンラインモードで取得されるUUIDと違うUUIDになる場合があります。
また、Geyser/Floodgateなどのクロスプレイ環境では、統合版プレイヤー用の別形式が使われることがあります。
Q. playerdataのファイルを消せばデータをリセットできますか?
できますが、かなり注意が必要です。
対象プレイヤーの持ち物、現在地、状態などが初期化される可能性があります。
削除する前に、必ずバックアップを取ってください。
分からない状態で消すのはおすすめしません。
Q. UUIDを使えばなりすまし対策になりますか?
オンラインモードのJava版サーバーでは、Minecraftの認証を通してUUIDが確認されるため、名前だけで管理するより安全です。
ただし、オフラインモードのサーバーではこの前提が崩れます。
公開サーバーを運営するなら、基本的にはonline-mode=trueで運用することをおすすめします。
10. まとめ
以上、マイクラのUUIDについて、Java版と統合版の違いも含めて解説しました。
要点を整理すると、次の通りです。
- UUIDはプレイヤーを識別するための固有ID
- Java版ではプレイヤー名を変えてもUUIDは基本的に変わらない
- サーバーのplayerdataや権限管理ではUUIDが重要
- 統合版ではUUIDよりゲーマータグ・XUIDを見る場面が多い
- オフラインモードやGeyser/Floodgate環境では扱いが変わる
- サーバーファイルを触る前には必ずバックアップを取る
UUIDは、普通に遊んでいるだけなら意識しなくても問題ありません。
でも、サーバー運営やデータ移行を始めると、かなり重要になります。
最初は英数字の羅列に見えて分かりにくいですが、役割はシンプルです。
プレイヤー名は見た目の名前、UUIDはサーバーが見ている本人確認用ID。
まずはこの理解で十分です。
Java版ならUUID、統合版ならゲーマータグとXUID。
この違いを覚えておくと、ホワイトリスト設定やデータ復旧で迷いにくくなります。
では、本日はここまでで終わります。
最後までご覧いただき、ありがとうございました。
柚子クラでは他にもサーバー設定や便利装置の解説をしているので、是非ご覧くださいね(^^♪
11. 参考文献
参考にした公式ドキュメント・コミュニティWikiです。
- Minecraft Wiki(Universally unique identifier)
- Minecraft Wiki(Commands/data)
- Minecraft Wiki(Java Edition level format)
- Minecraft Help(View or Change Your In-Game Profile Name)
- Microsoft Learn(Getting Started with Bedrock Dedicated Server)
- Microsoft Learn(Bedrock Dedicated Server Properties)
- wiki.vg(Mojang API)
- Minecraft公式(Java Edition 1.21.9)
- GeyserMC Wiki(Floodgate FAQ)
- GeyserMC Wiki(Utility endpoint to get either a Java UUID or a Bedrock xuid)