【マイクラ】UUIDとは?確認方法・プレイヤー名との違いを解説【Java/統合版】

これは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.jsonxuidは任意項目です。最初は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を意識する場面で一番トラブルが起きやすいのは、サーバー移行やデータ復旧です。
ここでは、実際に確認した方が良いポイントをまとめます。

まずバックアップを取る

これは必須です。

playerdatausercache.jsonwhitelist.jsonops.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.jsonops.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です。