この項目はJava Edition限定の要素です。
以下のコマンドはサーバーのブラックリスト(BANリスト)を管理することができる。ブラックリストとは、サーバーへの接続を許可しないプレイヤーおよびIPアドレスの一覧である。BANされたプレイヤーはホワイトリストに登録されていてもサーバーに接続することができない。
ban[]
プレイヤーをブラックリストに追加する。
構文[]
ban <対象> [理由]
引数[]
<対象>
:ゲームプロファイル
- ブラックリストに追加するプレイヤーのプロファイルを指定する。
- ゲームプロファイル(プレイヤープロファイル)の集合によって指定する。これにはプレイヤー名(サーバーがオンラインの場合は実在する名前である必要がある)やプレイヤーのターゲットセレクターなどを用いることができる。
<理由>
:メッセージ
- BANの理由を説明するメッセージ。BANされたプレイヤーおよび他の管理者、サーバーのログに表示される。指定しない場合は、
このサーバーへのアクセスは禁止されています
と表示される。 - プレーンテキストである必要がある。スペースやターゲットセレクターを含めることができる。 ゲームはテキスト内のセレクターを選択されたエンティティの名前の一覧に置き換える。エンティティが2体の場合では "name1 and name2"と、n体の場合では"name1, name2, ... and namen" となる。
結果[]
コマンド | トリガー | Java Edition |
---|---|---|
任意 | 引数が正しく指定されていない | 構文解析不能 |
ターゲットセレクターが1人も候補を見つけられなかった | 失敗 | |
実行したコマンドによってブラックリストに誰も追加されなかった | ||
成功時 | プレイヤーのプロファイルがサーバーのブラックリストに追加され、これらのプロファイルを持つプレイヤーはそのサーバーへのアクセスができなくなる。 |
出力[]
コマンド | エディション | 状況 | 成功回数 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
任意 | Java Edition | 失敗時 | N/A | 0 | 0 |
成功時 | N/A | 1 | 新規にブラックリストに追加されたプレイヤーの数 |
ban-ip[]
IPアドレスをブラックリストに追加する。
構文[]
ban-ip <対象> [<理由>]
引数[]
<対象>
:文字列
- ブラックリストに追加するIPアドレスを指定する。プレイヤーの名前を指定することもでき、この場合は対応するIPアドレスがブラックリストに追加される。
- 文字列を指定する。また、文字列は単一の単語使用可能文字:
-
,+
,.
,_
、A
-Z
、a
-z
、0
-9
)で指定する(空白を含んではならない)。
<理由>
:メッセージ
- BANの理由を説明するメッセージ。BANされたプレイヤーおよび他の管理者、サーバーのログに表示される。指定しない場合は、
このサーバーへのアクセスは禁止されています
と表示される。 - プレーンテキストである必要がある。スペースやターゲットセレクターを含めることができる。 ゲームはテキスト内のセレクターを選択されたエンティティの名前の一覧に置き換える。エンティティが2体の場合では "name1 and name2"と、n体の場合では"name1, name2, ... and namen" となる。
結果[]
コマンド | トリガー | Java Edition |
---|---|---|
任意 | 引数が正しく指定されていない | 構文解析不能 |
ターゲットセレクターが1人も候補を見つけられなかった | 失敗 | |
ブラックリストにIPアドレスが1つも追加されなかった。 | 失敗 | |
成功時 | 指定したIPアドレス、および指定した名前のプレイヤーのIPアドレスがサーバーのブラックリストに追加され、これらのプロファイルを持つプレイヤーはそのサーバーへのアクセスができなくなる。 |
出力[]
コマンド | エディション | 状況 | 成功回数 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
任意 | Java Edition | 失敗時 | N/A | 0 | 0 |
成功時 | N/A | 1 | 指定したIPアドレスでサーバーに接続していたプレイヤーの数。 |
banlist[]
サーバーのブラックリストを表示する。
構文[]
banlist [ips|players]
引数[]
[ips|players]
:ブラックリストを、IPアドレスで表示するかプレイヤーで表示するかを選択する。
結果[]
常に成功し、BANされたIPアドレスおよびプレイヤーのリストが表示される。
歴史[]
Java Edition Classic | |||||
---|---|---|---|---|---|
0.0.16a | /ban と/banip が追加された。 | ||||
Java Edition Indev | |||||
0.31 | すべてのコマンドが削除された。 | ||||
Java Edition Alpha | |||||
v1.0.16 | /ban が復活した。
| ||||
/ban-ip と/banlist が復活した。 |