呢頁會教你乜
Macau Pocket GP 係一個喺手機同電腦瀏覽器玩嘅卡通街機賽車原型,賽道參考澳門街頭。呢頁跟住 v0.11.0 嘅兩個升級講:視角(第一身+倒後鏡)同美術(Python 出車模型)。每步有「做法」同「可以點樣交代 AI」。
關於「提示詞」:以下方框唔係逐字原文,而係根據實際做法整理嘅「交代 AI 嘅重點」,你可以照住改成自己嘅講法。
先定玩法同視角第一身係「多一個選項」,唔係取代車後鏡頭
- 保留原本嘅「車後」鏡頭,再加「第一身」做第二個選項,玩家可以隨時轉。
- 電腦撳
V鍵切換;手機撳畫面上嘅「鏡頭」掣(掣面顯示「鏡頭:車後」或「鏡頭:第一身」)。 - 倒數同比賽中都可以轉;暫停同完賽畫面唔可以(完賽一律環繞車身)。
- 揀咗邊個視角會記喺瀏覽器
localStorage,key 係macau-pocket-gp-camera-v1,下次開返自動用。
我哋嘅賽車遊戲而家只有車後鏡頭。請加一個「第一身」鏡頭選項:
1. 電腦撳 V 切換,手機有一個「鏡頭」掣;
2. 只喺倒數同比賽中可以切換;
3. 選擇記喺 localStorage;
4. 先寫清楚改邊啲檔、點驗收,我同意先落手。
撳 V 同「鏡頭」掣都會切換;重新整理頁面後視角冇變。
加第一身鏡頭每款車自己嘅眼位,逐樣擋視線嘅嘢處理
- 每款車定一組第一身參數(眼位高低、前後),再逐款對住畫面檢查。
- 第一身隱藏車手;擋住視線嘅擋風玻璃分開成獨立網格,第一身時隱藏,淨返細框。
- 離鏡頭太近嘅物件做近距離淡出(以眼前約 2 米為中心),避免車身穿入鏡頭。
- 直向手機:畫面向上移,令車頭蓋喺落面嘅觸控踏板上面都見到。
- 單車、滑板車、嬰兒車等款式加上對應嘅車把;巴士加駕駛艙。
請幫第一身鏡頭逐款車設定眼位,並處理:
- 隱藏車手;
- 擋風玻璃第一身時隱藏、保留細框;
- 離眼位近嘅物件做淡出;
- 直向手機畫面向上移,令車頭蓋喺觸控掣上面見到。
每項都要有自動測試,唔好淨係睇截圖。
每款車開第一身都睇到車頭蓋或車把、冇半透明穿插;直向手機車頭蓋唔被踏板遮住。
加倒後鏡第一身最怕唔知後面有冇人追
- 喺眼位放第二部相機向後望,畫入一個細小嘅 render target(384×120),再貼到畫面頂部中間。
- 貼出嚟嘅畫面左右翻轉先似真鏡;程式註解寫明:翻轉投影會令三角形繞向反轉,所以改為翻轉貼上去嘅畫面。
- 只喺第一身顯示;電腦版闊度約 26%,直向手機約 40%,位置按實際量度到嘅 HUD 方塊避開,唔同其他介面重疊。
- 弱機會降低更新頻率(每 2 或 3 幀更新一次);網址加
?mirror=0可以關閉。
請喺第一身加倒後鏡:第二部相機向後望,畫入細小 render target,再左右翻轉顯示喺畫面頂部中間。
要求:只喺第一身顯示;可以用 ?mirror=0 關閉;唔好每幀新建物件;位置要避開現有 HUD,用量度到嘅方塊計,唔好估。
純規則(幾時顯示、幾耐更新、放邊)抽成獨立函數,方便寫測試。
第一身見到倒後鏡,鏡入面左右同現實鏡一致;轉返車後鏡頭,倒後鏡消失。
用 Python 出車模型唔裝 Blender,程式出 GLB
- 用 Python 嘅
trimesh出 GLB 模型,流程放喺tools/car_factory。 - 車嘅尺寸、輪位、配件位、第一身眼位,由遊戲自己嘅
vehicles.js經腳本匯出成specs.json,模型程式讀呢份檔,唔使手抄。 - 用
@gltf-transform/cli嘅 meshopt 壓縮;遊戲用 meshopt decoder 讀返出嚟。 - 只用頂點色、冇貼圖;預算定咗每款 LOD0 ≤ 8,000 三角面、壓縮後 ≤ 300 KB。
| 項目 | 英式復古跑車(roadster)實測 |
|---|---|
| 三角面 | 7,958(讀 GLB 索引數得出,自動測試亦通過) |
| 檔案大小 | meshopt 壓縮後 65,972 bytes(約 64 KB) |
| 模型件數 | 壓縮前 GLB 內 11 個 mesh |
我唔想裝 Blender。請用 Python(trimesh)寫一個「車廠」流程:
1. 由遊戲自己嘅 vehicles.js 匯出車規格 JSON,模型程式讀呢份 JSON;
2. 出一部英式復古跑車(長車頭蓋、圓頭燈、銀色輪圈、米白間條);
3. 用 gltf-transform 做 meshopt 壓縮;
4. 預算:三角面 ≤ 8,000、壓縮後 ≤ 300 KB,只用頂點色。
先出一個測試方塊跑通流程,再出真車。
用腳本讀 GLB 數三角面、用 ls -l 睇檔案大小,唔好信口講;兩個數字都要喺預算內。
踩坑:meshopt 壓縮後頂點被 clamp車身變暗變方嘅真正原因
症狀:車模型放入遊戲後,睇落又暗又方,同設計稿唔一樣。
真正原因:meshopt 壓縮後,頂點位置係 normalized int16(量化)。如果未轉做浮點數就將節點縮放烘入幾何,數值會被 clamp(限制)喺細範圍,車嘅形狀就被壓壞。
- 烘入節點縮放之前,先將 position 同 normal 轉成
Float32Array。 - 加回歸測試:組裝後嘅車身包圍盒必須保持原本設計尺寸(長闊高都要喺規格範圍內),否則測試失敗。
車模型入遊戲後變暗變方。請先查原因,唔好直接調顏色或光:
檢查 meshopt 壓縮後嘅頂點屬性類型,如果係 normalized int16,
喺烘入節點縮放之前先轉成 float32。
修好之後加一個回歸測試,鎖住組裝後車身包圍盒嘅尺寸。
測試入面包圍盒尺寸通過;遊戲內車身返回有弧度,尺寸同設計一致。
測試同上線先自動測試,再對比新舊,最後確認線上版本
- 自動測試:車模型測試 5 項通過、第一身鏡頭測試 10 項通過、倒後鏡測試 6 項通過(2026-11-22 重跑)。
- 新舊對比:網址加
?gfx=old就關閉所有 Python 出嘅車模型,用返原本程式生成嘅車,方便 A/B 比較同出事時一鍵退回。 - 任何載入失敗(模型檔缺失、解碼失敗等)都唔會令遊戲卡住,會繼續用原本嘅車。
- 部署喺 Cloudflare Pages,上線版本係 v0.11.0,網址 macau-pocket-gp.pages.dev。
請幫我收尾:
1. 跑晒所有自動測試,貼出結果;
2. 確認網址加 ?gfx=old 會關閉新模型;
3. 模型載入失敗時要自動退返原本嘅車,唔准卡死;
4. 上線前列出改咗邊啲檔,等我批先部署。
線上網址開到,頁面顯示版本 v0.11.0;手機有「鏡頭」掣,電腦撳 V 轉到第一身,見到倒後鏡同英式跑車。
常見問題
點解唔用 Blender?
想避免安裝大型 3D 軟件,所以用 Python 嘅 trimesh 由程式直接出 GLB,車嘅尺寸同位置由遊戲自己嘅規格檔讀取。
第一身視角點開?
電腦撳 V 鍵,手機撳「鏡頭」掣,喺「車後」同「第一身」之間切換;倒數同比賽中都可以轉。
想睇返舊車模型?
網址後面加 ?gfx=old,新模型就會關閉。
同澳門格蘭披治賽事有關係嗎?
冇。呢個係非官方卡通街機原型,與澳門格蘭披治賽事無關聯。
教訓 4 條
- 先加選項,唔好取代。第一身係多一個鏡頭選項,舊玩家習慣嘅車後鏡頭原封不動。
- 外觀出問題,先查數據再調顏色。車變暗變方,真因係頂點被 clamp,唔係光線或顏色。
- 每個坑都鎖一個回歸測試。包圍盒尺寸測試令同一個 bug 唔會悄悄返嚟。
- 留一個退路開關。
?gfx=old同?mirror=0令新功能出事時一個參數就退返。