SetBlock メソッド

コントリビューター : Takunology

作成日 : 2024/09/21

更新日 : 2024/09/21

概要

指定した座標に任意のブロックを設置します.

引数

戻り値

コマンドの実行結果が返って来ます.

コマンドの実行に成功した場合：

Changed the block at 0, -60, -3

コマンドの実行に失敗した場合：

Could not set the block

すでに同じブロックが設置されているか, 設置が禁止されている座標へ設置を試みようとした場合に失敗します.

使い方

ブロックを設置したい座標（絶対座標）と, そのブロックIDを引数に代入して使用します.

using MinecraftConnection;

// 座標 (-1, -60, -2) に石ブロックを配置します
MinecraftCommands commands = new MinecraftCommands("127.0.0.1", 25575, "minecraft");
commands.SetBlock(-1, -60, -2, "stone");

実行すると石ブロックが配置されます.

また, 反復処理を組み合わせることでブロックを複数配置させることができます.

for(int i = 0; i < 10; i++)
{
    for (int j = 0; j < 10; j++)
    {
        commands.SetBlock(-1, -60, -2 + i, "blue_concrete");
    }
}

実行すると青色のコンクリートが平面上に10×10の範囲で配置されます.

配置したブロックを削除（空気ブロック）に置き換える場合は air を使います.

for(int i = 0; i < 10; i++)
{
    for (int j = 0; j < 10; j++)
    {
        commands.SetBlock(-1 + j, -60, -2 + i, "air");
    }
}

これを実行すると平面に設置した青色のコンクリートをそのまま削除することができます.

よくある疑問

Q. ブロックの向きを変えられますか？

ブロックの向きを変更する場合は, ブロックIDの後に [facing=] を使用して方向を指定する必要があります. 例えば, ジャックオーランタンのブロックを使用して記述すると下記のようになります.

// 何も指定しない場合は北 (north) の方角に向きます
commands.SetBlock(-1, -60, -2, "jack_o_lantern");

// 南 (south) の方角を向かせる場合は [facing] をつけます
commands.SetBlock(-1, -60, -2, "jack_o_lantern[facing=south]");

Q. ドアやハーブブロックの上半分側にうまく置けません

例えば, ドアの場合は2ブロック分の高さがありますが, IDは同じです. その上部分 (upper) と下部分 (lower) とで区別するために, half を使用します. このとき, 座標に注意してください.

// ドアの下半分
commands.SetBlock(-1, -60, -2, "birch_door[half=lower]");
// ドアの上半分（2ブロックの高さなので座標に注意）
commands.SetBlock(-1, -59, -2, "birch_door[half=upper]");

ハーブブロックの場合は [type=] を使用します. 同様に上半分（top）と下半分 (bottom) で指定します.

// ハーフブロックの上半分側
commands.SetBlock(-1, -60, -2, "oak_slab[type=top]");
// ハーフブロックの下半分側
commands.SetBlock(-1, -60, -3, "oak_slab[type=bottom]");

Q. ブロックIDがわかりません

マイクラWiki のブロックIDリストを参照してください.