游戏客户端架构 / 系统课时
配置、代码和资源怎么分工
配置、代码和资源怎么分工
数据驱动项目最容易出现的问题,是把规则、数值、图片路径和玩家当前状态全部塞进同一份配置。本节把它们拆成配置、代码、资源和运行时状态四种职责,并给出一套可以直接用于设计字段的边界方法。
学习目标
- 区分配置、代码、资源和运行时状态的职责
- 设计只保存稳定数据与资源引用的配置结构
- 避免把程序流程或实时状态错误地写进配置
四类内容解决的是不同问题
配置回答“这个对象有哪些可调整参数”,代码回答“游戏规则怎样执行”,资源提供贴图、模型、音频和特效等实际内容,运行时状态则记录“这一刻发生了什么”。
例如一把武器可以在配置中定义攻击力为 80、攻击间隔为 0.7 秒,并通过资源 ID 引用模型;攻击是否合法、伤害怎样结算由代码处理;玩家当前剩余弹药则只存在于本局运行时状态或存档中。

配置保存参数和引用
一份职责清晰的武器配置可以写成下面这样:
{
"id": "weapon_rifle_01",
"damage": 80,
"attackIntervalSeconds": 0.7,
"magazineSize": 30,
"modelResourceId": "model_rifle_01",
"fireSoundResourceId": "audio_rifle_fire_01"
}这里的数字可以由策划调整,资源字段保存的是稳定标识,而不是把模型或音频本身塞进配置。配置加载后,应验证 id 唯一、数值范围合法,并确认 modelResourceId 与 fireSoundResourceId 能在资源系统中解析到真实资源;验证通过后,运行时对象才能据此初始化。
如果项目需要更换资源目录、改用资源包或切换远端资源系统,只要资源 ID 的解析层保持稳定,配置本身就不需要跟着存储方式变化。
代码负责不可被数据替代的规则
代码应该掌握具有执行语义的内容,例如攻击前检查弹药、计算暴击、处理护盾、更新冷却以及触发状态迁移。这些规则往往存在条件、顺序和异常处理,如果全部转成配置字段,最终会得到一套缺少类型检查和调试能力的“自制脚本语言”。
配置可以选择已有规则,例如 attackMode 取 single 或 burst,前提是两种模式已经由代码实现。配置负责选择和调参,而不是重新描述攻击算法。
资源和运行时状态都不要混进静态表
图片、模型、动画和声音属于资源系统。配置可以保存资源 ID,但资源文件本身应由资源管线管理,否则版本、加载、压缩和平台差异都会与业务配置耦合。
运行时状态则更容易误放。magazineSize 是武器模板的弹匣容量,适合配置;currentAmmo 是玩家此刻还剩多少发子弹,属于运行时状态。类似地,角色的 maxHp 可以来自配置,而 currentHp 应保存在角色实例或存档中。
判断一个字段时,可以依次问:它是在描述可调参数、执行规则、资源实体,还是这一局游戏中的当前值。前四者分别落到配置、代码、资源系统和运行时状态。边界明确后,修改数值不会碰逻辑,更换资源不会污染规则,保存游戏也不会反向修改静态配置。