1風格框架 美術

給美術組的初始 brief — 場景風格以美術組提供之 ref 為主。

2美術交付清單 美術

依甘特圖 row 126~131 三階段拆分。請美術組依時程交付，TM 會在每階段結束做匯流檢查。

場景三階段（row 127~129）

VFX / SFX / BGM 介入時程

3場景規格 美術

4球瓶 / 球規格 美術

球體旋轉視覺（連續映射）

5機關視覺 美術

三機關（風 / 黑洞 / 地雷）位置固定。視覺需讓玩家一眼看出威脅類型 + 影響範圍。

6VFX 特效綠豆

字卡分工：文字（字型 / 排版）= 亞哈，動態（入退場 / 動畫 / 粒子）= 綠豆，觸發時機（容器切狀態）= 兔子。

📇 戰鬥字卡（UIJSG11_Battle_Cards · 2×4 grid）

共用容器 Card_HUD_StatusHint 承載 6 種狀態（READY / FINISH / STRIKE! / NewStage / GUTTER! / SUCKED!），Card_ChallengeClear 獨立結算 VFX。

🎱 球與球路 VFX

🌀 機關環境 VFX（非字卡）

7SFX 音效（16 項）鏡

8BGM 鏡

1Figma 設計稿 亞哈

亞哈設計稿主頁面。Wireframe v0.11 已落地（10 個 frame，Bluetooth 含雙態），等亞哈 5/15 起接視覺設計。

2UX 流程圖 UI開發

App 啟動 → 大廳 → JSG11 主選單 → 模式選擇 → 關卡選擇 → 戰鬥 → 結算 → 回大廳。

關鍵 UX 決議

310 個畫面清單 亞哈Jason/兔子

依交付優先序排列。命名鎖結構：亞哈設計時用同樣命名、RD 實裝時用同樣命名 → 零翻譯成本。v0.11 已含 Bluetooth（雙態）+ Record。

4單關循環流程 UI開發

關卡進場 → 10 球循環 → 結算。每球的 UI 反饋順序如下。

5命名規範 亞哈Jason/兔子

與舊 JSG 不同：JSG09 冰壺用 Curling_B 等單字 key 易撞名，JSG11 一律加 Bowling_ 或 JSG11_ 前綴。

前綴與命名空間

元件類型前綴

狀態後綴與多實例編號

6戰鬥 HUD 佈局 亞哈兔子

遊戲中常駐 HUD（亞哈視覺、兔子實裝）。實際視覺設計待亞哈 5/15~5/22 交付。

HUD 元素清單（v0.7+，對齊 Figma frame UIJSG11_Battle_HUD）

• 當前分數（左上 `Lbl_Score_Current`）— 絕對數字（例：136）
• 過關門檻（左上分數旁 `Lbl_Score_Threshold`）— 「過 96」
• 球數計數（右上 `Cnt_Ball`）— 「3 / 10」
• Stage 標記（右上球數旁 `Lbl_StageId`）— 「Stage 3」純文字
• 挑戰任務面板（右上 `Pnl_ChallengeTask` 常駐）— 「本關挑戰：不洗溝」+ 即時失敗變灰 + X 標記（v0.8 起改 HUD 常駐，不再用進關字卡）
• 暫停按鈕（右上角 `Btn_Pause`）— 觸發暫停確認對話框
• 瞄準箭頭（球道上方 `Bar_AimArrow`）— 階段 2 自動擺動，揮臂瞬間定格
• 狀態提示文字（球道下方 `Lbl_StatusHint`）— Ready/Finish/Strike/NewStage/Gutter/Sucked 共用容器（詳 §字卡）

7結算頁佈局 亞哈兔子

結算頁元素清單（v0.8 簡化）

• Header「Result」金色大字（取代 v0.7 「PASS」狀態文字 — 不論過關 / 沒過都顯示 Result）
• 單一中央 `Pnl_ResultDetail` 圓角面板含 4 行：Strike × N / Open × N / 挑戰達成（Clear +10 或 Failed）/ 總分（N / 96）
• 「繼續」按鈕（右下，金底紅邊 `Btn_Continue`）— 取代 v0.7「返回大廳」
• 過 96 → 點繼續回大廳（解鎖下一關）；沒過 → 點繼續回大廳（玩家自選重打或換關，v0.14 無 Try Again）

8關卡選擇佈局 亞哈Jason

3 種卡片狀態

1程式重做範圍兔子/Jason

除演算法層外全部重做（包含遊戲規則）。本企劃書 dev panel 採「企劃流程圖 + 資料結構」導向，code 細節由 RD 自決。

保留 vs 重做邊界

事件介面（演算法層保留設計）

// Unity 路徑 — 不沿用 code，僅作設計思路對照
Unity/Assets/Hotfix/Module/UI/JSG/JSG_Curling/Battle/
  ├─ Game/         // ❌ 重做
  ├─ Component/    // ❌ 重做
  └─ System/       // ❌ 重做

