Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

VehicleWheel3D

繼承: Node3D < Node < Object

用於 VehicleBody3D 的 3D 物理體,能夠類比車輪的行為。

說明

作為 VehicleBody3D 子節點使用的節點,能夠模擬車輛其中一個車輪的行為。這個節點還充當了碰撞器,能夠偵測車輪是否與某個表面接觸。

注意:該類存在已知問題,並非旨在提供逼真的 3D 車輛物理效果。如果想要進階車輛物理,可能必須使用其他 PhysicsBody3D 類來編寫自己的物理整合函式。

教學

屬性

float

brake

0.0

float

damping_compression

0.83

float

damping_relaxation

0.88

float

engine_force

0.0

PhysicsInterpolationMode

physics_interpolation_mode

2 (overrides Node)

float

steering

0.0

float

suspension_max_force

6000.0

float

suspension_stiffness

5.88

float

suspension_travel

0.2

bool

use_as_steering

false

bool

use_as_traction

false

float

wheel_friction_slip

10.5

float

wheel_radius

0.5

float

wheel_rest_length

0.15

float

wheel_roll_influence

0.1

方法

Node3D

get_contact_body() const

Vector3

get_contact_normal() const

Vector3

get_contact_point() const

float

get_rpm() const

float

get_skidinfo() const

bool

is_in_contact() const


屬性說明

float brake = 0.0 🔗

通過施加制動力使車輪減速。車輪只有在與表面接觸時才會減速。使車輛充分減速所需的力,取決於車輛的 RigidBody3D.mass。對於品質被設定為 1000 的車輛,嘗試使用 25 - 30 範圍內的值進行緊急制動。


float damping_compression = 0.83 🔗

  • void set_damping_compression(value: float)

  • float get_damping_compression()

懸掛彈簧處於壓縮狀態時施加的阻尼,此時的車輪在相對於車輛向上移動。單位為牛頓·秒每毫米(N⋅s/mm)或兆克每秒(Mg/s)。這個值應該在 0.0(無阻尼)和 1.0 之間,但也可能更高。值為 0.0 表示汽車會持續彈跳,因為彈簧能夠保持能量。普通汽車設為 0.3 左右、賽車設為 0.5 左右比較好。


float damping_relaxation = 0.88 🔗

  • void set_damping_relaxation(value: float)

  • float get_damping_relaxation()

懸掛彈簧回彈或伸展時施加的阻尼,此時的車輪在相對於車輛向下移動。單位為牛頓·秒每毫米(N⋅s/mm)或兆克每秒(Mg/s)。這個值應該在 0.0(無阻尼)和 1.0 之間,但也可能更高。這個值應該始終略高於 damping_compression 屬性。對於 damping_compression 值為 0.3 的情況,請嘗試將放鬆值設為 0.5。


float engine_force = 0.0 🔗

  • void set_engine_force(value: float)

  • float get_engine_force()

通過施加引擎力使車輪加速。車輪只有在與表面接觸時才會加速。車輛的 RigidBody3D.mass 對車輛的加速度有影響。對於品質被設定為 1000 的車輛,請嘗試使用 25 - 50 範圍內的加速度值。

注意:模擬沒有考慮齒輪的影響,如果想要類比齒輪,需要為其新增邏輯。

負值將導致車輪倒轉。


float steering = 0.0 🔗

  • void set_steering(value: float)

  • float get_steering()

車輪的轉向角,單位:弧度。將該屬性設定為非零值將導致車輛在移動時轉向。


float suspension_max_force = 6000.0 🔗

  • void set_suspension_max_force(value: float)

  • float get_suspension_max_force()

彈簧所能承受的最大力。該值應高於 VehicleBody3D 的 RigidBody3D.mass 的四分之一,否則該彈簧無法承載車輛的重量。大約 3 到 4 倍這個數字的值通常會獲得良好的結果。


float suspension_stiffness = 5.88 🔗

  • void set_suspension_stiffness(value: float)

  • float get_suspension_stiffness()

