POBDS / 08
角色属性、方法与基础能力
用 C# 提供稳定的角色能力,在编辑器中快速选择和组合这些能力。
选择合适的角色基类
PoBDSActor 提供可被蓝图访问的角色基础接口。PoBDSCharacterActor 在此之上封装整数移动、生命、体力、目标、阵营和基础战斗。PoBDSCharacterComponent 把角色与 Unity 对象、Agent 和固定步长更新连接起来。
| 分类 | 已有能力示例 |
|---|---|
| 变换 | 位置、整数毫米 XYZ、传送、朝向目标 |
| 生命 / 体力 | Health、MaxHealth、千分比生命值、护甲、伤害、治疗、复活、体力消耗与恢复 |
| 移动 | 移动速度、能否移动、移动状态、到达 / 阻挡 / 禁用结果 |
| 感知 / 目标 | 搜索半径、最近敌人、目标引用、距离、可见性回调 |
| 战斗 / 标记 | 攻击范围、伤害、间隔、计数、角色标签 |
像引用对象一样读取属性
从角色引用开始
添加自身角色、目标角色或 Actor 变量读取节点。角色引用不是一个“有目标”的布尔值。
按类型选择成员
从 Actor 引脚搜索角色属性;或先加属性节点,再连接角色输入。检查器中的来源应说明使用的是外部连接,而不是另一个固定角色。
选择属性或方法
在分类与搜索菜单中选择可用成员,不需要手填字符串猜测方法名。方法参数在调用 Action 的配置中绑定。
连接数值运算
位置可作为 Vector3 输出;展开组件开关后出现 XYZ 输出。整数位置或距离与毫米阈值配合使用。
增加自己的角色属性
C#
using System;
using PoBDS.Runtime;
[Serializable, PoBDSActorAttr("Guard", Group = "Game/Guard")]
public class GuardActor : PoBDSCharacterActor
{
[PoBDSProp("Ammo", Group = "Game/Combat")]
public int Ammo { get; set; } = 30;
[PoBDSMethod("Reload", Group = "Game/Combat")]
public void Reload() { Ammo = 30; }
}编译完成后刷新成员列表,以角色类型和分类筛选。实际游戏里的动画、导航、联网伤害、武器发射可以接入虚方法或自己的 Action;基础框架不应替游戏项目决定这些业务规则。
合理使用反射
成员发现、分类、显示名与参数描述适合在编辑器中通过元数据完成。运行中的高频逻辑优先使用已解析的成员访问器、明确类型的 Action 和缓存数据;不要在每个 Action.Update 中扫描程序集或反复查找方法。开启新反射成员后还要考虑 IL2CPP 裁剪与代码保留。