Skip to content
角色基础功能

角色基础功能

阅读本文大概需要 30 分钟

本文概述了角色的所有基础属性,以及如何在编辑器中,修改角色的基础属性,制作出主角的各种能力。

什么是角色?

  • 角色是具有一套行为能力的模型。游戏世界中,角色分为非玩家角色和玩家角色。
  • 【玩家角色】:由玩家控制的角色,大部分的玩家角色都是游戏剧情的关键或是主角。本篇主要讲解如何设置玩家角色的属性与功能。
  • 【非玩家角色】:非玩家角色也被称为 NPC,指的是在游戏中不受真人玩家控制的游戏角色。NPC 一般由计算机人工智能控制,拥有一套行为模式的角色。NPC 通常分为剧情 NPC,战斗 NPC,服务 NPC 以及兼具多种功能的 NPC 等。

如何设置角色属性?

方式一 :面板设置

在对象管理器中的【世界】对象中,找到并点击【角色】对象后,即可通过属性面板编辑角色的默认属性。

中文示例英文示例

方式二 :脚本设置

通过脚本挂在到对象管理器的对象中,实现动态修改角色属性。

下面我们会根据角色的各个属性,介绍其属性作用,以及如何动态修改角色属性。

角色属性

基础属性

中文示例英文示例
imgimg

是否可移动

属性说明:控制玩家移动的属性,关闭后角色将无法移动。

实际应用:我们可以利用触发器对象,制作一个小范围的陷阱。角色进入陷阱时,导致角色眩晕1秒,眩晕期间无法移动,并播放眩晕特效。当然禁锢类型的技能效果也是如此。

实现步骤:

首先我们将触发器对象放置在场景中

中文示例英文示例

然后触发器对象下挂载以下脚本,即可实现一个限制移动的陷阱。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //角色进入陷阱触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色禁止移动
            chara.movementEnabled = false;
            // 新增眩晕特效
            let effect = GameObject.spawn("142935",{replicates: true}) as Effect;
            //将眩晕特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //将眩晕特效进行相对位置的偏移
            effect.localTransform.position = new Vector(0, 0, 170)
            //播放眩晕特效
            effect.play();
            //加载眩晕动作
            let dizzyAnimation = chara.loadAnimation("53005");
            //播放眩晕动作
            dizzyAnimation.play();
            //1秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色可以移动
                    chara.movementEnabled = true;
                    //移除头顶眩晕特效
                    effect.destroy()
                    //停止播放眩晕动作
                    dizzyAnimation.stop();
                }
            }, 1000);

        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //角色进入陷阱触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色禁止移动
            chara.movementEnabled = false;
            // 新增眩晕特效
            let effect = GameObject.spawn("142935",{replicates: true}) as Effect;
            //将眩晕特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //将眩晕特效进行相对位置的偏移
            effect.localTransform.position = new Vector(0, 0, 170)
            //播放眩晕特效
            effect.play();
            //加载眩晕动作
            let dizzyAnimation = chara.loadAnimation("53005");
            //播放眩晕动作
            dizzyAnimation.play();
            //1秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色可以移动
                    chara.movementEnabled = true;
                    //移除头顶眩晕特效
                    effect.destroy()
                    //停止播放眩晕动作
                    dizzyAnimation.stop();
                }
            }, 1000);

        });

    }
}

效果图:

地面最大速度

属性说明:角色在地面移动时,角色可达到的最大移动速度。

实际应用:我们可以利用触发器对象,制作一个加速区域或者减速区域。当角色进入区域时,使角色获得5秒加速或者获得5秒减速。后续我们在制作跑酷类型的游戏时,可以合理利用此功能进行设计游戏玩法。

首先我们将触发器对象放置在场景中

中文示例英文示例
imgimg

