コマンド/whitelist

whitelist

必要権限レベル	3 ‌^[JE限定] 4 ‌^[BE限定]
実行制限	コマンドブロックでの実行不可専用サーバー限定チートのみ‌^[BE限定]

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

ホワイトリストが有効化された状態でも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 off`	ターゲットセレクターに対応するプレイヤーが一人も発見できない
`/whitelist add <targets>`	指定されたプレイヤーが全てすでにホワイトリストに載っている
`/whitelist remove <targets>`	指定されたプレイヤーが一人もホワイトリストに載っていなかい
任意	成功時

出力[]

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

歴史[]

Java Edition Beta
1.3		`/whitelist`が追加された。
Bedrock Edition
1.16.0	release	`/whitelist`が追加された。
1.17.0	beta 1.16.230.50	`/allowlist`に改名された。
1.17.0	release	名称が`/whitelist`に差し戻された。
1.18.10	release	`/allowlist`に改めて改名された。

コマンド