Skip to content

数据相关

实体属性相关的数据体系,是 CraneAttribute 的核心数据结构。

属性数据 (AttributeData)

每个生物拥有一个 AttributeData 对象,负责管理该生物的全部属性。它内部包含:

  • 属性源集合:所有生效的属性来源(装备、技能、默认配置等)
  • 计数器注册表 (CounterRegistry):存储自定义的临时数据
  • 元数据 (metadata):运行时可读写的键值对存储
  • 缓存视图:预计算的属性值、战斗力,供高频读取

详见 属性数据

属性源 (AttributeSource)

属性源是属性值的容器。每个属性源由 源名属性值百分比属性值 组成,可选附带 条件(如等级需求)。

属性源的特性可能包括:

  • Persistable:可持久化到数据库
  • Conditional:附有触发条件
  • Declarative / Literal:无条件直接生效
  • Mappable:包含可映射属性

详见 属性源

计数器 (Counter)

每个实体的 CounterRegistry 中可以注册多个 Counter,用于存储自定义数值和文本数据(如连击计数、技能冷却标记等)。计数器支持设置重置触发器(死亡重置、换世界重置等)。

详见 计数器