然后触发器对象下挂载以下脚本,即可实现一个加速区域。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色的地面最大速度将变为900
            chara.maxWalkSpeed = 900;
            //加载疾跑动作
            let runAnimation = chara.loadAnimation("29722");
            //播放疾跑动作
            runAnimation.play();
            // 新增疾跑特效
            let effect = GameObject.spawn("153604",{replicates: true}) as Effect;
            //将疾跑特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //将疾跑特效进行相对位置的偏移
            effect.localTransform = new Transform((new Vector(0, 0, 90)),new Rotation(90, 0, -90),new Vector(1, 1, 1));
            //播放疾跑特效
            effect.play();
            //2秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色移动模式切换为地面行走
                    chara.switchToWalking();
                    //角色的地面最大速度恢复为450
                    chara.maxWalkSpeed = 450;

                }
            }, 2000);

        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色的地面最大速度将变为900
            chara.maxWalkSpeed = 900;
            //加载疾跑动作
            let runAnimation = chara.loadAnimation("29722");
            //播放疾跑动作
            runAnimation.play();
            // 新增疾跑特效
            let effect = GameObject.spawn("153604",{replicates: true}) as Effect;
            //将疾跑特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //将疾跑特效进行相对位置的偏移
            effect.localTransform = new Transform((new Vector(0, 0, 90)),new Rotation(90, 0, -90),new Vector(1, 1, 1));
            //播放疾跑特效
            effect.play();
            //2秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色移动模式切换为地面行走
                    chara.switchToWalking();
                    //角色的地面最大速度恢复为450
                    chara.maxWalkSpeed = 450;

                }
            }, 2000);

        });

    }
}

效果图:

换个脚本,并将脚本中利用到的GUID为【142933】的资源放置在优先加载的列表,即可实现一个减速区域。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色的地面最大速度将变为100
            chara.maxWalkSpeed = 100;
            // 新增减速特效
            let effect = GameObject.spawn("142933",{replicates: true}) as Effect;
            //将减速特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //播放减速特效
            effect.play();
            //2秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色移动模式切换为地面行走
                    chara.switchToWalking();
                    //角色的地面最大速度恢复为450
                    chara.maxWalkSpeed = 450;
                    //移除减速特效
                    effect.destroy()
                }
            }, 2000);

        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            //角色的地面最大速度将变为100
            chara.maxWalkSpeed = 100;
            // 新增减速特效
            let effect = GameObject.spawn("142933",{replicates: true}) as Effect;
            //将减速特效插到角色根节点处
            chara.attachToSlot(effect, HumanoidSlotType.Root);
            //播放减速特效
            effect.play();
            //2秒后触发以下逻辑
            setTimeout(() => {
                if (chara) {
                    //角色移动模式切换为地面行走
                    chara.switchToWalking();
                    //角色的地面最大速度恢复为450
                    chara.maxWalkSpeed = 450;
                    //移除减速特效
                    effect.destroy()
                }
            }, 2000);

        });

    }
}

效果图:

最大加速度

属性说明:角色移动时,角色会根据最大加速度进行提速,逐渐达到角色的地面最大速度。

举例说明:在两个角色的地面最大速度相同时,最大加速度较快的角色会先达到最大速度。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//设置角色最大加速度 = 1000;
chara.maxAcceleration = 1000;
//声明角色
let chara = Player.localPlayer.character
//设置角色最大加速度 = 1000;
chara.maxAcceleration = 1000;

不可跨越高度

属性说明:角色跨越台阶时,台阶的最大高度 ,大于等于该高度角色均无法跨越。

举例说明:当角色上楼梯时,可以直接走上去,当角色上比较高的石墩时,无法直接走上去。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色不可跨越高度 = 200;
chara.maxStepHeight = 200;
//声明角色
let chara = Player.localPlayer.character
//角色不可跨越高度 = 200;
chara.maxStepHeight = 200;

示意图:

最大站稳角度

属性说明:角色站立在斜坡上时,斜坡的最大角度,超过该角度,角色将无法站立在这个斜坡上,角色会存在坠落的表现。

数值范围:0-90。

举例说明:当角色走上斜坡时,斜坡角度过大,角色将无法在斜坡上站稳,而滑落下来。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色最大站稳角度 = 60;
chara.walkableFloorAngle = 60;
//声明角色
let chara = Player.localPlayer.character
//角色最大站稳角度 = 60;
chara.walkableFloorAngle = 60;

示意图:

最大转向速度

属性说明:角色每秒旋转的最大速度

举例说明:当角色接到指令进行转向时,会根据转向速度进行旋转。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色最大转向速度 = 100;
chara.rotateRate = 100;
//声明角色
let chara = Player.localPlayer.character
//角色最大转向速度 = 100;
chara.rotateRate = 100;

