# バーチャルパッド説明

**URL:** <https://guild.rpgmakerofficial.com/t/topic/1037>\
**Category:** 一般\
**Created:** [2025 年 12 月 10 日午前 4:24 UTC](https://guild.rpgmakerofficial.com/t/topic/1037 "2025-12-10T04:24:48Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Shirokishi](https://avatars.discourse-cdn.com/v4/letter/s/df788c/32.png) [@Shirokishi](https://guild.rpgmakerofficial.com/u/Shirokishi)\
**Post date:** [2025 年 12 月 10 日午前 4:24 UTC](https://guild.rpgmakerofficial.com/t/topic/1037/1 "2025-12-10T04:24:48Z")

</div>

[virtualpad\_agm.zip](https://guild.rpgmakerofficial.com/uploads/short-url/iX3ZxXXpOcrDIE3sOiPkE0kZtPi.zip) (9.6 KB)

VirtualJoystick は、タッチやマウスの位置から「軸ベクトル」「角度」「距離」を計算し、設定に応じて InputMap にアクションを送ります。

主な性質は次の通りです。

1. 現在の入力ベクトルを保持します

- `get_axis()` で現在の軸を取得できます（右が正の X、上が負の Y）
- `get_input_strength()` でベクトルの長さ（0.0〜1.0）を取得できます
- `get_input_angle_deg()` で角度（度数法。0 度が右、90 度が上）を取得できます

1. 角度と距離帯でアクションを決めます

- VirtualJoystickAngleConfig に「どの角度範囲を担当するか」を設定します
- その中の VirtualJoystickDistanceBand で「距離の範囲とアクション名」を設定します
- 入力の角度と距離がバンドに入った場合、そのバンドのアクションが InputMap に送られます

1. AGM サフィックスを自動付与します
2. シグナルで任意の通知も行えます  
AGMのゲームオブジェクトにシグナルを送信するときは`generic_signal(signal_name: String, value: Variant)` を対象オブジェクトのreceive\_signalに接続してください。

* * *

## 2. 最小構成での使い方

最小限の設定で四方向一段階のバーチャルパッドとして使う手順です。

### 2-1. VirtualJoystick ノードをシーンに用意する

1. シーンツリーで VirtualJoystick を直接追加する  
or  
Node2D を追加し、そのスクリプトに `virtual_joystick.gd` をアタッチする

### 2-2. 子ノードの自動生成ボタンを押す

VirtualJoystick ノードを選択すると、インスペクタに  
「デフォルト子ノードを生成して割り当て」のボタンがあります。  
**（ボタンが表示されない場合やボタンを押してもうまく生成されない場合はプロジェクトを保存し再起動してください）**

1. このボタンを一度押します
2. 次のノードが自動的に作成されます

- area\_control\_node  
画面全体などを覆う Control。タッチの有効範囲として使われます。  
これが空になっている場合は画面全体がバーチャルパッドのタッチ範囲となります。  
バーチャルパッドが反応しない場合はこの設定を見直してください。

- base\_texture\_rect\_node  
ベース画像用の TextureRect

- knob\_texture\_rect\_node  
つまみ画像用の TextureRect

必要であれば、別途用意した TextureRect を overlay\_texture\_rect\_node に割り当ててください。

### 2-3. InputMap にアクションを登録する

1. InputMap 側  
InputMapにバーチャルパッドで使用したいキーを登録しておきます。

### 2-4. 角度アクションの自動生成

1. VirtualJoystick の `use_angle_actions` を true にしておきます
2. インスペクタの「4方向の角度アクションを自動生成」ボタンを押します
3. angle\_actions に四つの VirtualJoystickAngleConfig が追加されます

- Right  
角度範囲 -45 〜 45 度
- Up  
角度範囲 45 〜 135 度
- Left  
角度範囲 135 〜 -135 度（360 度ラップを含む）
- Down  
角度範囲 -135 〜 -45 度

それぞれの angle\_config 内には bands がひとつだけ存在し、  
初期状態では「どの角度でも距離帯は 0〜1 でひとつだけ」という形になっています。

### 2-5. 距離帯にアクション名を書く

1. Right の VirtualJoystickAngleConfig を開きます
2. 中の `bands[0]`（VirtualJoystickDistanceBand）を選びます
3. `action_name` に発火させたいInputMapのキー名を入れます

### 2-6. dead\_zone と max\_distance の調整

1. dead\_zone

- 軸の長さがこの値未満のとき、軸をゼロとして扱います
- 少し動かした程度では反応させたくない場合は 0.15〜0.2 程度にすると扱いやすくなります

1. max\_distance

- つまみが移動できる最大距離をピクセル単位で指定します
- ベース画像の半径に合わせて調整してください

### 2-7. 実行して確認する

1. プレイモードで area\_control\_node の範囲をタッチ、またはマウスでドラッグします
2. ベースとつまみが動き、入力角度と距離に応じて設定した距離帯が有効になります