コマンド/ban

以下のコマンドはサーバーのブラックリスト（BANリスト）を管理することができる。ブラックリストとは、サーバーへの接続を許可しないプレイヤーおよびIPアドレスの一覧である。BANされたプレイヤーはホワイトリストに登録されていてもサーバーに接続することができない。

ban

/ban

必要権限レベル	3
実行制限	専用サーバー限定

{
    "title": "<code>/ban</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to 権限レベル article, displayed as 必要権限レベル)"
        },
        {
            "field": "専用サーバー限定<br>",
            "label": "(link to コマンド#実行制限 article, displayed as 実行制限)"
        }
    ],
    "invimages": [],
    "images": []
}

プレイヤーをブラックリストに追加する。

構文

ban <対象> [理由]

引数

<対象>：ゲームプロファイル

ブラックリストに追加するプレイヤーのプロファイルを指定する。

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

<理由>：メッセージ

BANの理由を説明するメッセージ。BANされたプレイヤーおよび他の管理者、サーバーのログに表示される。指定しない場合は、このサーバーへのアクセスは禁止されていますと表示される。

貪欲な文字列（コマンドの残りの部分全てをこの文字列引数と見なす）として扱われる。スペースやターゲットセレクターを含めることができ、ターゲットセレクターは対応するエンティティの名前に置き換えて送信される。対応するエンティティが複数の場合は、, で区切って並べられる。

結果

コマンド	条件	Java Edition
任意	引数が正しく指定されていない	構文解析不能
	ターゲットセレクターが1人も候補を見つけられなかった	失敗
	実行したコマンドによってブラックリストに誰も追加されなかった
	それ以外	成功

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	失敗時	なし	0	0
		成功時	なし	1	新規にブラックリストに追加されたプレイヤーの数

ban-ip

/ban-ip

必要権限レベル	3
実行制限	専用サーバー限定

{
    "title": "<code>/ban-ip</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to 権限レベル article, displayed as 必要権限レベル)"
        },
        {
            "field": "専用サーバー限定<br>",
            "label": "(link to コマンド#実行制限 article, displayed as 実行制限)"
        }
    ],
    "invimages": [],
    "images": []
}

IPアドレスをブラックリストに追加する。

構文

ban-ip <対象> [<理由>]

引数

<対象>：文字列

ブラックリストに追加するIPアドレスを指定する。プレイヤーの名前を指定することもでき、この場合は対応するIPアドレスがブラックリストに追加される。

文字列で指定するが、一単語（＝空白を含まない）でなければならない（使用可能文字：-, +, ., _、A-Z、a-z、0-9）。

<理由>：メッセージ

BANの理由を説明するメッセージ。BANされたプレイヤーおよび他の管理者、サーバーのログに表示される。指定しない場合は、このサーバーへのアクセスは禁止されていますと表示される。

貪欲な文字列（コマンドの残りの部分全てをこの文字列引数と見なす）として扱われる。スペースやターゲットセレクターを含めることができ、ターゲットセレクターは対応するエンティティの名前に置き換えて送信される。対応するエンティティが複数の場合は、, で区切って並べられる。

結果

コマンド	条件	Java Edition
任意	引数が正しく指定されていない	構文解析不能
	ターゲットセレクターが1人も候補を見つけられなかった	失敗
	ブラックリストにIPアドレスが1つも追加されなかった。	失敗
	それ以外	成功

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	失敗時	なし	0	0
		成功時	なし	1	指定したIPアドレスでサーバーに接続していたプレイヤーの数。

banlist

/banlist

必要権限レベル	3
実行制限	専用サーバー限定

{
    "title": "<code>/banlist</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to 権限レベル article, displayed as 必要権限レベル)"
        },
        {
            "field": "専用サーバー限定<br>",
            "label": "(link to コマンド#実行制限 article, displayed as 実行制限)"
        }
    ],
    "invimages": [],
    "images": []
}

サーバーのブラックリストを表示する。

構文

banlist [ips|players]

引数

[ips|players]：ブラックリストを、IPアドレスで表示するかプレイヤーで表示するかを選択する。

結果

コマンド	条件	Java Edition
任意	コマンドの構文が正しくない。	構文解析不能
	それ以外	成功

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	成功時	なし	1	表示したリストの項目数。

banip

/banip

必要権限レベル	不明
実行制限	なし

{
    "title": "<code>/banip</code>",
    "rows": [
        {
            "field": "不明",
            "label": "(link to 権限レベル article, displayed as 必要権限レベル)"
        },
        {
            "field": "なし",
            "label": "(link to コマンド#実行制限 article, displayed as 実行制限)"
        }
    ],
    "invimages": [],
    "images": []
}

IPアドレスをブラックリストに追加する。ゲーム内で取り消すことはできず、手動でbanned-ip.txtファイルを変更する必要がある。

現在の/ban-ipに対応する。

構文

banip (<address>|<name>) [<reason>]

歴史

Java Edition Classic
0.0.16a							/banと/banipが追加された。 {"type": "java Classic", "version": "0.0.16a", "exp": "", "snap": "", "content": "<!-- Command --><code >/ban</code><!-- /Command -->と<!-- Command --><code >/banip</code><!-- /Command -->が追加された。"}
Java Edition Indev
0.31							すべてのコマンドが削除された。 {"type": "java Indev", "version": "0.31", "exp": "", "snap": "", "content": "すべてのコマンドが削除された。"}
Java Edition Alpha
v1.0.16							/banが復活した。 {"type": "java Alpha", "version": "v1.0.16", "exp": "", "snap": "", "content": "<!-- Command --><code >/ban</code><!-- /Command -->が復活した。"}
							/ban-ipと/banlistが復活した。 {"type": "java Alpha", "version": "v1.0.16", "exp": "", "snap": "", "content": "<!-- Command --><code >/ban-ip</code><!-- /Command -->と<!-- Command --><code >/banlist</code><!-- /Command -->が復活した。"}

関連項目

• コマンド/pardon
• コマンド/whitelist