示意图:

运动面朝方向

属性说明:主角模型的面部朝向。

运动面朝方向包括:始终朝向移动方向、始终朝向目标方向、始终朝向控制器方向。

举例说明:

  • 始终朝向移动方向

    • 主角模型面朝方向始终朝向移动方向,例如角色向后移动,角色模型会立马转身面朝后方进行移动,注意摄像机转向不会影响角色的面朝方向。

  • 始终朝向目标方向

    • 主角模型面朝方向始终朝向目标方向,例如角色向后移动,但目标在前方,则角色模型会面朝前方倒退的方式进行移动。

  • 始终朝向控制器

    • 主角模型面朝方向始终朝向控制器,例如用户滑动了摄像机,主角模型的朝向会跟随摄像机方向进行旋转,换而言之摄像机朝向与主角模型朝向保持一致

示例脚本:

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //点击按键1触发以下逻辑
        InputUtil.onKeyDown(Keys.One, () => {
            //运动面朝方向为运动方向
            chara.moveFacingDirection = 0;
        });
        //点击按键2触发以下逻辑        
        InputUtil.onKeyDown(Keys.Two, () => {
            //运动面朝方向为目标方向
            chara.moveFacingDirection = 1;
        });
        //点击按键3触发以下逻辑        
        InputUtil.onKeyDown(Keys.Three, () => {
            //运动面朝方向为控制器方向
            chara.moveFacingDirection = 2;
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //点击按键1触发以下逻辑
        InputUtil.onKeyDown(Keys.One, () => {
            //运动面朝方向为运动方向
            chara.moveFacingDirection = 0;
        });
        //点击按键2触发以下逻辑        
        InputUtil.onKeyDown(Keys.Two, () => {
            //运动面朝方向为目标方向
            chara.moveFacingDirection = 1;
        });
        //点击按键3触发以下逻辑        
        InputUtil.onKeyDown(Keys.Three, () => {
            //运动面朝方向为控制器方向
            chara.moveFacingDirection = 2;
        });

    }
}

运动时依据的正方向

属性说明:角色模型移动时,依据的前进方向。

运动时依据的正方向包括:以定轴方向、以视线方向、以控制器方向。

举例说明:

  • 以定轴方向

    • 以世界的 X 轴正方向为前进方向,例如角色向前移动,主角模型向 X 轴正方向移动了一段距离。

  • 以视线方向

    • 以角色模型的视线方向为前进方向,例如角色向前移动,主角模型向他面朝的方向移动了一段距离。

  • 以控制器方向

    • 以控制器方向为前进方向,例如角色向前移动,主角模型会跟随摄像机的方向移动了一段距离,换而言之摄像机面朝方向为正方向。

示例脚本:

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //点击按键1触发以下逻辑
        InputUtil.onKeyDown(Keys.One, () => {
            //以定轴方向作为移动时的正方向
            chara.movementDirection = 0;
        });
        //点击按键2触发以下逻辑        
        InputUtil.onKeyDown(Keys.Two, () => {
            //以视线方向作为移动时的正方向
            chara.movementDirection = 1;
        });
        //点击按键3触发以下逻辑        
        InputUtil.onKeyDown(Keys.Three, () => {
            //以控制器方向作为移动时的正方向
            chara.movementDirection = 2;
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //点击按键1触发以下逻辑
        InputUtil.onKeyDown(Keys.One, () => {
            //以定轴方向作为移动时的正方向
            chara.movementDirection = 0;
        });
        //点击按键2触发以下逻辑        
        InputUtil.onKeyDown(Keys.Two, () => {
            //以视线方向作为移动时的正方向
            chara.movementDirection = 1;
        });
        //点击按键3触发以下逻辑        
        InputUtil.onKeyDown(Keys.Three, () => {
            //以控制器方向作为移动时的正方向
            chara.movementDirection = 2;
        });

    }
}

启用地面摩擦力

