CharacterBody3Dの移動

課題

プレイヤー操作可能な3Dキャラクターボディが必要となります。

解決策

このレシピでは、こちらの可愛らしいタンクモデルを使用します。

このモデルはItch.ioで入手できます。他のお好きなモデルを使用しても構いません。ここでは戦車固有の機能は特に実装しません。

このアセットの場合、ダウンロードには OBJファイルが含まれており、シーンとしてインポートした方が作業が効率的になります。

モデルをシーンに追加することはできますが、以下の追加ノードが必要となります。

衝突判定形状については、戦車の履帯と位置・サイズを合わせた BoxShape を使用します。CamPos は、後続カメラを配置するための Marker3D です。戦車の後方かつ上部、やや下向きに配置されます。

また、個別の MeshInstance ノードを Y 軸を中心に 180 度回転させました。これは元々 +Z 方向を向いてモデル化されていたためですが、Godot では -Z が前方方向となるため、戦車が逆向きに見えるようにはしたくないからです。

スクリプトを追加する前に、「プロジェクト設定」を開き、「インプットマップ」タブで以下の入力を追加してください。

それでは、必要な変数から始めつつ、スクリプトを追加してください。

extends CharacterBody3D

@export var speed = 4.0
@export var turn_speed = 0.8

speed は戦車の移動速度（前進/後退）を、rot_speed は旋回速度をそれぞれ定義します。

move_and_slide()メソッドを使用することで、移動コードが非常に簡潔になります。

func _physics_process(delta):
    velocity.y -= gravity * delta
    get_input(delta)
    move_and_slide()

このコードでは、重力による下向き加速度を現在の速度に加算し、ユーザー入力を取得し（詳細は後述）、move_and_slide() 関数を呼び出しています。

次に必要なのは get_input() 関数を定義することです。ここでは入力操作を処理して適用します。

func get_input(delta):
    var vy = velocity.y
    velocity = Vector3.ZERO
    var move = Input.get_axis("back", "forward")
    var turn = Input.get_axis("right", "left")
    velocity += -transform.basis.z * move * speed
    rotate_y(turn_speed * turn * delta)
    velocity.y = vy

これをもう少し詳しく見ていきます。プレイヤー入力は水平方向の移動に影響を与えるべきです。地面に沿った前後移動と、戦車の中心周りの回転です。Y軸方向の移動は、重力の影響を受けるべきものであり、つまり毎フレーム0に設定すべきではありません。これが、新しい速度ベクトルを水平移動用に割り当てる間、その値を一時的に保持するためにvy変数を使用している理由です。そして最後に、この値を新たに追加してください。

前方/後方移動にはキャラクターの transform.basis.z を使用しています。 これにより、身体の「ローカル」前方方向へ正しく移動します。

「これが動作中の戦車です。テスト用シーンとして、地面には StaticBody3D、カメラには 補間付きカメラ レシピを使用した Camera3D を配置しています。

まとめ

これはあらゆる種類の運動学的キャラクターの動作基盤です。ここからジャンプ、射撃、AI挙動などを追加できます。このレシピを拡張した具体例については、関連するレシピを参照してください。

プロジェクトのダウンロード

プロジェクトのサンプルコードをダウンロードする：https://github.com/godotrecipes/characterbody3d_examples

関連レシピ

• 3D入門
• 入力アクション