燃值

正正考核期 0 做的世界进度玩法：燃值积累条 + 燃值点（FirePoint）。 积累条是团队协作数值——三层加成（团队人数/战斗人数/安全区人数）全走配置表； 燃值点消耗完全在战斗服（Buff 体系），客户端零扣减逻辑。 页面虽小，但把「数值配置化 + 服务器权威边界」两件事做得很干净。

1. 工作清单

2. 理论：三层加成模型与职责边界

2.1 积累速率：三层加成的叠加结构

加成层数 → 每跳增加量：查 fire_point_gather_layer_value 数组表（层号即下标）。 客户端每 3 秒一跳把增加量累进 fireGatherValue，到 fire_point_max_gather_value 封顶。

2.2 职责切分：客户端算速率，服务器管一切权威值

3. 代码片段

3.1 三层加成计算：每层独立钳制 + 总钳制

Src\Game\Module\FirePoint\FirePointModel.ts:95-131（节选）

public UpdateFirePointGatherValue(): void {
    if (this.FirePointInfo === undefined) { return; }

    // 人数加成：团队人数越多，加成层数越高（最多4层）
    const playerCount = ModelManager.TeamModel?.GetTeamMemberNum();
    if (playerCount === undefined) { return; }

    this.AddLayer = 0; // 重置加成层数

    if (this.FirePointInfo.isAllTeamMemberInSameLevel) {
        if (playerCount > 1) {
            const param0 = configCommonParamById.GetIntConfig('max_fire_layer_limit_of_team_member')!;
            this.AddLayer += Math.min(playerCount, param0);
        }

        // 战斗中玩家加成：每个战斗中的玩家提供额外加成
        const battleMemberCount = this.CountOfBattleMember();
        const param1 = configCommonParamById.GetIntConfig('fire_point_battle_member_add_layer')!;
        this.AddLayer += battleMemberCount * param1;

        // 安全区中玩家加成：每个安全区中的玩家提供额外加成（限制最大4层）
        const safeZoneMemberCount = this.CountOfSafeZoneMember();
        const param2 = configCommonParamById.GetIntConfig('fire_point_safe_zone_member_add_layer')!;
        const param7 = configCommonParamById.GetIntConfig('max_fire_layer_limit_of_safe_zone_member')!;
        const safeZoneAddition = safeZoneMemberCount * param2;
        this.AddLayer += Math.min(safeZoneAddition, param7);
    }

    // 最终加成层数不能超过配置上限
    const param3 = configCommonParamById.GetIntConfig('fire_point_gather_max_layer')!;
    this.AddLayer = Math.min(this.AddLayer, param3);
    ...
}

3.2 层数查表 + 上限封顶

Src\Game\Module\FirePoint\FirePointModel.ts:133-167

    // 根据加成层数增加燃值积累
    const param4 = configCommonParamById.GetIntArrayConfig('fire_point_gather_layer_value')!;
    if (this.FirePointInfo && this.AddLayer < param4.length) {
        const add = param4[this.AddLayer];
        this.FirePointInfo.fireGatherValue += add; //速率
    }

    // 检查是否达到燃值上限，达到则重置并标记需要分配燃值点
    const param5 = configCommonParamById.GetIntConfig('fire_point_max_gather_value')!;
    if (this.FirePointInfo && this.FirePointInfo.fireGatherValue >= param5) {
        this.FirePointInfo.fireGatherValue = param5; // 重置燃值积累到上限
    }
}

public GetFirePointGatherValue(): number {
    if (!this.FirePointInfo) { return 0; }
    const param5 = configCommonParamById.GetIntConfig('fire_point_max_gather_value')!;
    if (this.FirePointInfo.fireGatherValue >= param5) {
        return 1; // 返回上限值
    }
    return this.FirePointInfo.fireGatherValue / param5;
}

3.3 通知正发：Controller 薄得只有正发

Src\Game\Module\FirePoint\FirePointController.ts:31-48

// 燃值累计值更新通知
private readonly OnFirePointGatherValueNotify = (notify: Game.Protocol.WorldFirePointGatherValueSCNotify): void => {
    const firePointInfo = ModelManager.FirePointModel!.GetInfo();
    if (firePointInfo) {
        firePointInfo.fireGatherValue = notify.fireGatherValue;
        firePointInfo.banFirePointCount = notify.banFirePointCount;
        firePointInfo.isAllTeamMemberInSameLevel = notify.isAllTeamMemberInSameLevel;
        EventSystem.Emit(EEventName.FirePointGatherValueChange);
    }
};

private readonly OnFirePointTeamMemberInfoNotify = (
    notify: Game.Protocol.WorldFirePointTeamMemberInfoSCNotify,
): void => {
    ModelManager.FirePointModel?.SetMemberInfo(notify.fireTeamMemberInfo);
};

3.4 UI 面板：3 秒定时器 + 事件双驱动

Src\Game\Module\MainUi\Views\ChildView\BattleUiFirePanel.ts:47-60, 94-100（节选）

protected override OnStart(): void {
    super.OnStart();
    this.Refresh();
    this.RefreshTimer = this.OwnedTimers.Forever(this.OnTimerRefresh, 3000, 'FirePanelView.OnStart');
}

private readonly OnTimerRefresh = (): void => {
    if (ModelManager.FirePointModel === undefined) { return; }
    ModelManager.FirePointModel.UpdateFirePointGatherValue();   // 通道1：定时器推进积累
    this.Refresh();
};

private readonly FirePointGatherValueChange = (): void => {
    this.Refresh();                                                    // 通道2：服务器通知立刻刷
};

private Refresh(): void {
    if (ModelManager.FirePointModel === undefined) { return; }
    const firePointValue = ModelManager.FirePointModel.GetFirePointGatherValue();
    this.BarFlame?.SetFillAmount(firePointValue);
}

4. 面试怎么讲