# game_feedback_template.md

用途：在输入基本游戏需求后，继续定义“游戏反馈”。这份模板会被文字模型转换为 `feedback_spec.json`，再约束 `animation_manifest.json` 里必须生成哪些角色动画、UI 动效、粒子特效和 UI 美术。

## 1. 总体手感

- 游戏反馈关键词：
  - 例：果冻感、弹性、明亮、轻快、中奖很爽、点击即时
- 反馈节奏：
  - 点击反馈延迟：不超过 80ms
  - 普通中奖反馈：约 0.6-1.2 秒
  - 大奖反馈：约 1.8-3.5 秒
- 反馈强度层级：
  - micro：点击、切换、数值轻变
  - normal_win：普通中奖
  - big_win：大奖、高倍赔付
  - bonus：免费旋转、特殊模式
- 禁止事项：
  - 例：不要长时间阻塞、不要暗黑闪烁、不要每次都满屏爆炸

## 2. 玩家操作反馈

| 操作 | 触发条件 | 视觉反馈 | 动效 | 特效 | 声音占位 | 时长 |
|---|---|---|---|---|---|---:|
| 点击 Spin | player_taps_spin_button | 按钮压缩、发光一下 | spin_btn_press | 无 | soft_pop | 180ms |
| 加减下注 | player_taps_bet_plus_or_minus | 数字弹一下、HUD 高亮 | balance_roll / pulse | 无 | tick | 220ms |
| 开启自动旋转 | auto_spin_enabled | 自动按钮持续呼吸 | pulse | 无 | toggle_on | -1 |
| 打开设置 | open_settings | 面板从下滑入 | panel_slide_in | 无 | panel_open | 300ms |

## 3. 玩法事件反馈

| 事件 | 触发条件 | 视觉反馈 | 角色动画 | UI 动效 | 特效 | 声音占位 | 时长 | 是否阻塞点击 |
|---|---|---|---|---|---|---|---:|---|
| 开始转轮 | spin_started | 转轮框变暗、符号开始模糊滚动 | 无 | panel_slide_in | 无 | reel_start | 300ms | 是 |
| 停轮无奖 | no_payout | 转轮恢复亮度、Spin 按钮恢复 | idle | scale_bounce | 无 | reel_stop | 300ms | 否 |
| 普通中奖 | payout_greater_than_bet | 命中符号弹跳、中奖金额滚动 | win | scale_bounce / number_roll | win_burst | win_small | 900ms | 否 |
| 大奖 | payout_at_least_10x_bet | 大奖弹窗、金币雨、角色庆祝 | win | reward_popup_in / number_roll / win_icon_pulse | coin_rain / bigwin_glow / confetti_pop | win_big | 2400ms | 是 |
| 免费旋转 | free_spin_unlocked | 免费旋转徽章弹出、背景变亮 | win | elastic_in / pulse | confetti_pop / bigwin_glow | bonus_unlock | 1800ms | 是 |

## 4. 状态与错误反馈

| 状态 | 触发条件 | 视觉反馈 | 动效 | 特效 | 声音占位 | 时长 |
|---|---|---|---|---|---|---:|
| 余额不足 | spin_blocked_by_low_balance | 余额栏轻微抖动、Spin 变灰 | scale_bounce | 无 | error_soft | 320ms |
| 网络等待 | request_pending | Spin 按钮 loading、HUD 降低亮度 | pulse | 无 | wait_loop | -1 |
| 网络失败 | request_failed | 顶部提示条滑入、按钮恢复 | panel_slide_in | 无 | error_soft | 1200ms |

## 5. 输出约束

文字模型生成 `feedback_spec.json` 时必须遵守：

- 每个反馈事件都有 `id`、`trigger`、`visual`、`duration_ms`。
- 只使用当前可落地的 UI 动效：`scale_bounce`、`elastic_in`、`fade_slide_in`、`number_roll`、`pulse`。
- 只使用当前可落地的粒子：`coin_rain`、`win_burst`、`bigwin_glow`、`confetti_pop`。
- 角色动画只用当前支持的：`idle`、`win`。
- 大奖和 bonus 可以阻塞输入，micro 和普通中奖尽量不阻塞。
- 不要设计复杂镜头、3D 摄像机、真实物理破碎等当前 Cocos 2D 原型无法稳定实现的效果。