# 範囲のブロックを置き換える（blocks.replace）

> 指定された領域内の特定の種類のすべてのブロックを、新しい種類のブロックに入れ替えます。

- カテゴリ：ブロック（blocks）
- ブロック：次のブロックに置き換える 草ブロック 置きかえるブロック 草ブロック 置きかえの範囲の始まり ~0 ~0 ~0 置きかえの範囲の終わり ~0 ~0 ~0
- URL：https://makecode.minecraft-okinawa.com/reference/blocks/replace/
- 公式データ取得日：2026-11-13
- 動作確認：確認待ち

## JavaScript

```javascript
blocks.replace(
    GRASS,
    GRASS,
    pos(0, 0, 0),
    pos(0, 0, 0)
)
```

## Python

```python
blocks.replace(GRASS, GRASS, pos(0, 0, 0), pos(0, 0, 0))
```

## 引数

| 名前 | 値 | 意味 |
|---|---|---|
| newblock | ブロック・アイテムの種類 | 既存のブロックと入れ替える新しいブロックの種類 |
| oldblock | ブロック・アイテムの種類 | 新しいブロックの種類と入れ替えるブロックの種類 |
| from | 座標 | 立方体領域の最初の角 |
| to | 座標 | 立方体領域の対角線上にある角 |

## 使用例

### プレーヤーの周りにある石炭鉱石を輝くダイアモンド鉱石と置き換える

```javascript
player.onTravelled(TravelMethod.Walk, () => {
    blocks.replace(
        DIAMOND_ORE,
        COAL_ORE,
        pos(-2, -2, -2),
        pos(2, 2, 2)
    );
});
```

```python
def on_travelled_walk():
    blocks.replace(DIAMOND_ORE, COAL_ORE, pos(-2, -2, -2), pos(2, 2, 2))
player.on_travelled(WALK, on_travelled_walk)
```

## 出典

- [MakeCode for Minecraft 公式リファレンス（blocks.replace）](https://minecraft.makecode.com/reference/blocks/replace)

執筆：鈴木孝昌（現役プロジェクトマネージャー／マイクラカップ指導者）／運営：沖縄マイクラ部 プログラミングスクール「クロスウェーブ」（https://minecraft-okinawa.com/）