PoBDS文档
Englishv1.0.0
POBDS / 08

角色属性、方法与基础能力

用 C# 提供稳定的角色能力,在编辑器中快速选择和组合这些能力。

选择合适的角色基类

PoBDSActor 提供可被蓝图访问的角色基础接口。PoBDSCharacterActor 在此之上封装整数移动、生命、体力、目标、阵营和基础战斗。PoBDSCharacterComponent 把角色与 Unity 对象、Agent 和固定步长更新连接起来。

分类已有能力示例
变换位置、整数毫米 XYZ、传送、朝向目标
生命 / 体力Health、MaxHealth、千分比生命值、护甲、伤害、治疗、复活、体力消耗与恢复
移动移动速度、能否移动、移动状态、到达 / 阻挡 / 禁用结果
感知 / 目标搜索半径、最近敌人、目标引用、距离、可见性回调
战斗 / 标记攻击范围、伤害、间隔、计数、角色标签

像引用对象一样读取属性

  1. 从角色引用开始

    添加自身角色、目标角色或 Actor 变量读取节点。角色引用不是一个“有目标”的布尔值。

  2. 按类型选择成员

    从 Actor 引脚搜索角色属性;或先加属性节点,再连接角色输入。检查器中的来源应说明使用的是外部连接,而不是另一个固定角色。

  3. 选择属性或方法

    在分类与搜索菜单中选择可用成员,不需要手填字符串猜测方法名。方法参数在调用 Action 的配置中绑定。

  4. 连接数值运算

    位置可作为 Vector3 输出;展开组件开关后出现 XYZ 输出。整数位置或距离与毫米阈值配合使用。

类型化输出与组件拆分:向量可展开 XYZ,颜色可展开 RGBA,连接时仍保持具体的数据类型。 · 点击查看原图

增加自己的角色属性

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 裁剪与代码保留。

支持多个关键词与 / 路径组合 · Enter 打开第一项 · Esc 关闭