角色控制器

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

名称 描述
将角色控制器位移一次 将角色控制器位移一次,如果作用于玩家,则玩家必须打开使用物理效果的玩家控制器才能生效
将角色控制器位移一次[已废弃] 已废弃
将角色控制器强制移动到某位置 将角色控制器移动到指定位置,如果作用于玩家,则玩家必须打开使用物理效果的玩家控制器才能生效