コマンド/whitelist

/whitelist

必要権限レベル	3 ‌[JE限定] 4 ‌[BE限定]
実行制限	専用サーバー限定 チートのみ‌[BE限定]

{
    "title": "<code>/whitelist</code>",
    "rows": [
        {
            "field": "\n* 3 ‌<sup class=\"nowrap \" title=\"\">[<i><span title=\"この内容は、Java Editionにのみ適用されます。\">(link to Java Edition article, displayed as JE)限定</span></i>]</sup>\n* 4 ‌<sup class=\"nowrap \" title=\"\">[<i><span title=\"この内容は、Bedrock Editionにのみ適用されます。\">(link to Bedrock Edition article, displayed as BE)限定</span></i>]</sup>",
            "label": "(link to 権限レベル article, displayed as 必要権限レベル)"
        },
        {
            "field": "専用サーバー限定<br>(link to 設定 article, displayed as チート)のみ‌<sup class=\"nowrap \" title=\"\">[<i><span title=\"この内容は、Bedrock Editionにのみ適用されます。\">(link to Bedrock Edition article, displayed as BE)限定</span></i>]</sup>",
            "label": "(link to コマンド#実行制限 article, displayed as 実行制限)"
        }
    ],
    "invimages": [],
    "images": []
}

サーバーのホワイトリストを操作することができる。ホワイトリストを有効にすると、そのリストに含まれているプレイヤーのみがそのサーバーに参加できるようになる。

ホワイトリストが有効化された状態でもJava Editionでは、サーバーの管理者だけはホワイトリストに含まれていなくても常にサーバーに接続できる。一方Bedrock Editionでは、管理者権限の有無に関わらずプレイヤーがサーバーに参加するにはホワイトリストに載っていることが必要である。ホワイトリストに載っているプレイヤーのプロファイルはwhitelist.json（allowlist.json‌^[BE限定]）ファイルに記録されており、手動で変更することもできる。

Bedrock Editionでは1.18.10においてこのコマンドは/allowlistに改名されたが、こちらのコマンドも依然として使用でき、保存ファイルも移行時には削除されずに複製される。

構文

whitelist add <targets>（Java Edition）

allowlist add <name: string>（Bedrock Edition）

プレイヤーのプロファイルをホワイトリストに追加する。対象のプレイヤーが現在オンラインでなくてもよい。

whitelist list（Java Edition）

allowlist list（Bedrock Edition）

ホワイトリスト上のすべてのプレイヤープロファイルを表示する。

whitelist off（Java Edition）

allowlist off（Bedrock Edition）

サーバーのホワイトリストを無効化する。

whitelist on（Java Edition）

allowlist on（Bedrock Edition）

サーバーのホワイトリストを有効化する。

whitelist reload（Java Edition）

allowlist reload（Bedrock Edition）

記憶媒体からwhitelist.jsonを再読み込みする（手動でwhitelist.jsonを書き換えた際に有用）。

whitelist remove <targets>（Java Edition）

allowlist remove <name: string>（Bedrock Edition）

プレイヤーのプロファイルをホワイトリストから削除する。対象のプレイヤーが現在オンラインでなくてもよい。

引数

JE: <targets>：ゲームプロファイル

ホワイトリストに追加・削除するプレイヤーのプロファイルを指定する。

ゲームプロファイル（プレイヤープロファイル）でなければならない。これにはプレイヤー名（サーバーがオンラインの場合は実在の名前のみ可）やプレイヤー用のターゲットセレクターなどを用いることができる。

BE: name: string：basic_string

ホワイトリストに追加・削除するプレイヤー名を指定する。

文字列で指定する文字列はスペースを含まない単一の単語か引用符で囲まれた文字列でなければならない。

結果

コマンド	条件	Java Edition
任意	引数が正しく指定されていない	構文解析不能
/whitelist on	すでにホワイトリストが有効である	失敗
/whitelist off	すでにホワイトリストが無効である
	ターゲットセレクターに対応するプレイヤーが一人も発見できない
/whitelist add <targets>	指定されたプレイヤーが全てすでにホワイトリストに載っている
/whitelist remove <targets>	指定されたプレイヤーが一人もホワイトリストに載っていなかい
任意	それ以外	成功

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	失敗時	なし	0	0
/whitelist on /whitelist off /whitelist reload		成功時	なし	1	1
/whitelist list		成功時	なし	1	リストに乗っているプレイヤーの人数
/whitelist add <targets>		成功時	なし	1	新規にリストに追加されたプレイヤープロファイルの数
/whitelist remove <targets>		成功時	なし	1	リストから削除されたプレイヤープロファイルの数

歴史

Java Edition Beta
1.3							/whitelistが追加された。 {"type": "java Beta", "version": "1.3", "exp": "", "snap": "", "content": "<!-- Command --><code >/whitelist</code><!-- /Command -->が追加された。"}
Bedrock Edition
1.16.0			release				/whitelistが追加された。 {"type": "bedrock", "version": "1.16.0", "exp": "", "snap": "release", "content": "<!-- Command --><code >/whitelist</code><!-- /Command -->が追加された。"}
1.17.0			beta 1.16.230.50				/allowlistに改名された。 {"type": "bedrock", "version": "1.17.0", "exp": "", "snap": "beta 1.16.230.50", "content": "<!-- Command --><code >/allowlist</code><!-- /Command -->に改名された。"}
release				名称が/whitelistに差し戻された。 {"type": "bedrock", "version": "1.17.0", "exp": "", "snap": "release", "content": "名称が<!-- Command --><code >/whitelist</code><!-- /Command -->に差し戻された。"}
1.18.10			release				/allowlistに改めて改名された。 {"type": "bedrock", "version": "1.18.10", "exp": "", "snap": "release", "content": "<!-- Command --><code >/allowlist</code><!-- /Command -->に改めて改名された。"}