# 老虎เกมสล็อต玩法配置工作流

目标：让用户通过点选和少量填写，定义一款有特色的竖屏电子游戏；系统再把玩法配置转换为 `feedback_spec.json`、`animation_manifest.json`、自动生图和 Cocos 原型包。

注意：本流程默认用于 `demo_only` 娱乐原型。真实货币 slot 需要独立的 RTP 数学、随机数、审计、地区合规和牌照流程，不在当前自动化范围内。

## 1. 调研结论：常见 slot 玩法模块

主流玩法可以拆成几个可组合模块：

| 模块 | 说明 | 适合做什么体验 |
|---|---|---|
| 固定赔线 `paylines` | 按固定线型从左到右判断中奖 | 经典、容易理解 |
| Ways `ways` | 不看具体线，只看相邻转轴是否有同符号 | 现代、命中更频繁 |
| Megaways `megaways` | 每轴行数随机变化，形成大量 ways | 变化感强、波动更大 |
| Cluster Pays `clusterPays` | 网格里相邻同符号成团中奖 | 消除感、适合移动端大格子 |
| Cascades `cascades` | 中奖符号消失，新符号下落，可连锁 | 节奏爽、容易做连续反馈 |
| Wilds `wilds` | 万能符替代普通符号，可扩展/粘住/带倍数 | 增加期待和爆点 |
| Scatter Free Spins | 散布符任意位置触发免费旋转 | 最常见 bonus 入口 |
| Hold & Win / Respins | 金币/现金符锁定，重置 respin，冲 jackpot | 强目标感，适合大奖玩法 |
| Pick Bonus | 进入选择奖励小游戏 | 互动感强，但需要额外 UI |
| Multipliers | 连锁或 wild 带倍数 | 让小玩法有大结果 |

## 2. 推荐的用户配置向导

网页上不要让用户直接写完整 JSON。建议分 8 步表单。

### Step 1 基本信息

用户填写：

- 游戏名
- 主题：糖果 / 埃及 / 海盗 / 水果 / 赛博 / 动物 / 自定义
- 画风：3D 果冻 / 扁平卡通 / 奢华金属 / 霓虹科幻 / 自定义
- 目标：轻松频繁中奖 / 大奖刺激 / 连锁爽感 / bonus 丰富
- 模式：默认 `demo_only`

输出到配置：

```json
{
  "game": {
    "id": "jelly-candy-slot",
    "title": "Jelly Candy Slot",
    "mode": "demo_only",
    "orientation": "portrait"
  },
  "theme": {
    "world": "jelly candy land",
    "visualStyle": "cute 3D jelly mobile game"
  }
}
```

### Step 2 选择基础转轮模式

四选一：

| 选择 | 自动配置 |
|---|---|
| 经典赔线 | `reels.mode = paylines`，5x3，25 lines |
| 高命中 Ways | `reels.mode = ways`，5x3，243 ways |
| 变化型 Megaways | `reels.mode = megaways`，6 reels，2-7 rows |
| 消除型 Cluster | `reels.mode = clusterPays`，6x5，5 连成团 |

第一版建议默认选 `ways + cascades`，因为它最容易做出“好玩”和“有反馈”的感觉。

### Step 3 选择波动风格

用户只选体验，不填复杂数学：

| 选择 | 表现 | 自动倾向 |
|---|---|---|
| 低波动 | 经常小奖 | 高 hit feel，小倍数 |
| 中波动 | 小奖和大奖平衡 | 默认推荐 |
| 高波动 | 很久不出，一出很大 | bonus 和 multiplier 更重 |

配置字段：

```json
{
  "mathProfile": {
    "volatility": "medium",
    "hitFrequencyFeel": "medium",
    "maxWinMultiplier": 5000,
    "rtpTargetLabel": "demo_not_certified"
  }
}
```

### Step 4 选择特殊符号

用复选框：

- Wild
- Scatter
- Cash Coin
- Collect
- Bonus
- Multiplier Wild

每个符号都会反向要求 manifest 生成对应美术素材。

### Step 5 选择核心特色玩法

推荐做成“最多选 2 个主特色 + 1 个辅助特色”，避免玩法堆太多。

主特色：

- 连锁下落 Cascades
- 免费旋转 Free Spins
- Hold & Win
- Megaways
- Cluster Pays

辅助特色：

- 扩展 Wild
- 粘性 Wild
- 倍数递增
- 随机变色/变符号
- Jackpot 徽章

组合推荐：

| 方案 | 组合 | 风格 |
|---|---|---|
| 新手稳妥 | Ways + Free Spins + Expanding Wild | 易懂、产出稳定 |
| 爽感连锁 | Ways + Cascades + Multiplier | 连击反馈强 |
| 大奖目标 | Paylines/Ways + Hold & Win + Cash Coin | 大奖期待强 |
| 变化刺激 | Megaways + Cascades + Free Spins | 现代、高波动 |
| 消除休闲 | Cluster Pays + Cascades + Multiplier | 更像休闲消除 |

