Current Game Docs

這一區專門記錄目前版本新遊戲的補充文件，和舊版參考站分開維護；目前以技能與 area 兩組現行 runtime 補充台帳為主。

目前已有內容

• 技能補充說明
• Legacy document/ 參考手冊入口
• document/README 導讀
• .mob 怪物檔格式說明
• .obj 物品檔格式說明
• .roo 房間檔格式說明
• .res 重置檔格式說明
• .shp 商店檔格式說明
• index 區域標題檔格式說明
• Legacy 版權宣告
• .ski 技能檔格式說明
• .ski 進階 Loader Reference
• .ski 常數查表
• .ski pry 文案對照
• 技能可讀總覽
• 技能分類子頁
• 技能機器可讀台帳
• 技能戰鬥鏈審計說明
• 技能戰鬥鏈審計台帳
• Quest / Question 補充說明
• Quest / Question 機器可讀台帳
• Area 補充說明
• Area 機器可讀台帳

文件邊界

• 這裡記錄的是目前 repo 額外補上的現行資料與設計決策。
• 舊版技能脈絡、公告、世界觀語彙與歷史內容，改查 3y.jakeuj.com 或 repo 內 docs/3yWebsite/ 鏡像。
• area 世界規劃、重建追蹤與單區 spec 仍以 repo 內的 area/world_map.md、area/rebuild_plan.md、plans/area/*.md 為主；這裡只放 Pages 版補充索引。
• 若未來新增更多現行版本文件，優先放在 docs/current-game/，不要直接混寫到舊站鏡像。
• 可讀型技能頁目前由 scripts/generate_current_game_skills_pages.py 從 skills.json 生成；目前已覆蓋舊站各葉節點分類，後續新增技能資料時優先沿用同一條生成流程。
• 若這輪是在修改目前會載入的技能模板，優先先改 data/structured/skills/skills.json，再用 scripts/export_structured_skills.py 與 current-game docs pipeline 回寫 runtime 與 read model。
• 若這輪是在修改已建立 structured content layer 的 area 內容，優先先改 area/<area>/content.json，再用 scripts/export_area_content.py 回寫 mob / obj / res / shp。
• document/*.txt 這類 legacy authoring reference 若要補進 Pages，優先整理成 docs/current-game/ 的可讀頁面，再從這裡掛入口。