游戏引擎 / 系统课时

把配置数据从组件代码移开

把配置数据从组件代码移开

武器伤害散落在多个组件的常量里,调整平衡时容易漏改。本节把稳定配置放进独立模块,由行为函数接收配置和当前状态,演示数据与计算分离后的修改入口,同时明确只读声明、运行状态和外部配置的可信边界。

学习目标

  • 识别静态配置与动态角色状态。
  • 从独立模块导入有类型的配置。
  • 让行为接收配置,避免隐藏硬编码依赖。

配置描述规则参数

武器 id、基础伤害和冷却时间属于规则参数,当前血量和剩余冷却属于运行状态。两者分开后,可以替换一份配置而不改行为实现,也不会把本次战斗的修改写回所有角色共享的参数对象。

配置模块应避免读取节点、注册事件或直接开始战斗。它只导出数据和结构,使依赖它的纯逻辑保持可独立检查。小型固定配置可以直接写 TypeScript;来自 JSON 的配置则要经过解析与校验,不能用接口直接保证外部内容有效。

用三文件传递明确依赖

三个文件构成完整纯 TypeScript 主例程。文件:weaponConfig.ts。

ts
export interface WeaponConfig {
    readonly id: string;
    readonly damage: number;
}
// 共享的是稳定参数,不是本次战斗状态。
export const sword: WeaponConfig = { id: 'sword', damage: 20 };

该模块仅导出配置,生效行为由调用方验证。文件:combat.ts。

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。

ts
import { sword } from './weaponConfig';
import { remainingHp } from './combat';
let hp = 50;
hp = remainingHp(hp, sword);
// 血量变化不修改配置伤害。
console.log(`${sword.id}:${hp}|damage:${sword.damage}`);

预期输出:

text
sword:30|damage:20

把改动集中到数据入口

若要把伤害调整为 25,只改 weaponConfig.ts,再重新检查并运行,血量应相应变化。若需要按难度生成参数,可以由配置选择函数返回对应配置,不要让每个组件分别根据字符串难度计算一次,导致规则不一致。

readonly 表达静态赋值约束,不等于运行时冻结。共享对象还可能通过其他别名被修改;确实需要冻结时,应考虑 Object.freeze 与嵌套数据边界。不要在组件里临时改 sword.damage 作为技能加成,加成应成为单次计算输入或独立运行状态。

给接入保留简单验证

Creator 组件可以在 start 读取配置,在真实命中事件里调用 remainingHp,再更新显示;本例不依赖引擎 API,因此无需为验证配置关系挂载场景。若配置文件位置改变,先修正相对导入,再检查所有引用入口,避免出现复制的旧配置。

练习再导出一份 bow 配置,让同一函数计算两种武器命中。检查不同调用只受传入配置影响,不依赖模块里某个隐藏“当前武器”。结构和只读规则见 TypeScript 对象类型,模块边界见 模块手册。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把配置数据从组件代码移开

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通