GameData Flag Semantics (BooleanBackpack vs BooleanAutoOpen)¶
概念概覽
語義區分¶
核心知識¶
語義區分¶
兩個 flag 控制不同維度，混淆會導致修錯方向：
BooleanBackpack=false：道具**不顯示**在玩家可見背包（外觀/UI 控制），與領獎行為無關BooleanAutoOpen=true：道具**自動發放/領取**（行為控制），英雄解鎖獎勵能否自動兌現取決於此
錯誤診斷模式¶
舊診斷：「BooleanBackpack=false → 英雄解鎖第 3 階段失敗」
正確根因：item 10210000023 的 BooleanAutoOpen 設定有問題
通用原則¶
gamedata flag 命名若有歧義（Backpack 可能被誤讀為「放進背包觸發領取」），必須先向企劃確認語義，再動 code。一旦語義搞錯，修正方向完全相反且會引入新 bug。
經驗教訓¶
-
外觀類 flag（Boolean前綴）不一定控制行為，診斷 item 流程問題時先確認哪個 flag 負責行為觸發
-
gamedata 欄位語義不清時，優先找企劃澄清，比讀 code 猜測更有效
-
英雄解鎖獎勵失敗的檢查清單：BooleanAutoOpen → 獎勵 item config → Grant pipeline，依序排除
常見陷阱¶
-
BooleanBackpack=false 被誤解為「不放背包所以沒有觸發領取」，導致修錯 code
-
只看 flag 名稱字面意義猜語義，未驗證即動 code
最佳實踐¶
-
建立 gamedata flag 語義文件，區分「外觀/UI 控制」vs「行為控制」兩類
-
診斷 item 發放問題時，先確認 BooleanAutoOpen，再看背包顯示相關 flag
相關概念¶
- Game Item Exemption Resource Architecture
- grant-pipeline----dangling---
相關視角¶
以下頁面與本概念共享主題，但從不同角度切入。保留獨立視角同時提供交叉參考：
- Time-Limited Pass Item Design — 共享：
game-design,item-system/ 獨特：game-backend,stamina-pass
來源 Sessions¶
| 日期 | Session | 貢獻摘要 |
|---|---|---|
| 2026-03-20 | d9903c52-a136-4d3b-b5d9-99c8d0c4d1c1 | 澄清 BooleanBackpack 與 BooleanAutoOpen 的語義邊界，修正了英雄解鎖第 3 階段失敗的根因診斷方向 |