游戏引擎 / 系统课时
把配置数据从组件代码移开
把配置数据从组件代码移开
武器伤害散落在多个组件的常量里,调整平衡时容易漏改。本节把稳定配置放进独立模块,由行为函数接收配置和当前状态,演示数据与计算分离后的修改入口,同时明确只读声明、运行状态和外部配置的可信边界。
学习目标
- 识别静态配置与动态角色状态。
- 从独立模块导入有类型的配置。
- 让行为接收配置,避免隐藏硬编码依赖。
配置描述规则参数
武器 id、基础伤害和冷却时间属于规则参数,当前血量和剩余冷却属于运行状态。两者分开后,可以替换一份配置而不改行为实现,也不会把本次战斗的修改写回所有角色共享的参数对象。
配置模块应避免读取节点、注册事件或直接开始战斗。它只导出数据和结构,使依赖它的纯逻辑保持可独立检查。小型固定配置可以直接写 TypeScript;来自 JSON 的配置则要经过解析与校验,不能用接口直接保证外部内容有效。
用三文件传递明确依赖
三个文件构成完整纯 TypeScript 主例程。文件:weaponConfig.ts。
export interface WeaponConfig {
readonly id: string;
readonly damage: number;
}
// 共享的是稳定参数,不是本次战斗状态。
export const sword: WeaponConfig = { id: 'sword', damage: 20 };该模块仅导出配置,生效行为由调用方验证。文件:combat.ts。
import type { WeaponConfig } from './weaponConfig';
export function remainingHp(hp: number, weapon: WeaponConfig): number {
// 对开放的调用边界检查业务范围。
if (!Number.isFinite(hp) || hp < 0 || !Number.isFinite(weapon.damage)
|| weapon.damage < 0) throw new Error('invalid combat data');
return Math.max(0, hp - weapon.damage);
}函数不持有场景状态。文件:main.ts,把三个文件一起 strict 编译后运行 dist/main.js。
import { sword } from './weaponConfig';
import { remainingHp } from './combat';
let hp = 50;
hp = remainingHp(hp, sword);
// 血量变化不修改配置伤害。
console.log(`${sword.id}:${hp}|damage:${sword.damage}`);预期输出:
sword:30|damage:20把改动集中到数据入口
若要把伤害调整为 25,只改 weaponConfig.ts,再重新检查并运行,血量应相应变化。若需要按难度生成参数,可以由配置选择函数返回对应配置,不要让每个组件分别根据字符串难度计算一次,导致规则不一致。
readonly 表达静态赋值约束,不等于运行时冻结。共享对象还可能通过其他别名被修改;确实需要冻结时,应考虑 Object.freeze 与嵌套数据边界。不要在组件里临时改 sword.damage 作为技能加成,加成应成为单次计算输入或独立运行状态。
给接入保留简单验证
Creator 组件可以在 start 读取配置,在真实命中事件里调用 remainingHp,再更新显示;本例不依赖引擎 API,因此无需为验证配置关系挂载场景。若配置文件位置改变,先修正相对导入,再检查所有引用入口,避免出现复制的旧配置。
练习再导出一份 bow 配置,让同一函数计算两种武器命中。检查不同调用只受传入配置影响,不依赖模块里某个隐藏“当前武器”。结构和只读规则见 TypeScript 对象类型,模块边界见 模块手册。