关卡子弹

从 0 做的模块：关卡演出用的弹幕/弹道（非战斗伤害主链路）。 核心决策是不另造轮子——复用战斗子弹系统（FightBulletController）， 自己只做「编辑器配置 → 环境空怪承载 → 发射调度」这一层。 后续扩展空投类演出，再补上ID 合法性校验（出包前拦截配置错误）和配置预加载。

1. 工作清单

2. 理论：三层架构与 15 位 ID 编码

2.1 链路：编辑器 Action → 环境空怪 → 战斗子弹

2.2 TypeId 编码：把参数编码进 ID

15 位服务器子弹 ID 的分段：

3. 代码片段

3.1 TypeId 拼装 + 9501 兜底

Src\UniverseEditor\EditorCommon\Scheme\Action\LevelPlay.ts:2444-2482

function GetBulletIdFromInfo(EntityConfigId: number, BulletConfigId: number, BulletTypeId: number): number {
    // 确保CharTypeId是6位数字
    const CharTypeIdStr = EntityConfigId.toString().padStart(6, '0');
    // 确保BulletTypeId（子弹类型ID）是5位数字
    const BulletTypeIdStr = BulletConfigId.toString().padStart(5, '0');
    // SubBulletId默认使用0，确保是3位数字
    const SubBulletIdStr = '0'.padStart(3, '0');
    // Config使用BulletTypeId参数（0=子弹，1=发射器）
    const ConfigStr = BulletTypeId === 1 ? '1' : '0';
    const bulletIdStr = `${CharTypeIdStr}${BulletTypeIdStr}${SubBulletIdStr}${ConfigStr}`;
    return parseInt(bulletIdStr);
}

function fixServerBulletId(to: ILaunchBullet): number {
    let typeId = to.BulletDamageSourceType?.ConfigId ?? 0;
    if (to.BulletDamageSourceType.Type === EEnvDamageSourceType.Default && typeId === 0) {
        typeId = 9501;                                    // 默认环境怪配置ID
        to.BulletDamageSourceType.ConfigId = typeId;
    }
    const finalTypeId = to.BulletConfigId;
    if (finalTypeId === undefined || finalTypeId === 0) { return 0; }
    const bulletTypeId = GetBulletIdFromInfo(typeId, finalTypeId, to.BulletType ?? 0);
    to.BulletTypeId = bulletTypeId;
    return bulletTypeId;
}

3.2 保存期合法性校验：错误拦截在出包前

Src\UniverseEditor\EditorCommon\Scheme\Action\LevelPlay.ts:2415-2429

OnSchemeCheck: (value, messages): number => {
    let errorCount = 0;
    if (value.BulletTypeId <= 0) {
        messages.push(`子弹服务器Id计算错误: ${value.BulletTypeId}`);
        errorCount++;
    }
    // 检查子弹服务器ID长度是否为15位
    const bulletIdStr = value.BulletTypeId.toString();
    if (bulletIdStr.length !== 15) {
        messages.push(`子弹服务器Id长度错误: ${value.BulletTypeId} (应为15位)`);
        errorCount++;
    }
    errorCount += checkBulletConfigId(value, messages);   // DataTableRowExists 查表
    return errorCount;
},

3.3 运行时发射：桥接战斗子弹系统

Src\Game\AI\Environment\EnvMonsterController.ts:93-108

private CreateEnvBullet(
    typeId: number, customTarget: UE.Actor | undefined, configType: EFightBulletConfigType,
): bigint {
    const spawnerEntityId = ActorUtils.GetLocalEntityId(this.CurrentEnvMonster);
    const spawnerTypeId = ActorUtils.GetTypeId(this.CurrentEnvMonster);
    const targetEntityId = customTarget ? ActorUtils.GetLocalEntityId(customTarget) : 0;
    const createData: IBulletCreateData = {
        ConfigType: configType,
        TypeId: typeId,
        SpawnerInfo: new BulletSpawnerInfo(spawnerEntityId, spawnerTypeId, 0, 0),
        TargetEntityId: targetEntityId > 0 ? targetEntityId : undefined,
    };
    return ControllerHolder.FightBulletController.CreateBulletWithSync(createData);
}

3.4 预加载：查表成本前移到加载期

Src\Fight\FightModules\FightBullet\Config\BulletConfigManager.ts:109-146（节选）

/**
 * 预加载角色的子弹配置。已缓存则跳过。SubBullet 在此阶段就与 Actor 合并。
 * ctDataPath 为角色专属 CTDA 路径(空则引用通用);通用 CTDA 先于角色转换加载。
 */
public PreloadCharacterBullets(
    charTypeId: number,
    actorTable: UE.DataTable | undefined, emitterTable: UE.DataTable | undefined,
    subTable: UE.DataTable | undefined, ctDataPath: string | undefined,
): void {
    if (this.Cache.HasCharacter(charTypeId)) {
        BulletLog.Info(EBulletLogCategory.Config,
            `[BulletConfigManager] 角色子弹配置已缓存,跳过: CharTypeId=${charTypeId}`);
        return;
    }
    this.CacheCharacterTables(charTypeId, actorTable, emitterTable, subTable);
    const commonCtData = this.LoadCommonCtData();
    const roleCtData = this.LoadCharacterCtData(charTypeId, ctDataPath);
    const startTime = Date.now();
    const counts = this.LoadTables(charTypeId, actorTable, emitterTable, subTable, roleCtData, commonCtData);
    const elapsed = Date.now() - startTime;
    BulletLog.Key(EBulletLogCategory.Config,
        `[BulletConfigManager] 预加载角色子弹配置完成 CharTypeId=${charTypeId}, ` +
        `Actor=${counts.Actor}, Emitter=${counts.Emitter}, Sub=${counts.Sub}, Time=${elapsed}ms`);
}

4. 面试怎么讲