角色控制器

CharacterController

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

具有物理效果的玩家控制器,可施力受力

屬性

名稱 類型 描述 腳本名稱
使用帶物理效果的 CCT 布林 是否使用具有物理效果的玩家控制器 UsePhysicalCCT
最大上坡角度 浮點數 放置在超過該角度的坡面上,會向下滑動 SlopeLimit
步距垂直偏移 浮點數 只有超過該高度的障礙物才會有阻擋效果,取值範圍[0,Height] StepOffset
塗裝厚度 浮點數 允許嵌入改膠囊體的深度。可以防止角色卡住或抖動,無特殊需求不建議修改。取值範圍(0,Radius] SkinWidth
最小移動距離 浮點數 最小移動距離,小於該值的移動不會被執行。如非特殊需求建議維持0 MinMoveDistance
中心偏移 三維向量 唯讀
碰撞盒中心距離本地座標原點的偏移
CenterOffset
半徑 浮點數 膠囊體半徑,最小值0.01 Radius
高度 浮點數 膠囊體總高度,包含上下半球,最小值2*Radius Height
線速度 (m/s) 三維向量 唯讀
當前線速度,單位m/s
Velocity
最大絕對運動速度 浮點數 (已廢棄,請勿使用) MaxSpeed
重力 三維向量 此重力加速度僅作用於此玩家控制器 Gravity
質量 (kg) 浮點數 質量,單位kg Mass
是否正在滑落 布林 唯讀
所處坡面超過最大上坡角度時會向下滑落
IsSliding
上部是否發生了觸碰 布林 唯讀
(已廢棄,請勿使用)
IsTopColliding
側邊是否發生了觸碰 布林 唯讀
(已廢棄,請勿使用)
IsSideColliding
底部是否發生了觸碰 布林 唯讀
(已廢棄,請勿使用)
IsBottomColliding
是否由伺服器驅動 布林 開啟後,由服務端圖元或腳本控制移動 IsServerDriven
是否使用自訂推力大小 布林 開啟後,角色推動剛體時施加的力可以自訂 UseCustomPushForce
自訂推力 浮點數 角色推動剛體時施加的力大小 CustomPushForce
是否著地 布林 唯讀
下半部接觸碰撞體時為真,通常用於判斷玩家是否在地面上
IsGrounded
物理層級 整數 唯讀
自訂物理層級,取值[0,15]
PhysicalLayer
是否跟隨重力旋轉朝向 布林 唯讀
是否跟隨重力旋轉朝向
EnableRotateWithGravity

事件

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

API

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