【PR】本記事にはプロモーション（広告）が含まれます。広告リンク経由でお申し込みがあった場合、当サイトが報酬を受け取ることがあります。検証結果や評価の内容は広告の有無で変えていません。詳しくは広告表記をご覧ください。
マイクラサーバーに「You are not white-listed」で入れないときの対処：ホワイトリストの挙動を実機で確認
自分で立てたマイクラのサーバーに友だちが入ろうとすると「You are not white-listed on this server!」と表示されて入れない――という場合の原因と対処です。当サイトの検証機で、実際に何が起きるかを確かめました。
まず確認：26.3 ではホワイトリストが初期値で有効
26.3 の server.jar が作った初期の server.properties では、white-list=true になっていました（当サイトの実機で確認。server.properties の解説記事）。サーバーを立てただけでは、誰も入れない状態です。
実際の挙動（当サイトの検証）
検証は 26.1 のサーバーで、オフラインモードの自動クライアント（mineflayer）を使って行いました（mineflayer が 26.3 に対応していないため）。待ち受けは 127.0.0.1 だけです。
| 手順 | 結果（実際のログ） |
|---|---|
| ① ホワイトリストが空の状態で接続 | Disconnecting haisaba_bot1 ...: You are not white-listed on this server! |
| ② whitelist.json を手で書き換えて、reload せずに接続 | また同じメッセージで切断された |
③ whitelist reload を実行してから接続 |
Reloaded the whitelist → haisaba_bot1 joined the game（入れた） |
| ④ リストにない別の名前で接続 | 切断された |
⑤ whitelist off にしてから接続 |
Whitelist is now turned off → 入れた |
ポイントは②です。whitelist.json をファイルで直接書き換えたときは、whitelist reload を実行するまで反映されませんでした。
対処の手順
- サーバーのコンソールで追加する:
whitelist add <プレイヤー名>- ※当サイトでは、このコマンドは試していません。名前からプレイヤーを調べるために外部と通信する可能性があり、検証は外部と通信しない条件で行っているためです。
- 追加されたかを確認する:
whitelist listを実行すると、There are 1 whitelisted player(s): ...のように表示されます（実機で確認）。 - ファイルを直接書き換えた場合は、
whitelist reloadを実行します（実機で確認）。 - 名前のつづりを確認します。リストにない名前は、別人として扱われて切断されました（④）。
- ホワイトリストを使わない場合は
whitelist offにします。ただし、そうすると接続できる人なら誰でも入れるようになります。外に公開しているサーバーでは注意してください。
オフラインモードについての注意
当サイトの検証では、アカウントを使わずに試すために online-mode=false にしました。この状態では、名前だけでプレイヤーを判断します。外に公開するサーバーでは、online-mode=true（初期値）のまま使ってください。
関連記事: マイクラJava版サーバーの立て方（Linux）／同時接続人数の実測
参照URL
- Minecraft Java Edition サーバー（公式）: https://www.minecraft.net/en-us/download/server
- Minecraft EULA: https://aka.ms/MinecraftEULA
- mineflayer（GitHub）: https://github.com/PrismarineJS/mineflayer
- 検証の記録（当サイト内、非公開）: lab/README.md（記録 #003）、lab/runs3/whitelist/console.log