tanqiu/assets/resources/data/excel/方块武器配置/字段说明文档.md

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

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时请勿更改表头字段名。
• 字段值需符合类型和可选值要求。
• 资源路径需与实际项目资源一致。
• 可根据实际需求扩展字段，但需同步更新说明文档。