属性说明:角色在地面移动时,会受到两种向后的因素影响,分别是地面摩擦力和行走减速度。关闭地面摩擦力的影响后,角色移动时,就只会受到行走减速度影响。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//关闭地面摩擦力
chara.groundFrictionEnabled = false;
//设置角色的行走减速度=1000
chara.brakingDecelerationWalking = 1000;
//声明角色
let chara = Player.localPlayer.character
//关闭地面摩擦力
chara.groundFrictionEnabled = false;
//设置角色的行走减速度=1000
chara.brakingDecelerationWalking = 1000;

地面摩擦力

属性说明:角色在地面移动时,会受到两种向后的因素影响,分别是地面摩擦力和行走减速度。地面摩擦力是制约人物运动时改变方向的能力效果,一般是模拟环境因素给角色带来的不同减速效果。

实际应用:角色在冰面上奔跑时,突然转向,向反方向跑,角色会因为冰面的摩擦力较小,继续向前滑行一段时间后才能停下,然后向后进行移动。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//启用地面摩擦力
chara.groundFrictionEnabled = true;
//设备角色的地面摩擦力=10
chara.groundFriction = 10;
//声明角色
let chara = Player.localPlayer.character
//启用地面摩擦力
chara.groundFrictionEnabled = true;
//设备角色的地面摩擦力=10
chara.groundFriction = 10;

行走减速度

属性说明:角色在地面移动时,会受到两种向后的因素影响,分别是地面摩擦力和行走减速度。行走减速度是角色在地面移动状态下,不施加任何主动操作时受到的减速度。

实际应用:当角色不受地面摩擦力影响时,角色在减速过程中会根据角色的行走减速度进行减速,直至角色速度为0。当然正常情况下,角色是同时受到两个因素影响,所以在制作溜冰场的效果时,需要将两个值都减少到适应的值,如果其中一个值较大,都会导致角色将直接停下来。

实现步骤:以实现溜冰场的区域为例,想实现溜冰场效果目前是两种方式,首先我们要知道因为角色受到两种因素(地面摩擦力/行走减速度)的影响才能停下来,所以在做溜冰场效果时,我们需要将这两个因素的降低。

  • 方式1:两个因素值都降低,并将脚本中利用到的GUID为【151060】的资源放置在优先加载的列表,进而实现溜冰效果。
ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //声明角色
        let chara = Player.localPlayer.character
        //加载溜冰动作
        let anim = chara.loadAnimation("151060");

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //降低地面摩擦力,地面摩擦力=0
                chara.groundFriction = 0;
                //降低行走减速度,使行走减速度=10
                chara.brakingDecelerationWalking = 10;
                //播放滑冰动作
                anim.play();
            }
        });
        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //提高地面摩擦力,地面摩擦力=8                
                chara.groundFriction = 8;
                //提高行走减速度,使行走减速度=2048             
                chara.brakingDecelerationWalking = 2048;
                //停止滑冰动作
                anim.stop();
            }
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //声明角色
        let chara = Player.localPlayer.character
        //加载溜冰动作
        let anim = chara.loadAnimation("151060");

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //降低地面摩擦力,地面摩擦力=0
                chara.groundFriction = 0;
                //降低行走减速度,使行走减速度=10
                chara.brakingDecelerationWalking = 10;
                //播放滑冰动作
                anim.play();
            }
        });
        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //提高地面摩擦力,地面摩擦力=8                
                chara.groundFriction = 8;
                //提高行走减速度,使行走减速度=2048             
                chara.brakingDecelerationWalking = 2048;
                //停止滑冰动作
                anim.stop();
            }
        });

    }
}
  • 方式2:利用关闭地面摩擦力的接口,使地面摩擦力功能失效,只改变行走减速度,并将脚本中利用到的GUID为【151060】的资源放置在优先加载的列表,进而实现溜冰效果。
ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //声明角色
        let chara = Player.localPlayer.character
        //加载溜冰动作
        let anim = chara.loadAnimation("151060");
        
        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //关闭地面摩擦力的影响
                chara.groundFrictionEnabled = false;
                //降低行走减速度,使行走减速度=10
                chara.brakingDecelerationWalking = 10;
                //播放滑冰动作
                anim.play();
            }
        });
        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //关闭地面摩擦力的影响
                chara.groundFrictionEnabled = false;
                //提高行走减速度,使行走减速度=2048                
                chara.brakingDecelerationWalking = 2048;
                //停止滑冰动作
                anim.stop();
            }
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;
        //声明角色
        let chara = Player.localPlayer.character
        //加载溜冰动作
        let anim = chara.loadAnimation("151060");
        
        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //关闭地面摩擦力的影响
                chara.groundFrictionEnabled = false;
                //降低行走减速度,使行走减速度=10
                chara.brakingDecelerationWalking = 10;
                //播放滑冰动作
                anim.play();
            }
        });
        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //关闭地面摩擦力的影响
                chara.groundFrictionEnabled = false;
                //提高行走减速度,使行走减速度=2048                
                chara.brakingDecelerationWalking = 2048;
                //停止滑冰动作
                anim.stop();
            }
        });

    }
}