### Step 6 定义反馈强度

用户选整体手感：

- 克制：少特效，重清晰
- 标准：中奖有反馈，大奖明显
- 夸张：金币雨、弹窗、彩纸多

映射到：

```json
{
  "feedback": {
    "overallFeel": "elastic, bright, satisfying, not too noisy",
    "intensity": {
      "tap": "micro",
      "smallWin": "normal_win",
      "bigWin": "big_win",
      "bonus": "bonus"
    }
  }
}
```

### Step 7 选择自动生成的资产范围

用户选择：

- 角色/符号数量：6 / 8 / 10 / 12
- UI 美术：基础 / 完整
- 特效数量：基础 2 个 / 完整 4 个
- 是否生成 logo
- 是否生成 Cocos 演示场景

### Step 8 生成与校验

系统输出：

```text
slot_game_config.json
  -> feedback_spec.json
  -> asset_plan.json
  -> animation_manifest.json
  -> 生图
  -> Cocos 包
```

## 3. 完整配置结构

完整模板见：

[slot_game_config_template.json](slot_game_config_template.json)

核心字段：

```json
{
  "game": {},
  "theme": {},
  "reels": {},
  "mathProfile": {},
  "symbols": {},
  "paytable": {},
  "features": {},
  "playerControls": {},
  "feedback": {},
  "assetGeneration": {}
}
```

## 4. 配置到 manifest 的转换规则

### 4.1 `theme` -> manifest.style

```text
theme.world + theme.visualStyle + palette + avoid
```

生成全局 `style`。

### 4.2 `symbols` -> manifest.characters

普通符号、高价值符号、wild、scatter、cash、collect 都先作为 `characters` 生成，因为当前管线最稳定的是“单图 -> Spine 三件套”。

```json
{
  "id": "wild",
  "type": "spine",
  "animations": ["idle", "win"],
  "prompt": "a glossy rainbow jelly wild symbol icon, mobile slot game asset, centered, no text"
}
```

### 4.3 `features` + `feedback` -> manifest.vfx / manifest.ui

如果启用：

- `cascades`：需要 `win_burst`
- `scatterFreeSpins`：需要 `confetti_pop`、`bigwin_glow`
- `holdAndWin`：需要 `coin_rain`、`bigwin_glow`
- `big_win` 反馈：需要 `coin_rain`、`confetti_pop`

### 4.4 `assetGeneration.uiArt` -> manifest.ui_art

固定 UI 资产：

- `bg_main`
- `logo`
- `reel_frame`
- `btn_spin`
- `btn_round`
- `hud_pill`
- `win_popup`
- `free_spin_badge`

## 5. 推荐默认配置

第一版建议默认：

```json
{
  "reels": { "mode": "ways", "columns": 5, "rows": 3 },
  "features": {
    "wilds": { "enabled": true, "variant": "expanding" },
    "scatterFreeSpins": { "enabled": true },
    "cascades": { "enabled": true },
    "holdAndWin": { "enabled": false }
  },
  "mathProfile": {
    "volatility": "medium",
    "hitFrequencyFeel": "medium"
  }
}
```

原因：

- 比固定赔线更现代。
- 比 Megaways 更容易做稳定原型。
- Cascades 能自然带出连锁反馈。
- Free Spins 是用户最熟悉的 bonus。
- Hold & Win 可以作为第二套模板，不要第一版就混进去。

## 6. 可玩特色的生成策略

“好玩而有特色”不是靠随机堆功能，而是每个游戏选一个核心钩子：

| 核心钩子 | 配置方式 | 视觉表现 |
|---|---|---|
| 果冻连锁 | Ways + Cascades + multiplier step | 符号弹走、新符号掉落、连击倍率 |
| 金币大奖 | Hold & Win + cash coin + collect | 金币锁格、收集、jackpot 徽章 |
| 免费旋转爽感 | Scatter + Free Spins + more wilds | 免费旋转转场、wild 变多 |
| 变形转轮 | Megaways + row randomizer | 每次 spin 行数变化、转轮拉伸 |
| 消除休闲 | Cluster Pays + Cascades | 同色成团爆开、掉落补位 |

每次只选一个“主钩子”，否则 Cocos 原型、反馈、资产都会变复杂。

## 7. 网页实现建议

新增一个“定义游戏”页签：

```text
玩法类型       单选：赔线 / Ways / Megaways / Cluster
转轮规格       columns / rows 或 rowRange
波动风格       低 / 中 / 高
特殊符号       Wild / Scatter / Cash / Collect / Bonus
特色玩法       Cascades / Free Spins / Hold & Win / Multipliers
反馈强度       克制 / 标准 / 夸张
资产范围       角色数量、UI 完整度、特效数量
```

按钮：

```text
生成玩法配置
生成 manifest
开始生图
导出 Cocos 包
```

第一版不需要实现真实数学，只需要生成：

- 可解释的玩法配置
- 对应资源和反馈
- Cocos 可运行演示场景

真实 slot 数学以后单独做 `math_engine_config.json`。