【マイクラ統合版】/testforblocks（テストフォーブックス）コマンドの使い方！2つの範囲のブロックが一致するか検知する方法と違い

マイクラ統合版（スイッチ・スマホ・PS5・PC）・教育版限定の/testforblocksコマンドの解説です。このコマンドを使用すると、ワールド内の「ソース領域（お手本）」として指定した広い範囲と、もう一方の「チェック対象領域」として指定した広い範囲のブロックの並びが、完全に一致しているか、または空気ブロックを除いて一致しているかをテスト・検知することができます。コマンドブロックとレッドストーン回路を組み合わせることで、「プレイヤーが正しい建築パズルを完成させたか判定する」「複雑な自動仕分けシステムが正常に動作しているか確認する」といった、配布ワールドやミニゲームの高度な正解判定ギミックを構築する上で欠かせないセンサーコマンドです。

❓ ここが違う！testfor・testforblock・testforblocksの違い

マイクラには「何かをテストする」コマンドが3種類ありますが、「何を検査対象にするか」で明确に使い分けます！

• /testforblocks（当ページ）：「広い範囲のブロックの並び（直方体）」が、お手本と完全に一致しているかを一括検査します。
（例：建築パズルの形が正解と同じか？）
• /testforblock：指定した「特定の1マスにあるブロック」の種類やデータ値を検査します。
（例：座標(X, Y, Z)にあるのは金ブロックか？）
• /testfor：プレイヤーやモブなどの「エンティティの存在や数」を数えます。
（例：この半径5マス以内にプレイヤーが入ってきたか？）

/testforblocks（広い範囲のブロック並び判定）統合版限定

/testforblocks ~-5 ~-2 ~-5 ~5 ~2 ~5 100 64 -200

【実行例】コマンドの実行場所（またはコマンドブロック）を中心に「横幅11マス×高さ5マス×奥行き11マス」のソース領域と、座標(100, 64, -200)を起点としたチェック対象領域のブロックが完全に一致しているかを検査します。

⚙️ /testforblocks コマンドの構文（書き方）

統合版の `/testforblocks` コマンドの書き方は、3組の座標とオプションの判定モードをスペースで区切って並べる構造です。非常に多くの座標を指定するため、チルダ（~）による相対表記を活用しましょう。

/testforblocks <begin: x y z> <end: x y z> <destination: x y z> [masked|all]

💡 各引数の詳しい意味と設定ルール

引数名	記述ルール・値の例	詳しい効果と役割（説明）
<begin> と <end> (ソース領域)	~-5 ~ ~-5 ~5 ~5 ~5	必須項目です。「ソース領域（お手本）」として調べる範囲の、対向する2つの角の座標を指定します。チルダ表記も使用可能です。統合版での有効範囲は、X・Z座標が-30000000〜30000000、Y座標（高さ）はワールドの上限・下限の範囲内である必要があります。領域のブロック数は524,288を超えてはならないという制限があります。
destination: x y z (チェック対象領域起点)	100 64 -200 ~ ~5 ~	必須項目です。「チェック対象領域（プレイヤー側など）」の「北西の下隅（各軸の最小座標）」となる座標を1マスの地点で指定します。チルダ表記も使用可能です。ソース領域と同じサイズ・形で自動的に領域がスキャンされます。ソース領域と重なってはなりません。
[masked\|all] (判定モード)	省略 / all masked	省略可能です。・`all`（省略時）：空気ブロックを含めたすべてのブロックが完全に一致しなければ失敗。・`masked`：ソース領域にある空気ブロックの部分は、チェック対象領域がどんなブロックでも一致とみなす判定モードです。

🛠️ コピペで使える！実践コマンド実例集

コマンドブロック（リピート設定）にそのまま貼り付けてすぐに活用できる、ゲーム内パズル判定用の実例です。リピートコマンドブロックのすぐ隣に「レッドストーンコンパレーター」を繋いで判定を回路へ出力してください。

実例1：3x3x3のお手本の形と、プレイヤーが建てた形が「空気ブロックも含めて完全に一致しているか」を検査する（建築パズル）

/testforblocks 10 64 10 12 66 12 100 64 -200

座標 (10, 64, 10) 〜 (12, 66, 12) にある3x3x3のお手本エリアと、座標(100, 64, -200)の北西下隅としたチェックエリアを一括検査します。末尾を省略（allモード）しているため、空気ブロックの位置も完全に同じでなければ成功になりません。完璧な形を要求するパズルに最適です。

実例2：お手本の形の中にある「空気ブロック」の部分は無視して、それ以外のブロックだけ一致しているか検査する（自由建築パズル）

/testforblocks 10 64 10 12 66 12 100 64 -200 masked

末尾の判定モードを `masked` にしたパターンです。お手本エリアにある空気ブロックは「どんなブロックでもよい」とみなされるため、プレイヤーが建てた形の中にお手本と同じ位置にブロックがあれば、他の場所が埋まっていても成功判定になります。特定のブロックの配置だけを狙ったパズルに便利です。

🛑 コマンドが失敗する・上手く動作しない時のチェックポイント

「ソース領域とチェック対象領域が一致しません」でエラーになる：これは仕様通りの正しい挙動です。`/testforblocks` は、指定した条件に合うブロック並びが完全に一致しているか、または空気ブロックを除いて一致しているかをテスト・検知します。2つの領域が一致していれば、一致したブロック数を返し、チャット欄に「ブロック数がで見つかりました」と成功ログが返ると同時に、コンパレーターからレッドストーン信号がパッと出力されます。
「引数が正しくない」でエラーになる：存在しない座標やブロックIDを指定した場合に発生するエラーです。チルダ表記の構文や大カッコ内の条件指定の記述ルールに違反した場合は構文解析不能エラーになります。