示意图:

飞行属性

中文示例英文示例
imgimg

最大飞行速度

属性说明:角色在飞行状态下进行移动时,角色可达到的最大移动速度。

实际应用:我们可以利用触发器对象,制作一个飞行区域。当角色进入区域时,角色会切换为飞行状态,且最大飞行速度为1000。

首先我们将触发器对象放置在场景中

中文示例英文示例
img

然后触发器对象下挂载以下脚本,即可实现一个飞行区域。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色状态切换为飞行状态
                chara.switchToFlying();
                //角色最大飞行速度=1000
                chara.maxFlySpeed = 1000;
            }
        });

        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色状态切换为地面行走状态
                chara.switchToWalking();
            }
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入触发器时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色状态切换为飞行状态
                chara.switchToFlying();
                //角色最大飞行速度=1000
                chara.maxFlySpeed = 1000;
            }
        });

        //角色离开触发器时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色状态切换为地面行走状态
                chara.switchToWalking();
            }
        });

    }
}

示意图:

飞行减速度

属性说明:角色在空中移动的状态下,不施加任何主动操作时受到的减速度。

实际应用:当角色在向前飞行的时候,突然不再施加操作,角色会受到飞行减速度的影响进行减速,直至飞行速度等于0。如果飞行减速度设置较小,角色会继续向其滑行,然后慢慢停下来。如果飞行减速度设置较大,角色将直接停下来。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//飞行减速度 = 200
chara.brakingDecelerationFlying = 200;
//声明角色
let chara = Player.localPlayer.character
//飞行减速度 = 200
chara.brakingDecelerationFlying = 200;

飞行减速度为200时,示意图:

飞行减速度为2048时,示意图:

游泳属性

中文示例英文示例
imgimg

最大游泳速度

属性说明:角色在游泳状态下进行移动时,角色可达到的最大移动速度。

实际应用:当角色进入游泳区域时,角色会切换为游泳状态,且最大游泳速度为 1000。

实现步骤:首先我们将游泳区域对象放置在场景中

中文示例英文示例
imgimg

然后我们就会根据角色属性面板中最大游泳速度,进行执行。

示意图:

如果想动态修改最大游泳速度,示例脚本如下:

ts
@Component
export default class NewScript extends Script {
    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //设置最大游泳速度 = 500
        chara.maxSwimSpeed = 500;
    }
}
@Component
export default class NewScript extends Script {
    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明角色
        let chara = Player.localPlayer.character
        //设置最大游泳速度 = 500
        chara.maxSwimSpeed = 500;
    }
}

游泳减速度

属性说明:角色在游泳状态下,不施加任何主动操作时受到的减速度。

实际应用:当角色在向前游泳的时候,突然不再施加操作,角色会受到游泳减速度的影响进行减速,直至游泳速度等于0。如果游泳减速度设置较小,角色会继续向其滑行,然后慢慢停下来。如果游泳减速度设置较大,角色将直接停下来。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//游泳减速度 = 500
chara.brakingDecelerationSwimming = 500;
//声明角色
let chara = Player.localPlayer.character
//游泳减速度 = 500
chara.brakingDecelerationSwimming = 500;

游泳减速度为200时,示意图:

游泳减速度为2048时,示意图:

下蹲属性

中文示例英文示例
imgimg

是否可以下蹲

属性说明:角色是否可以下蹲。

实际应用:在特殊情况下,不允许角色下蹲。

蹲伏行走最大移动速度

属性说明:角色在下蹲状态下移动时,角色可达到的最大移动速度。

