[单脚本][MyClearHP] 简易的血条系统，包含伤害死亡重生逻辑，智能UI显示

灵感来源于rust、战地1等常见射击类游戏的血条信息
血条有三种配色风格(当然你也可以自己新增、定义你的风格)，自己、队友、敌人
血条信息会根据对方与玩家的距离选择性显示
当离得很近时，会显示点、血条、昵称，方便知道对方具体的情况
稍微远一档时会显示点、昵称，不显示血量，方便知道对方的名字、敌我状态
在远一点只会显示一个点，只知道对方的敌我状态
最远一档则全部消失，世界UI也被裁剪
这些距离范围会敌对状态而缩小，即更容易发现友军的信息，更不容易发现敌人的信息

1. 安装MyClearHp
MyClearHP.ts (74.53 KB, 下载次数: 139)

2024-6-15 17:48 上传

点击文件名下载附件


* 更新日志：

* 版本：v0.1.7 2024.06.14
* 1. 增加更多的判空处理，降低报错率
* 2. 将原本的replicated换成不可靠rpc，以获取更好的性能，更低的延迟
* 3. 优化昵称获取形式，让客户端低频地持续向服务器更新自己的昵称，以降低获取昵称失败的可能
* 4. 优化UI的显示规则，加入相机朝向与相机角色夹角的参数，以避免屏幕中id过多


* 历史版本


* 版本：v0.1.6 2024.01.25
* 1. 增加更多的判空处理，降低报错率

* 版本：v0.1.5 2024.01.13
* 1. 修复029线上敌对血条不正常显示的bug
* 2. 支持Gameobject添加血条，并适配CharacterInstance相关内容

下载脚本，导入到工程内容中，拖一个脚本到场景里即可
在其他脚本中使用 MyClearHp.方法名 就可以调用方法
并且在属性列表里有可以快捷修改的属性

2. 如何区分敌我
默认是所有人都是敌对的，如果你有自己的逻辑可以新建一个脚本
保存后拖到场景里，就会给MyClearHP注入你自己的敌我识别逻辑了

import MyClearHP from "./MyClearHP";



@Component

export default class NewScript extends Script {



    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        MyClearHP.checkIfFriendly.push((ID1,ID2)=>{

            // 这里写你的判断是否为友军的逻辑并return出来

            if(1){

                return false;

            }

            else{

                return true;

            }

        })

    }

}

这里的玩家id用的是 player.getUserId()
可以接入MyClearCamp阵营系统来区分敌我

import MyClearCamp from "./MyClearCamp";

import MyClearHP from "./MyClearHP";



@Component

export default class NewScript extends Script {



    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        MyClearHP.checkIfFriendly.push((ID1,ID2)=>{

            // 这里写你的判断是否为友军的逻辑并return出来

            return MyClearCamp.isFriendly(ID1, ID2);

        })

    }

}

3. 扣血、加血
服务端调用 MyClearHp.ServerChangePlayerCurHP(施害/施益者, 受害/受益者, 改变的血量值)
如果是扣血 “改变的血量值” 应为负数
这样加血、扣血就可以体现在血条上
4. 设置玩家最大血量
服务端调用 MyClearHp.ServerChangePlayerMaxHP(需要设置最大血量的玩家, 新的最大血量, 选填，设置新最大血量后对当前血量的处理方法)   这样就可以修改玩家的最大血量，并有对当前血量的处理方法
对当前血量的处理方法:
-1：维持当前血量，但不会超过最大值
0：有新增的部分填满
1：填满为最大血量
5. 血量改变后客户端的回调
如果想要在自己客户端另外有一个血量ui显示的话，可以在UI脚本里写

MyClearHP.onMyPlayerChangeHP.push((curHP,MaxHP)=>{

                        //这里写UI逻辑，curHP是改变后的当前血量，MaxHP是最大生命值

                })

每当服务器向客户端同步血量时，检测到当前客户端血量改变就会调用该方法
6. 死亡，重生的逻辑
当玩家扣血扣到0及以下时，会触发服务端方法onCharDeath()，这里可以做击杀播报

import MyClearHP from "./MyClearHP";



@Component

export default class NewScript extends Script {



    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        MyClearHP.onCharDeath.push((VID,AID)=>{

            //这里写角色死亡后的处理，比如传送某人到某处，或者给攻击者奖励等等

        })

    }

}

也对玩家死亡做了处理-> 开启布娃娃，3秒后重生，重生时间可在属性列表里配置
重生的时候会触发服务端onCharRespawn()

import MyClearHP from "./MyClearHP";



@Component

export default class NewScript extends Script {



    /** 当脚本被实例后，会在第一帧更新前调用此函数 */

    protected onStart(): void {

        MyClearHP.onCharRespawn.push((VID,AID)=>{

            //这里写角色重生后的处理，比如传送某人到某处，给某人提醒是谁击杀的等等

        })

    }

}

这两个方法主要是给你做死亡、重生的逻辑处理，如死亡掉落背包、死亡黑屏、重生传送到其他地方等等
7. 修改距离判定、血条样式


8. 实用接口与拓展
这里还提供了一些实用的接口，方便大家进行接入和二创~

8.1 功能方法