懸掛的剛度,測量單位為牛頓每毫米(N/mm)或兆克每平方秒(Mg/s²)。越野車使用低於 50 的值,賽車使用 50 到 100 之間的值,類似於一級方程式賽車的車輛請嘗試使用 200 左右的值。


float suspension_travel = 0.2 🔗

  • void set_suspension_travel(value: float)

  • float get_suspension_travel()

這是懸架可以移動的距離。由於Godot 的單位相當於米,所以保持這個設定相對較低。根據汽車的型別,試試 0.1 和 0.3 之間的值。


bool use_as_steering = false 🔗

  • void set_use_as_steering(value: bool)

  • bool is_used_as_steering()

如果為 true,當汽車轉向時這個輪子會轉動。該值與 VehicleBody3D.steering 結合使用,如果使用的是各個車輪的 steering 值,則該值將被忽略。


bool use_as_traction = false 🔗

  • void set_use_as_traction(value: bool)

  • bool is_used_as_traction()

如果為 true,該車輪會將引擎力傳遞到地面以推動車輛前進。該值與 VehicleBody3D.engine_force 結合使用,如果使用的是各個車輪的 engine_force 值,則該值將被忽略。


float wheel_friction_slip = 10.5 🔗

  • void set_friction_slip(value: float)

  • float get_friction_slip()

這決定了這個輪子的抓地力有多大。它與車輪所接觸的表面的摩擦力設定相結合。0.0 意味著沒有抓地力,1.0 是正常抓地力。對於漂移車的設定,嘗試將後輪的抓地力設定得比前輪略低,或者使用較低的數值來模擬輪胎的磨損。

在開始時最好將其設定為 1.0。


float wheel_radius = 0.5 🔗

  • void set_radius(value: float)

  • float get_radius()

輪子的半徑,單位是米。


float wheel_rest_length = 0.15 🔗

  • void set_suspension_rest_length(value: float)

  • float get_suspension_rest_length()

這是輪子從原點下降的距離,以米為單位。不要把這個設定為 0.0,然後把車輪移到位置上,而是把車輪的原點(Godot 中的小工具)移到車輪觸底時的位置,然後使用剩餘長度將輪子向下移動到汽車靜止時它應該所處位置。


float wheel_roll_influence = 0.1 🔗

  • void set_roll_influence(value: float)

  • float get_roll_influence()

該值會影響車輛的捲動。如果將所有車輪都設定為 1.0,車輛將抵抗車身側傾,而值為 0.0 則容易翻車。


方法說明

Node3D get_contact_body() const 🔗

如果接觸的實體節點在樹中有效,則返回接觸的實體節點,如 Node3D。目前,不支持 GridMap,因此該節點將始終為 PhysicsBody3D 型別。

如果車輪沒有與表面接觸,或者接觸的實體不是 PhysicsBody3D,則返回 null。


Vector3 get_contact_normal() const 🔗

如果輪子與物體接觸,則回傳懸掛碰撞的法線,使用世界空間。如果輪子沒有與任何物體接觸,則回傳一個指向懸掛軸方向、朝向車輛的向量,使用世界空間。


Vector3 get_contact_point() const 🔗

如果輪子與物體接觸,則回傳懸掛的碰撞點,使用世界空間。如果輪子沒有與任何物體接觸,則回傳輪子射線投射的最大點,使用世界空間,該點由 wheel_rest_length + wheel_radius 定義。


float get_rpm() const 🔗

返回輪子的旋轉速度,單位為每分鐘轉數。


float get_skidinfo() const 🔗

返回一個介於 0.0 和 1.0 之間的值,表示這個輪子是否打滑。0.0 表示打滑(車輪失去了抓地力,例如冰雪地形),1.0 表示不打滑(車輪有充分的抓地力,例如乾燥的瀝青路)。


bool is_in_contact() const 🔗

如果輪子與表面接觸,返回 true。