实际应用:进入下蹲区域时,角色进入下蹲状态,移速在达到最大移动速度时恒定。

实现步骤:首先我们将触发器对象放置在场景中,然后绑定以下脚本即可实现一个下蹲区域。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入方形触发时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色状态切换为下蹲状态
                chara.crouch(true);
                //设置下蹲移速=500
                chara.maxWalkSpeedCrouched = 500;
            }
        });

        //角色离开方形触发时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色状态切换为行走状态
                chara.crouch(false);
            }
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {

        let trigger = this.gameObject as Trigger;

        //角色进入方形触发时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色状态切换为下蹲状态
                chara.crouch(true);
                //设置下蹲移速=500
                chara.maxWalkSpeedCrouched = 500;
            }
        });

        //角色离开方形触发时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色状态切换为行走状态
                chara.crouch(false);
            }
        });

    }
}

示意图:

下蹲时的高度

属性说明:下蹲状态下,角色胶囊体的高度。

实际应用:根据实际角色模型的下蹲高度,调整角色的胶囊体高度,进行完美适配。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色下蹲时胶囊体的高度 = 150
chara.crouchedHeight = 150;
//声明角色
let chara = Player.localPlayer.character
//角色下蹲时胶囊体的高度 = 150
chara.crouchedHeight = 150;

下落属性

中文示例英文示例
imgimg

最大下落速度

属性说明:角色在下落状态下移动时,角色可达到的最大移动速度。

实际应用:角色在从高空跳跃后,角色仅受到重力影响进行下落,下落速度会越来越快,直至移速达到最大下落速度。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//最大下落速度 = 5000
chara.maxFallingSpeed = 5000;
//声明角色
let chara = Player.localPlayer.character
//最大下落速度 = 5000
chara.maxFallingSpeed = 5000;

下落控制灵敏度

属性说明:角色在下落状态下的运动效果,可以拆分成水平方向的运动和垂直方向的运动两个部分。垂直方向的运动计算主要通过重力影响,水平方向的运动计算与地面的运动效果是一样的,也是由地面的最大速度、最大加速度以及下落控制灵敏度进行计算。也就是说水平速度主要以地面速度为基准,而下落控制灵敏度是限制水平的移动速度效果,使角色在下落状态下的水平移动速度不超过地面的移动速度。

数值范围:0-1。

范围说明:下落控制灵敏度范围在0到1之间,如果控制程度的数值为0时,角色无法在水平方向施加其他方向的速度。如果控制程度的数值为1时,角色可以在水平方向施加其他方向的速度,并且移动速度与地面的移动速度保持一致。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//点击按键1触发以下逻辑
InputUtil.onKeyDown(Keys.One, () => {
    //下落控制程度 = 0
    chara.airControl = 0;
});
//点击按键2触发以下逻辑        
InputUtil.onKeyDown(Keys.Two, () => {
    //下落控制程度 = 1
    chara.airControl = 1;
});
//声明角色
let chara = Player.localPlayer.character
//点击按键1触发以下逻辑
InputUtil.onKeyDown(Keys.One, () => {
    //下落控制程度 = 0
    chara.airControl = 0;
});
//点击按键2触发以下逻辑        
InputUtil.onKeyDown(Keys.Two, () => {
    //下落控制程度 = 1
    chara.airControl = 1;
});

下落控制灵敏度为0时,示意图:

下落控制灵敏度为1时,示意图:

重力倍率

属性说明:该值是调整角色下落速度时的重力效果的倍率。默认为1倍,数值越大,角色下落速度越快,数值越小,角色下落速度越慢。该值只影响角色重力倍率,世界场景中其他物体不受其影响。

实际应用:我们可以通过重力倍率调整出降落伞的效果,并且可以通过角色在空中状态下,改变地面最大速度和加速度,实现在空中移动速度更快的效果。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//重力倍率 = 0.01
chara.gravityScale = 0.01;
//声明角色
let chara = Player.localPlayer.character
//重力倍率 = 0.01
chara.gravityScale = 0.01;

下落水平减速度

属性说明:角色在下落状态下,不施加任何主动操作时水平方向受到的减速度。

