# 範囲をコピーする（blocks.clone）

> 立方体領域を別の場所に複製します。

- カテゴリ：ブロック（blocks）
- ブロック：コピーする コピー元の範囲の始まり~0 ~0 ~0 コピー元の範囲の終わり~0 ~0 ~0 コピー先の場所~0 ~0 ~0 マスク置きかえ モード通常
- URL：https://makecode.minecraft-okinawa.com/reference/blocks/clone/
- 公式データ取得日：2026-11-13
- 動作確認：確認待ち

## JavaScript

```javascript
blocks.clone(
    pos(0, 0, 0),
    pos(0, 0, 0),
    pos(0, 0, 0),
    CloneMask.Replace,
    CloneMode.Normal
)
```

## Python

```python
blocks.clone(pos(0, 0, 0),
    pos(0, 0, 0),
    pos(0, 0, 0),
    CloneMask.REPLACE,
    CloneMode.NORMAL)
```

## 引数

| 名前 | 値 | 意味 |
|---|---|---|
| begin | 座標 | 立方体領域の最初の角 |
| end | 座標 | 立方体領域の対角線上にある角 |
| destination | 座標 | 移動先領域の最初の角 |
| mask | CloneMask | 空気ブロックの処理方法 |
| mode | CloneMode | 複製された領域の処理方法 |

## 使用例

### Create a ceiling above the current player's head. This copies the floor below the player's feet to the ceiling.

```javascript
player.onTravelled(TravelMethod.Walk, () => {
    blocks.clone(
        pos(-2, -1, -2),
        pos(2, -1, 2),
        pos(-2, 3, 0),
        CloneMask.Replace,
        CloneMode.Normal
    );
});
```

```python
def on_travelled_walk():
    blocks.clone(pos(-2, -1, -2),
        pos(2, -1, 2),
        pos(-2, 3, 0),
        CloneMask.REPLACE,
        CloneMode.NORMAL)
player.on_travelled(WALK, on_travelled_walk)
```

## よくあるミス

- コピー元とコピー先の範囲が重なると、うまくコピーできないことがあります。

## 出典

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

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