游戏客户端架构 / 系统课时
从玩法需求提炼配置字段
从玩法需求提炼配置字段
“敌人发现玩家后追击,靠近时攻击,精英怪攻击更快”看起来只是一句玩法描述,但真正落到配置表时,需要拆成实体、字段、枚举、引用和派生规则。拆分得当,配置才能稳定复用,而不是把自然语言直接搬进一堆含义模糊的列。
学习目标
- 从玩法描述中识别实体、可配置字段和引用关系
- 判断一个值应该存储、枚举化还是在运行时派生
- 为字段补齐类型、单位、约束和稳定命名
先找真正需要配置的实体
以“敌人发现玩家后追击,距离小于 2 米时攻击;精英怪攻击间隔更短”为例,先不要急着创建 isChasing、canAttack 之类字段。需求里至少存在敌人类型、攻击能力和行为规则三个概念,但并不意味着它们都要成为一张独立表。
第一步应识别拥有稳定身份、会被其他数据引用的对象。例如普通近战敌人与精英近战敌人可以是两个 EnemyProfile 配置实体;攻击动画或技能如果会被多种敌人复用,则适合作为独立 AttackProfile 被引用。

把描述词变成有语义的字段
字段不是“需求里出现一个词就建一列”。更可靠的方法是逐项判断这个值是否需要由内容人员调整、是否在不同实体之间变化,以及运行时能否直接计算出来。
例如攻击距离、移动速度和攻击间隔都可能随敌人类型变化,适合配置;distanceToTarget 则由敌人与目标当前位置计算得到,不应该反复写入静态配置表。
字段还要把单位写进命名或模式定义中。attackInterval 如果没有说明单位,调用方可能按毫秒理解,而配置人员按秒填写。使用 attackIntervalSeconds 会更明确。
枚举和引用解决重复字符串
当一个字段只允许有限集合时,应优先考虑枚举语义,而不是让配置人员填写任意文本。例如敌人等级只有 NORMAL、ELITE、BOSS 三种,就可以限制合法值,避免出现 Elite、elite_enemy 等多个同义写法。
当一组数据能够被多个实体复用时,则更适合建立引用。下面的 JSON 是一种项目自定义配置结构示例,不代表特定引擎格式:
{
"enemyId": "elite_swordsman",
"enemyTier": "ELITE",
"moveSpeedMetersPerSecond": 4.5,
"attackRangeMeters": 2.0,
"attackProfileId": "sword_slash_fast"
}attackProfileId 不直接复制攻击伤害、动画和攻击间隔,而是指向另一份稳定配置。验证时至少要检查 enemyTier 是否属于允许集合、三个数值字段是否在项目定义的合法范围内,以及 sword_slash_fast 是否确实存在。
配置加载成功后,可以在测试场景创建 elite_swordsman,确认移动速度和攻击距离来自该实体,并确认攻击行为解析到了 sword_slash_fast。这些检查比仅验证 JSON 能否解析更有意义。
派生值不要重复存储
配置设计中最容易制造不一致的问题,是同时保存原始值和可以从原始值计算出的结果。假设攻击范围配置为 2.0 米,就不应再保存一个 isInAttackRange。后者依赖敌人与目标的实时距离,本质上属于运行时状态。
同样,如果精英怪攻击速度只是普通攻击间隔乘以某个倍率,就要结合实际需求判断是否值得存两份结果。若项目需要直接独立调节每种攻击间隔,可以配置最终值;若所有精英怪都严格遵守统一倍率,则保存基础值与倍率,再由规则计算更容易保持一致。
用字段契约结束需求拆分
一个字段确定下来后,至少应该能回答名称、类型、单位、合法范围、默认策略和数据来源。仅有 speed、type、value1 这样的列名,还没有形成可靠的配置模型。
最终再从消费端反查一次:游戏运行时到底是谁读取这个字段,它在什么时机读取,缺失时应该失败还是使用默认值。能够明确回答这些问题,才说明需求已经从一句自然语言,收敛成了可以实现、校验和长期维护的数据契约。