Unity/Assets/Hotfix/Entity/DeviceData/Curling/
  └─ JPlayCurlingAlgorithm.cs  // ✅ 沿用（演算法層）

Unity/Assets/Hotfix/MonoBehaviour/JSG_Curling/Scripts/
  └─ Camera / VFX / Audio / TimeLine 控制  // ❌ 全部重做

Excel/JSG/JSG9CurlingSetting.xlsx
  └─ 結構參考（極簡雙 sheet）  // JSG11 改 3 張表

2投擲技術流程 Andros/兔子

演算法層沿用 Andros 既有 input pipeline + 新增階段 2 箭頭自走擺動。UI 層全部重做。

關鍵 API 對應

// === 演算法層 ✅ 沿用 Andros 既有 ===

// 階段 1 — 旋手腕選位
DetectRotate(roll, gyro)  // Andros 演算法：roll < -45° = Left, > +20° = Right; multiplier 0/1/2

// 階段 1→2 — 手放下鎖站位
OnConfirm()  // Andros 演算法：Pitch < 0 + Gyro.z < -50000 → 觸發

// 階段 2 — 揮臂推出
PushCurling(forcePercentage)  // Andros 演算法：揮臂偵測 + 力道計算
OnPush(forcePercentage)  // 觸發瞬間 → freeze 箭頭定格 → 擷取當下角度

// （可選）重選
OnReadjust()  // Andros 演算法：Pitch > 0 + Gyro.z > +50000 → 回階段 1


// === UI / 渲染層 ❌ 全部重做（JSG11 自寫）===

// 階段 1 站位 UI（不沿用冰壺 SetObjectPosition，自寫）
JSG11_StancePositionUI.UpdateX(direction × moveDistance)  // 累加 X 位置 + 自訂上下限

// 階段 2 瞄準箭頭自走（自寫）
JSG11_AimingArrowController.StartSwing()  // DOTween 連續擺動，無鎖定動作
// 取代冰壺 SetObjectRotation() 的「手腕主動轉角度」

3鏡頭流程兔子

JSG11_CameraManager 全部重寫（不沿用冰壺 CameraManager）。鏡頭切換邏輯可參考冰壺 TraceCameraChangeOverHeadCamera 設計思路，但目標相機改為新增的 _pinAreaCamera，並移除冰壺結算頂視角流程。

4旋轉球路演算法Andros

手環角加速度 → 球體 forward 軸 angularVelocity 的連續映射。Andros 在演算法 code 內調，不另開 Excel 表。

// JSG11_BallSpinController
// 投擲瞬間（OnPush 觸發時）執行

public void ApplySpin(Rigidbody ball) {
    // 1. 讀手環角加速度（Andros 提供）
    float angularAccel = wristband.GetAngularAcceleration();

    // 2. 依映射曲線換算為球體 forward 軸 angularVelocity
    //    映射方式：線性 / 分段 / 上限值 — Andros 收斂中
    float omega = MapToAngularVelocity(angularAccel);

    // 3. 套用到球體 transform.forward（向前軸 / Z 軸）
    ball.angularVelocity = ball.transform.forward * omega;
    // → Unity 物理引擎依此產生軌跡彎曲（連續量，無離散等級）
}

5計分流程圖 Jason

計分規則重新撰寫。本段為企劃流程，RD 依此實作（Component 名稱與切分自決）。

判定規則

6三機關互動流程 兔子/Jason

三機關位置固定（Unity 場景管理）。參數寫入 JSG11Bowling_MechanismSetting 的 TrapValue: double[]（詳見 §7）。本段為企劃流程，RD 依此實作。

💨 Stage 3 風吹

🕳️ Stage 4 黑洞

💣 Stage 5 地雷

挑戰任務追蹤

7Excel 表（3 張）RD

參考 JSG9Curling / JSG08Golf 既有結構。多語系 key / 美術資源 / 機關位置 / 滿分計算 / 球手感 — 皆不寫進企劃表。

Id: long
LevelTypeId: int (0=教學 1=一般)
PinComposition: int[]   // → PinSetting.Id
MechanismIds: int[]     // → MechanismSetting.Id（可空）
UnlockNextLevelScore: int
UnlockNextLevelID: int
ChallengeType: enum
  // StrikeCount/NoObstaclePin/
  // NoGutter/NoBlackHole/NoLandmine
ChallengeThreshold: int  // 3/0/0/0/0
LevelVideoAmount: int

Id: int
PinType: enum
  // Regular / Obstacle
Score: int   // 1 / 0
Mass: double

Id: int
MechanismType: enum
  // Wind / BlackHole / Landmine
TrapValue: double[]
  // 風: [強度, 週期秒]
  // 黑洞: [峰值力, 曲線類型]
  //   0=線性 1=反平方
  // 地雷: [爆炸 impulse, 連鎖 0/1]