角色控制器

CharacterController

物理
組件
可添加的:
自訂物件
組合:
實體類
互斥:
碰撞器
碰撞形狀
剛體

有物理效果的玩家控制器

屬性

名稱 類型 描述 腳本名稱
使用帶物理效果的 CCT 布林 \ UsePhysicalCCT
最大上坡角度 浮點數 放置在超過該角度的坡面上,會向下滑動 SlopeLimit
步距垂直偏移 浮點數 只有超過該高度的障礙物才有阻擋效果 StepOffset
塗裝厚度 浮點數 允許潛入膠囊體的深度,可以防止角色卡住或抖動 SkinWidth
最小移動距離 浮點數 小於該值的移動不會執行。如非特殊需求建議保持為 0 MinMoveDistance
中心偏移 三維向量 唯讀
膠囊體碰撞盒的偏移值
CenterOffset
半徑 浮點數 \ Radius
高度 浮點數 \ Height
線速度 (m/s) 三維向量 唯讀
Velocity
最大絕對運動速度 浮點數 \ MaxSpeed
重力 三維向量 該重力加速度僅作用於該玩家控制器 Gravity
質量 (kg) 浮點數 \ Mass
是否正在滑落 布林 唯讀
IsSliding
上部是否發生了觸碰 布林 唯讀
IsTopColliding
側邊是否發生了觸碰 布林 唯讀
IsSideColliding
底部是否發生了觸碰 布林 唯讀
IsBottomColliding
是否由伺服器驅動 布林 如果為 false,則自訂物件無法透過 API 控制。 IsServerDriven
是否使用自訂推力大小 布林 \ UseCustomPushForce
自訂推力 浮點數 \ CustomPushForce
是否著地 布林 唯讀
IsGrounded
物理層級 整數 唯讀
自訂物理層級,取值 0-31
PhysicalLayer
是否跟隨重力旋轉朝向 布林 唯讀
EnableRotateWithGravity

事件

名稱 描述
當角色控制器被擊中時 在玩家控制器觸碰實體時觸發,只有當控制器主動發生動作時才會觸發

API

名稱 描述
移動角色控制器 將角色控制器位移一次,如果作用於玩家,則玩家必須打開使用物理效果的玩家控制器才能生效
移動角色控制器[已廢棄] 已廢棄
強制移動角色控制器到某位置 將角色控制器移動到指定位置,如果作用於玩家,則玩家必須開啟使用實體效果的玩家控制器才能生效