方法名称	描述	调用端需求	参数	返回值
ServerChangeCharCurHP	[服务器] 增加、扣除NPC或玩家角色当前血量	服务器	AttackerID: 施害/施益者实例ID VictimID: 受害/受益者实例ID deltaHP: 改变的血量，如果是伤害要改为负数	无
ServerForceRespawnChar	[服务器] 强制NPC或玩家角色重生	服务器	charInstanceID: 需要重生的NPC或玩家角色实例ID	无
ServerChangeCharMaxHP	[服务器] 设置NPC或玩家角色最大血量	服务器	charInstanceID: 需要设置最大血量的角色 newMaxHP: 新的最大血量 fillupMode: 选填，设置新最大血量后对当前血量的处理方法，默认0	无
addMyClearHPForChar	[服务器] 给NPC或玩家角色加血条	服务器	char: NPC或玩家角色(一般情况下就是NPC啦) HPparm: 初始化参数	无
removeMyClearHPForChar	[服务器] 给NPC或玩家角色移除血条	服务器	charInstanceID: NPC或玩家角色实例ID(一般情况下就是NPC啦)	无
getCharName	[双端] 获取NPC或玩家角色的昵称	双端	charInstanceID: NPC或玩家角色的实例id	字符串
getInstanceIDByChar	[双端] 获取角色的实例id	双端	char: 需要获取id的角色	字符串
getCharByInstanceID	[双端] 获取实例id对应的角色	双端	instanceID: 实例id(userID或者gameobjectID)	角色
checkIfNPC	[双端] 检查ID或者角色是否为NPC	双端	IDorChar: 需要检查的ID或者角色	布尔值
getCharHP	[双端] 获取角色HP	双端	IDorChar: 需要获取的ID或者角色	P_hp对象

8.2 事件接口

事件名称	描述	调用端	参数	说明
checkIfFriendly	[双端] 检查两个NPC或玩家角色实例ID是否为友军	双端	charInstanceID1、charInstanceID2	返回两个角色是否为友军
onMyPlayerBeHit	[仅客户端] 当前客户端的玩家角色受到伤害时，可以对其他UI做操作	仅客户端	attackerID、damage、beHitAngle	伤害事件，用于处理玩家受到攻击的情况
onMyPlayerChangeHP	[仅客户端] 当前客户端的玩家血量改变，可以对其他UI做操作	仅客户端	curHP、MaxHp	玩家血量变化事件，用于更新UI显示
onAnyCharChangeHP	[仅客户端] 当某个NPC或玩家角色血量改变，可以对其他UI做操作	仅客户端	charInstanceID、oldHP、curHP、MaxHp	角色血量变化事件，用于更新UI显示
onCharDeath	[双端] 当某个NPC或玩家角色死亡	双端	victimID、attackerID（可选）	角色死亡事件，可用于处理死亡后的逻辑和UI更新
onCharRespawn	[双端] 当某个NPC或玩家角色重生	双端	victimID、attackerID（可选）	角色重生事件，可用于处理重生后的逻辑和UI更新

太牛了

666

场景里加入这个脚本后，玩家碰到零件后角色名称显示不出来了

1. let mesh = this.gameObject as Gameplay.Mesh
   
2.         mesh.onEnter.add((other:Core.GameObject)=>{
   
3.             if(other instanceof Gameplay.Character){
   
4.                 let character = other as Gameplay.Character
   
5.                 console.log("触碰到玩家名称：",character.characterName)
   
6.             }
   
7.         })
   
8.     }

复制代码

化蛹为碟 发表于 2023-9-23 16:53
场景里加入这个脚本后，玩家碰到零件后角色名称显示不出来了

当然会显示不出来，因为我MyClearHp获取角色昵称之后就要把characterName清除掉，免得重复显示，你可以在我的单脚本里搜一下 CharacterName=""

太牛了

在使用过程中报错提示：

property 'curHP' of undefined,TypeError: Cannot read property 'curHP' of undefined

根据game.js定位找到报错相关代码位置是：

if (oldHpMap.get(eventCharId).curHP != undefined) {

在这段代码上面打印oldHpMap.get(eventCharId)为undefined，所以取不到curHP

建议修改为：

if (oldHpMap.has(eventCharId) && oldHpMap.get(eventCharId).curHP != undefined

躲猫猫作者_思想的鱼 发表于 2024-1-25 11:05
在使用过程中报错提示：

已修复 感谢反馈  新版另做了更多判空处理 欢迎继续反馈~

在使用过程中报错提示：

unhandledRejection,Error: access a invalid object,Error: access a invalid object

报错详情：

at newConstructor.getTargetUIWidget (../../../MetaWorldMobile/Content/JavaScript/MWUserBootstrap.js:22916:42)

根据game.js定位找到报错相关代码位置是：

let CurrWorldUIWidget = findUIScript(

              worldUI.getTargetUIWidget(),

            ) as UIHP;

具体怎么优化，还没有进行测试。计划是在这边继续做个判断，确保worldUI.getTargetUIWidget()能取到。

报错内容：

Error  unhandledRejection,TypeError: Cannot read property 'getOriginEventName' of null,TypeError: Cannot read property 'getOriginEventName' of null

报错位置：

let OtherUI = findUIScript(OtherworldUI.getTargetUIWidget()) as UIHP;

解决思路：
增加判空

if (OtherworldUI != undefined && OtherworldUI.getTargetUIWidget()) {

                  let OtherUI = findUIScript(

                    OtherworldUI.getTargetUIWidget(),

                  ) as UIHP;