Minecraftに接続する
エディターで選んだ接続先につなぎます。初めての接続では、Minecraft内でペアリングを行います。
入力項目はありません。
対応protocol 23.2.1 · b10のブロック一覧
マイクラのブロックを、Scratchのブロックであやつる。
ブロックを置く、モブをスポーンする、音を鳴らす、イベントで動かす。
56個のScratchブロックを、画像と入力項目から探せます。
56 / 56 ブロック
一致するブロックがありません。検索語や分類を変えてみてください。
エディターで選んだ接続先につなぎます。初めての接続では、Minecraft内でペアリングを行います。
入力項目はありません。
現在のペアリングに使うコードを返します。
返す値 ペアコードの文字列
入力項目はありません。
Minecraftのチャットへ入力するペアリングコマンドを返します。
返す値 /mcremote pair で始まる文字列
入力項目はありません。
ペアリングが完了したとき、下につないだスクリプトを実行します。
入力項目はありません。
値がmc-remoteのエラーを表す文字列かどうかを調べます。「もし」と組み合わせて使えます。
返す値 はい・いいえ(真偽値)
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 調べる値 | 文字列 | ⟦mcr-error:unknown_block⟧ | — |
ブロックの設置や取得などに使う次元を選びます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 次元 | 選択肢 | オーバーワールド | オーバーワールド overworld / ネザー the_nether / エンド the_end |
建築の座標の基準を決めます。このブロックでは原点のy座標は0です。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 200 | — |
| z座標 | 数値 | 200 | — |
DEBUGで確認し、TRACEで設置の過程を見せ、FASTで高速に設置します。TRACEの待ち時間は0〜2秒です。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 建築モード | 選択肢 | DEBUG(確認) | DEBUG(確認) DEBUG / TRACE(過程) TRACE / FAST(高速) FAST |
| TRACEの待ち時間(秒) | 数値 | 0.25 | — |
connection.flushすでに送ったブロック設置の処理が終わるまで待ちます。FASTで設置した後の確認にも使えます。
入力項目はありません。
connection.flush指定した座標にブロックを置きます。右端のボタンでブロックIDと状態を選べます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| ブロックID | 文字列 | stone | — |
| ブロックの状態 | 文字列 | 空欄 | — |
world.setBlock2点で囲まれた範囲に、同じブロックと状態を設定します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 始点のx座標 | 数値 | 0 | — |
| 始点のy座標 | 数値 | 0 | — |
| 始点のz座標 | 数値 | 0 | — |
| 終点のx座標 | 数値 | 0 | — |
| 終点のy座標 | 数値 | 0 | — |
| 終点のz座標 | 数値 | 0 | — |
| ブロックID | 文字列 | stone | — |
| ブロックの状態 | 文字列 | 空欄 | — |
world.setBlocks指定した座標のブロックIDと状態をまとめて取得します。
返す値 ブロック情報の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
world.getBlock2点で囲まれた範囲のブロック情報を取得して、指定したScratchリストへ入れます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 始点のx座標 | 数値 | 0 | — |
| 始点のy座標 | 数値 | 0 | — |
| 始点のz座標 | 数値 | 0 | — |
| 終点のx座標 | 数値 | 0 | — |
| 終点のy座標 | 数値 | 0 | — |
| 終点のz座標 | 数値 | 0 | — |
| 保存先のリスト | リスト | block list | — |
world.getBlocks指定したx・z座標で、地面の高さを取得します。
返す値 地面のy座標
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
world.getHeighty座標の上限を指定して、その高さ以下の地面を探します。
返す値 地面のy座標
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 調べる高さの上限 | 数値 | 0 | — |
world.getHeight取得したブロック情報から、ブロックIDを取り出します。
返す値 名前空間付きのブロックID
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| ブロック情報 | 文字列 | minecraft:stone | — |
取得したブロック情報から、状態をまとめて取り出します。
返す値 axis=y のような状態の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| ブロック情報 | 文字列 | minecraft:oak_log[axis=y] | — |
ブロック情報から、axisやfacingなど、指定した状態の項目を取り出します。
返す値 指定した項目の値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| ブロック情報 | 文字列 | minecraft:oak_log[axis=y] | — |
| 取り出す項目 | 文字列 | axis | — |
ブロック情報に、指定した状態の項目があるかを調べます。
返す値 はい・いいえ(真偽値)
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| ブロック情報 | 文字列 | minecraft:oak_log[axis=y] | — |
| 取り出す項目 | 文字列 | axis | — |
取得済みカタログのブロックID・エンティティID・パーティクルIDを、選んだScratchリストへ入れます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 種類 | 選択肢 | ブロックID | ブロックID block / エンティティID entity / パーティクルID particle |
| 保存先のリスト | リスト | catalog list | — |
看板の両面の文字や装飾などをまとめて取得します。
返す値 看板情報の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
world.getSign看板の正面または背面の4行を、まとめて書き換えます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 看板の面 | 選択肢 | 正面 | 正面 front / 背面 back |
| 1行目 | 文字列 | 空欄 | — |
| 2行目 | 文字列 | 空欄 | — |
| 3行目 | 文字列 | 空欄 | — |
| 4行目 | 文字列 | 空欄 | — |
world.setSign看板の面と行を選び、その行の文字を書き換えます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 看板の面 | 選択肢 | 正面 | 正面 front / 背面 back |
| 行 | 選択肢 | 1行目 | 1行目 0 / 2行目 1 / 3行目 2 / 4行目 3 |
| 文字 | 文字列 | 空欄 | — |
world.updateSignLine取得した看板情報から、面と行を選んで文字を取り出します。
返す値 その行の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 看板情報 | 文字列 | 空欄 | — |
| 看板の面 | 選択肢 | 正面 | 正面 front / 背面 back |
| 行 | 選択肢 | 1行目 | 1行目 0 / 2行目 1 / 3行目 2 / 4行目 3 |
取得した看板情報から、指定した面・行の文字色を取り出します。
返す値 色を表す文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 看板情報 | 文字列 | 空欄 | — |
| 看板の面 | 選択肢 | 正面 | 正面 front / 背面 back |
| 行 | 選択肢 | 1行目 | 1行目 0 / 2行目 1 / 3行目 2 / 4行目 3 |
取得した看板情報から、太字などの装飾があるかを調べます。
返す値 はい・いいえ(真偽値)
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 看板情報 | 文字列 | 空欄 | — |
| 看板の面 | 選択肢 | 正面 | 正面 front / 背面 back |
| 行 | 選択肢 | 1行目 | 1行目 0 / 2行目 1 / 3行目 2 / 4行目 3 |
| 文字の装飾 | 選択肢 | 太字 | 太字 bold / 斜体 italic / ランダム obfuscated / 取り消し線 strikethrough / 下線 underlined |
取得した看板情報から、看板がワックスで保護されているかを調べます。
返す値 はい・いいえ(真偽値)
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 看板情報 | 文字列 | 空欄 | — |
接続したプレイヤーの向きを、方向ベクトルのx・y・z成分として取得します。
返す値 選んだ成分の数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 向きの成分 | 選択肢 | x | x x / y y / z z |
player.getDirectionx・y・zの方向ベクトルで、接続したプレイヤーの向きを設定します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
player.setDirection接続したプレイヤーの次元・座標・水平方向・上下方向を取得します。
返す値 選んだ項目の文字列または数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 取り出す項目 | 選択肢 | 次元 | 次元 dimension / x座標 x / y座標 y / z座標 z / 水平方向 yaw / 上下方向 pitch |
次元と座標を指定して、接続したプレイヤーを移動します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 次元 | 選択肢 | オーバーワールド | オーバーワールド overworld / ネザー the_nether / エンド the_end |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
player.setPos次元・座標・水平方向・上下方向を指定して、接続したプレイヤーを移動します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 次元 | 選択肢 | オーバーワールド | オーバーワールド overworld / ネザー the_nether / エンド the_end |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 水平方向 | 数値 | 0 | — |
| 上下方向 | 数値 | 0 | — |
player.setPoseプレイヤーが今いる次元で、指定した座標へ移動します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
エンティティを生成し、後から操作するためのハンドルをScratch変数へ入れます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティID | 文字列 | minecraft:allay | — |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 保存先の変数 | 変数 | entity handle | — |
world.spawnEntity指定した中心と半径でエンティティを探し、情報をScratchリストへ入れます。プレイヤーは含みません。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 半径 | 数値 | 10 | — |
| 最大件数 | 数値 | 16 | — |
| 保存先のリスト | リスト | entity list | — |
world.getNearbyEntities近くのエンティティのリストから取り出した情報を渡し、ハンドル・種類・座標を読みます。
返す値 選んだ項目の文字列または数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティ情報 | 文字列 | 空欄 | — |
| 取り出す項目 | 選択肢 | ハンドル | ハンドル handle / 種類 type / x x / y y / z z |
ハンドルで指定したエンティティの位置・次元・向きをまとめて取得します。
返す値 位置と向きの情報の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティのハンドル | 文字列 | mcr_eh_... | — |
entity.getPose取得したエンティティの位置と向きの情報から、次元・座標・角度を取り出します。
返す値 選んだ項目の文字列または数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 位置・向きの情報 | 文字列 | 空欄 | — |
| 取り出す項目 | 選択肢 | x座標 | 次元 dimension / x座標 x / y座標 y / z座標 z / 水平方向 yaw / 上下方向 pitch |
ハンドルで指定したエンティティを移動し、水平方向と上下方向の角度を設定します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティのハンドル | 文字列 | mcr_eh_... | — |
| 次元 | 選択肢 | オーバーワールド | オーバーワールド overworld / ネザー the_nether / エンド the_end |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 水平方向 | 数値 | 0 | — |
| 上下方向 | 数値 | 0 | — |
entity.setPoseハンドルで指定したエンティティを削除します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティのハンドル | 文字列 | mcr_eh_... | — |
entity.removeハンドルで指定したエンティティの向きを、方向ベクトルの成分として取得します。
返す値 選んだ成分の数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティのハンドル | 文字列 | mcr_eh_... | — |
| 向きの成分 | 選択肢 | x | x x / y y / z z |
entity.getDirectionハンドルで指定したエンティティの向きを、方向ベクトルで設定します。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| エンティティのハンドル | 文字列 | mcr_eh_... | — |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
entity.setDirection座標・ずれ・速さ・個数を指定してパーティクルを表示します。IDの代わりに、表示先や色などを組み立てた設定も入力できます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| パーティクルID・設定 | 文字列 | minecraft:flame | — |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| x方向のずれ | 数値 | 0 | — |
| y方向のずれ | 数値 | 0 | — |
| z方向のずれ | 数値 | 0 | — |
| 速さ | 数値 | 0 | — |
| 個数 | 数値 | 1 | — |
| 表示範囲 | 選択肢 | 遠くにも表示 | 遠くにも表示 true / 近くだけ表示 false |
world.spawnParticleパーティクルIDと表示先を組み合わせた設定を作ります。この値を「パーティクルを表示する」へ渡します。
返す値 パーティクルの設定の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 表示先・再生先 | 選択肢 | 近くのプレイヤー | 近くのプレイヤー world / 接続したプレイヤーだけ self |
| パーティクルID・設定 | 文字列 | minecraft:flame | — |
ダストの表示先・RGBの色・大きさを組み合わせた設定を作ります。
返す値 ダストの設定の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 表示先・再生先 | 選択肢 | 近くのプレイヤー | 近くのプレイヤー world / 接続したプレイヤーだけ self |
| 赤 | 数値 | 255 | — |
| 緑 | 数値 | 0 | — |
| 青 | 数値 | 0 | — |
| 大きさ | 数値 | 1 | — |
ブロックIDと状態を使い、そのブロックの見た目のパーティクル設定を作ります。
返す値 ブロックのパーティクル設定の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 表示先・再生先 | 選択肢 | 近くのプレイヤー | 近くのプレイヤー world / 接続したプレイヤーだけ self |
| ブロックID | 文字列 | minecraft:stone | — |
| ブロックの状態 | 文字列 | 空欄 | — |
サウンドIDを指定し、建築原点からの座標で音を鳴らします。音量・高さ・再生先は「音の設定」で選べます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| サウンドID | 文字列 | entity.experience_orb.pickup | — |
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 音の設定 | 文字列 | 空欄 | — |
world.playSound指定した場所のブロックから、設置・たたく・破壊・足音・着地の音を選んで鳴らします。ブロック自体は変更しません。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
| 種類 | 選択肢 | 設置 | 設置 place / たたく hit / 破壊 break / 足音 step / 着地 fall |
| 音の設定 | 文字列 | 空欄 | — |
world.playBlockSound音を鳴らすブロックの「設定」に差し込む値を作ります。
返す値 音の設定の文字列
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 音量 | 文字列 | 空欄 | — |
| 音の高さ | 文字列 | 空欄 | — |
| 表示先・再生先 | 選択肢 | 近くのプレイヤー | 近くのプレイヤー world / 接続したプレイヤーだけ self |
指定した座標に雷を落とします。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| x座標 | 数値 | 0 | — |
| y座標 | 数値 | 0 | — |
| z座標 | 数値 | 0 | — |
world.strikeLightningMinecraftのチャットへメッセージを送ります。文字列や変数を入力できます。
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| メッセージ | 文字列 | Hello, Minecraft! | — |
chat.postツルハシでブロックをつつくイベントを受信したとき、下のスクリプトを実行します。
入力項目はありません。
events.pollチャット投稿のイベントを受信したとき、下のスクリプトを実行します。
入力項目はありません。
events.poll飛び道具が当たるイベントを受信したとき、下のスクリプトを実行します。
入力項目はありません。
events.poll実行中のMinecraftイベントから、座標・メッセージ・対象などの情報を取り出します。イベントブロックの下で使います。
返す値 選んだ項目の値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 取り出す項目 | 選択肢 | 通し番号 | 通し番号 sequence / イベントの種類 type / 次元 dimension / x座標 x / y座標 y / z座標 z / 原点x origin_x / 原点y origin_y / 原点z origin_z / 面 face / 手 hand / アイテム item / メッセージ message / ブロック情報 block / 飛び道具 projectile / 対象の種類 target_kind / 対象のx座標 target_x / 対象のy座標 target_y / 対象のz座標 target_z / 対象の面 target_face / 対象のブロック情報 target_block / 対象のエンティティハンドル target_handle |
イベント受信のカーソルや欠落数などを読みます。
返す値 選んだ受信状況の数値
| 入力 | 種類 | 最初の値 | 選択肢 |
|---|---|---|---|
| 取り出す項目 | 選択肢 | カーソル | カーソル cursor / 最新の通し番号 latest / 保持範囲外の欠落数 overflow / 容量超過の欠落数 capacity / 明示破棄数 discarded / 欠落合計 total_loss |
ブロックを組み合わせる
「音の設定」を、音を鳴らすブロックの「設定」に差し込みます。この例は音量0.5、音階N12です。
「ブロック情報」を「のブロックID」に差し込みます。取得した情報を変数に保存してから、IDや状態を取り出すこともできます。
パーティクルの設定など、長くなる組み合わせは変数に入れて使うと、スクリプトを短くできます。
各ブロックの「リンク」を開くと、そのブロックへ直接移動するURLになります。リンクを右クリックしてアドレスをコピーするか、開いた後のURLを共有してください。
「最初の値」は、パレットから取り出した直後に入力されている値です。実行時に省略した場合の既定値とは区別しています。
「返す値」は正常に取得できたときの内容です。エラーを表す文字列が返った場合は「取得した値がエラーか調べる」で確認できます。命令の失敗は、エディターのお知らせとWireScopeで確認します。
座標の基準や詳しい通信仕様は、各ブロックの「通信API」リンクから確認できます。