前提
Minecraft 統合版のユーザー名
Minecraft 統合版では、Microsoft アカウントの Xbox ゲーマータグ がプレイヤー名として利用されます。
このゲーマータグはホワイトリストにも登録される「ユーザー名」に相当し、各プレイヤーを識別する一意の文字列です。
一方、Java 版は Mojang アカウント由来の独自ユーザー名を使用しており、仕様が異なります。
参加者には、Microsoft アカウントにログインした状態で https://www.xbox.com/play/user
にアクセスしてもらうと、自分の Xbox ゲーマータグを確認できます。
（サンプルです）
この例では、「GamerTag」というユーザー名に、ランダムに付与されたサフィックス「#1234」が付いています。
同じ名前を使用しているユーザーがいない場合はサフィックスは付かず、重複する場合のみ、通常ランダムな4桁の数字が追加されます。これはユーザー自身が指定できません。
Minecraft 統合版では、「#」を省いた「GamerTag1234」が実際のユーザー名として使用されます。サフィックスがない場合は、「#」以降は存在しません。
XServer Games の Minecraft ホワイトリスト機能
XServer Games のコントロールパネルにログインし、「ホワイトリスト設定」を有効にした状態で、ホワイトリストにプレイヤーを追加できる状態になります。
XServer ゲームパネルから半角スペースを含むユーザー名をホワイトリストに追加する
Minecraft統合版サーバーで、ホワイトリストに追加したいユーザー名が「Sato Taro4567」のように半角スペースを含む場合、次のようなエラーが表示されます。
プレイヤー名を正しく入力してください
これは、XServer Games が Java 版を基準に設計されているため、Java 版のユーザー名仕様（スペースを含められない）に抵触していることが原因と考えられます。
| Java 版 | 統合版 (Bedrock) | |
|---|---|---|
| Minecraft のユーザ名に使用できる文字 | 半角英数字、アンダースコア(_) のみ | 半角英数字、スペース |
この場合は、まず一度 「SatoTaro4567」（スペースなし）で追加してください。
これでエラーなく登録が可能です。
XServer ゲームパネルのメニューから「ファイルマネージャー」を開きます。
minecraft フォルダをダブルクリックして開きます。
一覧から allowlist.json を選択し、「編集」をクリックします。
ブラウザ上にテキストエディタが開きます。
ここで Ctrl + F を押して検索ボックスを開きましょう。
先ほど追加したユーザー名「SatoTaro4567」で検索し、該当箇所をハイライトします。
その部分のユーザー名を、本来の正しい名前（Sato Taro4567）に修正します。
修正後、「更新」ボタンを押して保存します。
ゲームパネルの「ホワイトリスト設定」に戻ると、半角スペースを含む名前が正しく反映されていることが確認できます。
ログインして確認してもらいましょう。
コンソールで半角スペースを含むユーザー名をホワイトリストに追加する
ホワイトリストに追加したいユーザ名が「Sato Taro4567」の場合、コンソールでは "" （ダブルクォーテーション）でユーザ名を囲う必要があります。
/allowlist add "Sato Taro4567"