# 指定したブロックだけをコピーする（blocks.cloneFiltered）

> 領域内のブロックが特定の種類のブロックと一致する場合にのみ、立方体領域を別の場所に複製します。

- カテゴリ：ブロック（blocks）
- ブロック：指定したブロックだけをコピーする コピー元の範囲の始まり~0 ~0 ~0 コピー元の範囲の終わり~0 ~0 ~0 コピー先の場所~0 ~0 ~0 次のブロックだけコピーする 草ブロック モード通常
- URL：https://makecode.minecraft-okinawa.com/reference/blocks/clone-filtered/
- Pythonでの名前：blocks.clone_filtered
- 公式データ取得日：2026-11-13
- 動作確認：確認待ち

## JavaScript

```javascript
blocks.cloneFiltered(
    pos(0, 0, 0),
    pos(0, 0, 0),
    pos(0, 0, 0),
    GRASS,
    CloneMode.Normal
)
```

## Python

```python
blocks.clone_filtered(pos(0, 0, 0),
    pos(0, 0, 0),
    pos(0, 0, 0),
    GRASS,
    CloneMode.NORMAL)
```

## 引数

| 名前 | 値 | 意味 |
|---|---|---|
| begin | 座標 | 立方体領域の最初の角 |
| end | 座標 | 立方体領域の対角線上にある角 |
| destination | 座標 | 移動先領域の最初の角 |
| block | ブロック・アイテムの種類 | 複製時に調べるブロックの種類 |
| mode | CloneMode | 複製された領域の処理方法 |

## 使用例

### This code moves gold ore that is under the player to a region above the player. This makes the ore easier to see and mine.

```javascript
player.onTravelled(TravelMethod.Walk, () => {
    blocks.cloneFiltered(
        pos(-2, -3, -2),
        pos(2, 0, 2),
        pos(-2, 3, -2),
        GOLD_ORE,
        CloneMode.Move
    );
});
```

```python
def on_travelled_walk():
    blocks.clone_filtered(pos(-2, -3, -2),
        pos(2, 0, 2),
        pos(-2, 3, -2),
        GOLD_ORE,
        CloneMode.MOVE)
player.on_travelled(WALK, on_travelled_walk)
```

## 出典

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

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