# チャットコマンドを入力したとき（player.onChat）

> 設定されたキーワードをゲーム内チャットで入力すると、ハンドラー内のコードを実行します。

- カテゴリ：プレイヤー（player）
- ブロック：チャットコマンド "jump" を入力した時
- URL：https://makecode.minecraft-okinawa.com/reference/player/on-chat-command/
- Pythonでの名前：player.on_chat
- 公式データ取得日：2026-11-13
- 動作確認：確認待ち

## JavaScript

```javascript
player.onChat("jump", function () {})
```

## Python

```python
def on_on_chat():
    pass
player.on_chat("jump", on_on_chat)
```

## 引数

| 名前 | 値 | 意味 |
|---|---|---|
| command | 文字列 | このコマンドに関連づけられるチャットのキーワード（``*`` はすべてのメッセージに対して）。たとえば：「jump」 |

## 使用例

### 下記のプログラムでは、チャットでjumpと入力すると、プレイヤーをとても高くジャンプさせることができます。

```javascript
player.onChat("jump", function () {
    player.teleport(pos(0, 10, 0));
});
```

```python
def on_on_chat():
    player.teleport(pos(0, 10, 0))
player.on_chat("jump", on_on_chat)
```

### 例えば次のチャットコマンドでは、引数として数字を利用します。

```javascript
player.onChat("command1", function (num1) {

});
```

```python
def on_on_chat(num1):
    pass
player.on_chat("command1", on_on_chat)
```

### 引数を使用すると、チャット コマンドでプログラムを変更することができます - あなたの想像力が重要です！以下のチャット コマンドは、3つの引数を受け取ってプログラムの実行回数を変更して実行できます。

```javascript
player.onChat("command2", function (num1, num2, num3) {

});
```

```python
def on_on_chat(num1, num2, num3):
    pass
player.on_chat("command2", on_on_chat)
```

## くわしい解説

MakeCodeで作ったプログラムを動かす「スイッチ」になるブロックです。多くの作例は、このブロックから始まります。

チャットに「go 5」のように数字を続けて入力すると、その数字をプログラムの中で使えます（引数）。距離や高さを、その場で変えられる作品が作れます。

## よくあるミス

- チャットには「/」を付けずに、決めた言葉だけを入力します（例：go）。
- ほかのチャットコマンドと同じ言葉にしないようにします。どちらが動くか分かりにくくなります。
- プログラムを実行（▶）してから、ゲームに戻ってチャットを入力します。

## 出典

- [MakeCode for Minecraft 公式リファレンス（player.onChat）](https://minecraft.makecode.com/reference/player/on-chat-command)

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