# 方块武器配置字段说明文档

## 1. weapons.csv 字段说明

| 字段名 | 含义 | 类型 | 说明/可选值 |
|--------|------|------|-------------|
| id | 武器唯一标识 | string | 英文ID，唯一 |
| name | 武器名称 | string | 中文名 |
| type | 武器类型 | string | single_shot, piercing, ricochet_piercing, explosive, boomerang, area_burn, shotgun, homing_missile 等 |
| rarity | 稀有度 | string | common, uncommon, rare, epic |
| weight | 抽取权重 | number | 用于随机抽取概率 |
| damage | 基础伤害 | number | 单次攻击基础伤害 |
| fireRate | 攻击频率 | number | 每秒攻击次数 |
| range | 攻击范围 | number | 单位：像素或格 |
| bulletSpeed | 子弹速度 | number | 单位：像素/秒 |
| accuracy | 命中精度 | number | 0~1，越高越准 |
| bulletType | 子弹类型 | string | single, spread, burst 等 |
| bulletAmount | 子弹数量 | number | 一次发射的子弹数 |
| spreadAngle | 散射角度 | number | 单位：度 |
| burstCount | 连发数量 | number | burst模式下的连发数 |
| burstDelay | 连发间隔 | number | 单位：秒 |
| trajectoryType | 弹道类型 | string | straight, arc, homing_arc |
| bulletSpeed | 子弹速度 | number | 单位：像素/秒 |
| gravity | 重力影响 | number | 仅arc弹道有效 |
| arcHeight | 抛物线高度 | number | 仅arc弹道有效 |
| homingStrength | 导弹追踪强度 | number | 仅homing弹道有效 |
| homingDelay | 追踪延迟 | number | 仅homing弹道有效 |
| hitEffectType | 命中效果类型 | string | normal_damage, pierce_damage, explosion, ground_burn, ricochet_damage 等 |
| hitEffectDamage | 命中伤害 | number | 命中时造成的伤害 |
| hitEffectRadius | 效果半径 | number | 范围伤害半径 |
| hitEffectDuration | 效果持续时间 | number | 持续型效果时长 |
| lifecycleType | 生命周期类型 | string | hit_destroy, range_limit, ricochet_counter, ground_impact, return_trip, ground_impact_with_effect, target_impact |
| maxLifetime | 最大存活时间 | number | 单位：秒 |
| penetration | 穿透数 | number | 可穿透敌人数 |
| ricochetCount | 弹射次数 | number | 可弹射的最大次数 |
| returnToOrigin | 是否回弹 | bool | boomerang等武器专用 |
| bulletPrefab | 子弹预制体路径 | string | 资源路径 |
| hitEffect | 命中特效路径 | string | 资源路径 |
| trailEffect | 子弹拖尾特效路径 | string | 资源路径 |
| muzzleFlash | 枪口火焰特效路径 | string | 资源路径 |
| weaponSprite1x1 | 1x1尺寸武器图标 | string | 资源路径 |
| weaponSprite1x2 | 1x2尺寸武器图标 | string | 资源路径 |
| weaponSprite2x1 | 2x1尺寸武器图标 | string | 资源路径 |
| weaponSprite2x2 | 2x2尺寸武器图标 | string | 资源路径 |
| fireSound | 开火音效 | string | 资源路径 |

## 2. blockSizes.csv 字段说明

| 字段名 | 含义 | 说明 |
|--------|------|------|
| blockSize | 方块尺寸 | 可选值：1x1, 1x2, 2x1, 2x2 |

## 3. rarityWeights.csv 字段说明

| 字段名 | 含义 | 说明/可选值 |
|--------|------|-------------|
| rarity | 稀有度 | common, uncommon, rare, epic |
| weight | 权重 | 用于随机抽取概率 |

## 4. bulletEffectTypes.csv 字段说明

| 字段类型 | 可选值 |
|----------|--------|
| count | single, spread, burst |
| trajectory | straight, arc, homing_arc |
| hitEffects | normal_damage, pierce_damage, explosion, ground_burn, ricochet_damage |
| lifecycle | hit_destroy, range_limit, ricochet_counter, ground_impact, return_trip, ground_impact_with_effect, target_impact |

---
1. count (计数/发射方式)
控制武器如何发射子弹：
single: 单发 - 每次射击只发射一颗子弹
spread: 散射 - 一次射击发射多颗子弹，呈扇形散开（如霰弹枪）
burst: 连发 - 一次射击连续快速发射多颗子弹（如冲锋枪短点射）
2. trajectory (弹道/轨迹)
控制子弹的飞行路径：
straight: 直线 - 子弹沿直线飞行
arc: 弧线 - 子弹沿抛物线飞行，受重力影响
homing_arc: 追踪弧线 - 子弹沿弧线飞行并能追踪目标
3. hitEffects (命中效果)
控制子弹命中目标后的效果：
normal_damage: 普通伤害 - 标准伤害效果
pierce_damage: 穿透伤害 - 子弹可穿透多个目标
explosion: 爆炸 - 命中后发生爆炸，范围伤害
ground_burn: 地面燃烧 - 在地面留下燃烧效果
ricochet_damage: 跳弹伤害 - 子弹会反弹并再次造成伤害
4. lifecycle (生命周期)
控制子弹何时消失：
hit_destroy: 命中销毁 - 命中任何物体后立即消失
range_limit: 射程限制 - 达到最大射程后消失
ricochet_counter: 跳弹计数 - 反弹有限次数后消失
ground_impact: 落地 - 受重力影响最终落地
return_trip: 返回 - 达到目标后返回发射点
ground_impact_with_effect: 落地带效果 - 落地后触发额外效果
target_impact: 目标命中 - 命中预定目标后消失
这些属性组合使用可以创建各种不同的武器效果，比如：
穿透型武器：pierce_damage + range_limit
爆炸型武器：explosion + ground_impact
回旋镖武器：pierce_damage + return_trip
追踪导弹：explosion + target_impact + homing_arc

### 使用建议
- 编辑CSV时请勿更改表头字段名。
- 字段值需符合类型和可选值要求。
- 资源路径需与实际项目资源一致。
- 可根据实际需求扩展字段，但需同步更新说明文档。