举例说明:正常跳跃时,会根据初始跳跃的方向进行移动,如果该减速度过大,会导致角色在不操作的情况下,脱离该轨迹,进行垂直下落的效果。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//下落水平减速度 = 1000
chara.horizontalBrakingDecelerationFalling = 1000;
//声明角色
let chara = Player.localPlayer.character
//下落水平减速度 = 1000
chara.horizontalBrakingDecelerationFalling = 1000;

下落水平减速度为0时,示意图:

下落水平减速度为1000时,示意图:

跳跃属性

中文示例英文示例
imgimg

是否可跳跃

属性说明:限制角色跳跃的属性。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色跳跃能力为false
chara.jumpEnabled = false;
//声明角色
let chara = Player.localPlayer.character
//角色跳跃能力为false
chara.jumpEnabled = false;

最大跳跃高度

属性说明:角色跳跃时,从起跳位置到最高位置的距离设定。

实际应用:角色踩到跳跃板(触发器)时,角色将会执行跳跃,且跳跃很高的高度。

实现步骤:首先我们将触发器对象放置在场景中,然后绑定以下脚本即可实现一个跳跃板的功能。或者也可以利用此功能做蹦蹦床等功能。

ts
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;

        //角色进入方形触发时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色触发跳跃功能
                chara.jump();
                //角色跳跃高度 = 800
                chara.maxJumpHeight = 800;
            }
        });

        //角色离开方形触发时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色跳跃高度 = 200
                chara.maxJumpHeight = 200;
            }
        });

    }
}
@Component
export default class NewScript extends Script {

    /** 当脚本被实例后,会在第一帧更新前调用此函数 */
    protected onStart(): void {
        //声明触发器
        let trigger = this.gameObject as Trigger;

        //角色进入方形触发时触发以下逻辑
        trigger.onEnter.add((chara: Character) => {
            if (chara) {
                //角色触发跳跃功能
                chara.jump();
                //角色跳跃高度 = 800
                chara.maxJumpHeight = 800;
            }
        });

        //角色离开方形触发时触发以下逻辑
        trigger.onLeave.add((chara: Character) => {
            if (chara) {
                //角色跳跃高度 = 200
                chara.maxJumpHeight = 200;
            }
        });

    }
}

示意图:

最大跳跃次数

属性说明:角色能够执行的最大跳跃数量。

实际应用:实现角色多次跳跃的功能。

示例脚本:

ts
//声明角色
let chara = Player.localPlayer.character
//角色跳跃次数 = 5
chara.jumpMaxCount = 5;
//声明角色
let chara = Player.localPlayer.character
//角色跳跃次数 = 5
chara.jumpMaxCount = 5;

示意图:

形象设置

中文示例英文示例
imgimg

使用233平台角色形象

属性说明:勾选使用平台角色形象,角色的形象会继承233的平台形象效果,不勾选的情况下,角色可以自主设置角色形象。

注意说明:勾选使用平台角色形象的情况下,在角色编辑器中修改角色形象是无法更改形象效果的。

编辑人形对象

中文示例英文示例

说明:可以点击属性面板中的【编辑人形对象】进入编辑人形对象面板,为角色自定义更多装扮。

体型类型

中文示例英文示例
imgimg

属性说明:体型类型是相同外观类型下得更加详细得类型划分,使编辑器能够更加精准的获取到角色形象的体型外观,让角色的动作和表现效果更加符合审美。目前体型类型只有高级人形形象才会进行区分,【基础人形形象】和【多足形象】直接更换形象即可,不需要区分体型。

备注说明:无类型是没有明确的形象定义,让用户自定义角色效果。

角色形象

属性说明:角色形象是具体的形象资源槽,根据不同的类型显示不同的资源槽,用户可以通过将资源拖拽相应属性资源槽内,快速实现设置想要的角色形象。

操作示例:

中文示例英文示例
image-20240830171236840image-20240830171305038

角色换装的详细说明请见:

角色描边

中文示例英文示例
imgimg

被遮挡时开启描边

属性说明:角色被物体遮挡时,会显示角色描边,标记角色位置。

注意说明:开启描边后,注意关闭摄像机碰撞,否则没办法看到角色在遮挡情况下的描边效果。

描边颜色

属性说明:显示角色描边时,角色的描边颜色。

描边宽度

属性说明:显示角色描边时,角色的描边宽度。

示意图: