# CodeX TODO

## Weapon 现状梳理

### 1. 数据层结构

- `Assets/GameMain/DataTables/Weapon.txt`
  - 武器基础数据表。
  - 当前 `Params` 列已经切换为标准 JSON 对象。
  - 约束：
    - 空参数统一写 `{}`
    - 不再兼容 `[]`
    - key 名应与对应 `ParamsData` 属性名一致

- `Assets/GameMain/Scripts/DataTable/DRWeapon.cs`
  - 负责解析武器表基础字段。
  - 保留两份参数视图：
    - `ParamsJson`
      - 原始 JSON 字符串，供 `WeaponData` 强类型反序列化使用。
    - `Pramas`
      - 由 `ParamsJson` 转成的 `Dictionary<string, string>`。
      - 仅用于描述/UI 等弱类型读取场景。

- `Assets/GameMain/Scripts/Entity/EntityData/Weapon/WeaponData.cs`
  - 保留所有武器共用字段：
    - `Attack`
    - `Cooldown`
    - `AttackRange`
    - `Price`
    - `Rarity`
    - `Modifiers`
    - `ParamsJson`
    - `Params`
  - 提供 `ParseParams<TParams>()` 作为武器子类的强类型参数解析入口。

- `Assets/GameMain/Scripts/Entity/EntityData/Weapon/*`
  - 每个具体武器子类持有自己的 `ParamsData`：
    - `WeaponKnifeData -> WeaponKnifeParamsData`
    - `WeaponHandgunData -> WeaponHandgunParamsData`
    - `WeaponSlashData -> WeaponSlashParamsData`
    - `WeaponLightningData -> WeaponLightningParamsData`

### 2. 逻辑层结构

- `Assets/GameMain/Scripts/Entity/EntityLogic/Weapon/WeaponBase.cs`
  - 武器统一基类。
  - 负责：
    - 生命周期
    - 状态机切换
    - 选敌
    - Simulation area/sector query 接入
    - 绑定玩家攻击属性

- 当前已有四种武器实现模板：
  - `WeaponKnife`
    - 近身前刺 + 圆形范围命中
  - `WeaponHandgun`
    - 单次 Raycast 瞬发命中
  - `WeaponSlash`
    - 扇形范围命中
  - `WeaponLightning`
    - 锁定目标点 + 落点范围打击

- 参数读取方式
  - 已改为在具体武器中直接读取对应 `ParamsData`
  - 不再在武器逻辑中手动解析字符串参数

### 3. 当前已接通的参数

- `WeaponKnifeParamsData`
  - `HitRadius`

- `WeaponHandgunParamsData`
  - 暂无字段，待扩展

- `WeaponSlashParamsData`
  - `SectorAngle`

- `WeaponLightningParamsData`
  - `HitRadius`
  - `HoverHeight`

### 4. 当前结构的优点

- 公共字段仍集中在 `WeaponData`，不会把通用逻辑拆散
- 武器专属参数已经强类型化，初始化更稳定
- 数据表可读性比旧的 KV 字符串格式更高
- 新武器扩展时，可以复用：
  - 表
  - `DRWeapon`
  - `WeaponData`
  - `WeaponBase`
  - AttackEffect
  - Simulation area/sector query

### 5. 当前结构的限制

- 仍然不是“纯配置驱动行为”
  - 行为差异主要还在具体武器类里
- `Handgun` 参数化程度还不够
  - 目前还不适合直接高效派生霰弹枪、狙击枪、 burst 枪
- `Pramas` 命名拼写仍保留旧名字
  - 目前为了兼容存量调用，暂不改

## Weapon 扩展计划

### P0: 稳定当前数据链路

- 检查 `Weapon.txt` 中全部行：
  - `Params` 必须都是 JSON 对象
  - 空参数统一为 `{}`
- 检查后续新增字段时：
  - 数据表 key 与 `ParamsData` 属性名保持一致
- 补一轮基础验证：
  - 商店描述
  - 玩家初始武器生成
  - 商店购买武器生成

### P1: 先把 Handgun 参数化做完整

目标：
- 把 `WeaponHandgun` 做成远程枪械母版，而不是只有一把“手枪”

建议新增参数：
- `PelletCount`
- `SpreadAngle`
- `PenetrationCount`
- `FireOriginOffsetX`
- `FireOriginOffsetY`
- `FireOriginOffsetZ`
- `HitMarkerSize`
- `HitMarkerYOffset`
- `HitMarkerDuration`

落地后可直接派生：
- 手枪
- 霰弹枪
- 狙击枪
- 三连发手炮

### P2: 优先做低成本高收益的新武器

优先顺序建议：

1. 长枪 / 刺剑
- 基于 `WeaponKnife`
- 重点调：
  - 前刺距离
  - 命中半径
  - 冷却

2. 大剑 / 半月斩
- 基于 `WeaponSlash`
- 重点调：
  - `SectorAngle`
  - 攻击范围
  - 动画时长

3. 战锤 / 震地锤
- 基于 `WeaponLightning` 或 `WeaponKnife`
- 重点调：
  - 落点半径
  - 前摇
  - 低频高伤

4. 霰弹枪
- 基于参数化后的 `WeaponHandgun`
- 重点调：
  - 散射
  - 多 pellet
  - 近距离爆发

5. 狙击枪
- 基于参数化后的 `WeaponHandgun`
- 重点调：
  - 单发高伤
  - 超远射程
  - 慢冷却

6. 陨石杖 / 圣光柱
- 基于 `WeaponLightning`
- 重点调：
  - `HoverHeight`
  - 爆炸半径
  - 冷却

### P3: 中成本扩展

1. 链式闪电
- 在首目标命中后，继续寻找附近目标
- 需要新增：
  - 连锁次数
  - 连锁半径
  - 每跳衰减

2. 穿透弹 / 火球
- 复用现有 projectile/simulation 基础
- 需要明确：
  - 穿透次数
  - 命中后是否爆炸

3. 地雷 / 陷阱
- 本质是延时触发 area hit
- 需要新增：
  - 布置后触发时机
  - 持续时间
  - 触发半径

4. 回旋镖
- 需要双阶段投射物状态
- 成本高于普通枪械/范围武器

### P4: 暂缓项

以下方向暂不建议优先投入：

- 持续激光
- 喷火器
- 环绕飞剑
- 常驻法球
- 冰冻/中毒/击退等状态驱动武器流派

原因：
- 当前武器框架核心仍是“单次攻击结算”
- 持续伤害与异常状态还没有形成统一挂点

## 新武器接入步骤模板

1. 在 `Weapon.txt` 新增一行
- 配好基础字段
- `Params` 写 JSON 对象

2. 新增 `WeaponType`
- 在 `Assets/GameMain/Scripts/Definition/Enum/WeaponType.cs`

3. 新增武器数据子类
- 新建 `WeaponXXXData`
- 新建 `WeaponXXXParamsData`
- 在构造里调用 `ParseParams<TParams>()`

4. 新增武器逻辑类
- 继承 `WeaponBase`
- 接入状态机
- 读取 `ParamsData`

5. 接入生成入口
- 玩家初始武器
- 商店购买武器
- 其他掉落/奖励入口

6. 验证点
- 武器生成正确
- 参数生效正确
- 描述文本正确
- Simulation 模式和非 Simulation 模式都能命中