ET框架数值组件设计解析：构建灵活复杂的游戏属性系统-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00050/article/details/148418787

ET框架数值组件设计解析：构建灵活复杂的游戏属性系统

ET Unity3D 客户端和 C# 服务器框架。项目地址: https://gitcode.com/gh_mirrors/et/ET

引言

在游戏开发中，尤其是MMORPG和MOBA类游戏，数值系统的设计至关重要。一个优秀的数值系统能够支撑起复杂的技能效果、属性加成和各种状态变化。ET框架提供了一套高度灵活的数值组件设计方案，完美解决了传统面向对象方法在处理复杂数值关系时的局限性。

传统数值设计方案的痛点

1. 类爆炸问题

在传统设计中，开发者通常会为每个角色类型创建单独的数值类：

class WarriorNumeric {
    public int Strength;
    // 战士特有属性...
}

class MageNumeric {
    public int Intelligence;
    // 法师特有属性...
}

这种设计会导致：

类数量随着角色类型增加而急剧膨胀
难以处理跨职业的通用属性
代码重复严重，维护困难

2. 属性计算复杂化

每个属性可能需要多个中间值参与计算，例如：

class Numeric {
    public int Speed;          // 最终速度
    public int SpeedBase;      // 基础速度
    public int SpeedAdd;       // 速度加成值
    public int SpeedPct;       // 速度百分比加成
    // 其他数十个属性...
}

这种设计存在明显缺陷：

需要为每个属性重复编写相似的计算逻辑
添加新属性时代码修改量大
难以统一处理属性变更事件

ET框架的数值组件设计

ET框架采用基于键值对的数值存储方案，完美解决了上述问题。

核心数据结构

public class NumericComponent : Component {
    public readonly Dictionary<int, int> NumericDic = new Dictionary<int, int>();
    
    // 其他方法...
}

这种设计的关键优势：

使用字典存储，避免定义大量字段
按需添加属性，不使用的属性不占用空间
统一的计算和事件机制

属性类型定义

public enum NumericType {
    Speed = 1000,
    SpeedBase = Speed * 10 + 1,
    SpeedAdd = Speed * 10 + 2,
    // 其他属性...
}

这种枚举设计实现了：

结构化属性ID分配
方便扩展新属性
清晰的属性关系表达

统一计算模型

ET框架采用五层计算模型：

最终值 = (((基础值 + 加成值) * (100 + 百分比) / 100) + 最终加成) * (100 + 最终百分比) / 100

这种模型的优势：

一套公式处理所有属性计算
支持多种叠加方式
计算过程透明可控

实际应用示例

1. 属性变更处理

当速度相关属性变化时：

// 增加基础速度
numericComponent[NumericType.SpeedBase] = 100;

// 增加20%速度加成
numericComponent[NumericType.SpeedPct] = 20;

系统会自动触发计算并更新最终速度值。

2. 属性变更监听

可以轻松监听特定属性的变化：

[NumericWatcher(NumericType.Hp)]
public class HpWatcher : INumericWatcher {
    public void Run(long id, int value) {
        if (value > 1000) {
            // 处理血量超过1000的逻辑
        }
    }
}

这种监听机制非常适合用于：