遊戲設計 Macau Pocket GP · v0.11.0

一個人用 AI 整澳門賽車遊戲:第一身視角+Python 車模型

一句講晒:喺網頁賽車遊戲加「第一身視角」同「倒後鏡」,再唔裝 Blender、用 Python 出一部 7,958 三角面嘅英式復古跑車,過程入面最大嘅坑係 meshopt 壓縮後車身變暗變方。

玩成品:macau-pocket-gp.pages.dev
非官方卡通街機原型,與澳門格蘭披治賽事無關聯。

呢頁會教你乜

Macau Pocket GP 係一個喺手機同電腦瀏覽器玩嘅卡通街機賽車原型,賽道參考澳門街頭。呢頁跟住 v0.11.0 嘅兩個升級講:視角(第一身+倒後鏡)同美術(Python 出車模型)。每步有「做法」同「可以點樣交代 AI」。

Macau Pocket GP 電腦版第一身視角:畫面上方有倒後鏡,前面係英式跑車嘅綠色車頭蓋同圓頭燈
遊戲實機畫面:電腦版第一身視角,頂部中間係倒後鏡。

關於「提示詞」:以下方框唔係逐字原文,而係根據實際做法整理嘅「交代 AI 嘅重點」,你可以照住改成自己嘅講法。

1

先定玩法同視角第一身係「多一個選項」,唔係取代車後鏡頭

做法
  • 保留原本嘅「車後」鏡頭,再加「第一身」做第二個選項,玩家可以隨時轉。
  • 電腦撳 V 鍵切換;手機撳畫面上嘅「鏡頭」掣(掣面顯示「鏡頭:車後」或「鏡頭:第一身」)。
  • 倒數同比賽中都可以轉;暫停同完賽畫面唔可以(完賽一律環繞車身)。
  • 揀咗邊個視角會記喺瀏覽器 localStorage,key 係 macau-pocket-gp-camera-v1,下次開返自動用。
可以點樣交代 AI(做法摘要)
我哋嘅賽車遊戲而家只有車後鏡頭。請加一個「第一身」鏡頭選項:
1. 電腦撳 V 切換,手機有一個「鏡頭」掣;
2. 只喺倒數同比賽中可以切換;
3. 選擇記喺 localStorage;
4. 先寫清楚改邊啲檔、點驗收,我同意先落手。
點驗收

撳 V 同「鏡頭」掣都會切換;重新整理頁面後視角冇變。

2

加第一身鏡頭每款車自己嘅眼位,逐樣擋視線嘅嘢處理

做法
  • 每款車定一組第一身參數(眼位高低、前後),再逐款對住畫面檢查。
  • 第一身隱藏車手;擋住視線嘅擋風玻璃分開成獨立網格,第一身時隱藏,淨返細框。
  • 離鏡頭太近嘅物件做近距離淡出(以眼前約 2 米為中心),避免車身穿入鏡頭。
  • 直向手機:畫面向上移,令車頭蓋喺落面嘅觸控踏板上面都見到。
  • 單車、滑板車、嬰兒車等款式加上對應嘅車把;巴士加駕駛艙。
可以點樣交代 AI(做法摘要)
請幫第一身鏡頭逐款車設定眼位,並處理:
- 隱藏車手;
- 擋風玻璃第一身時隱藏、保留細框;
- 離眼位近嘅物件做淡出;
- 直向手機畫面向上移,令車頭蓋喺觸控掣上面見到。
每項都要有自動測試,唔好淨係睇截圖。
點驗收

每款車開第一身都睇到車頭蓋或車把、冇半透明穿插;直向手機車頭蓋唔被踏板遮住。

3

加倒後鏡第一身最怕唔知後面有冇人追

做法
  • 喺眼位放第二部相機向後望,畫入一個細小嘅 render target(384×120),再貼到畫面頂部中間。
  • 貼出嚟嘅畫面左右翻轉先似真鏡;程式註解寫明:翻轉投影會令三角形繞向反轉,所以改為翻轉貼上去嘅畫面。
  • 只喺第一身顯示;電腦版闊度約 26%,直向手機約 40%,位置按實際量度到嘅 HUD 方塊避開,唔同其他介面重疊。
  • 弱機會降低更新頻率(每 2 或 3 幀更新一次);網址加 ?mirror=0 可以關閉。
遊戲內英式復古綠色跑車,長車頭蓋、圓頭燈、銀色輪圈同米白間條
遊戲內嘅英式復古跑車(下一步會講點樣出呢部車)。
可以點樣交代 AI(做法摘要)
請喺第一身加倒後鏡:第二部相機向後望,畫入細小 render target,再左右翻轉顯示喺畫面頂部中間。
要求:只喺第一身顯示;可以用 ?mirror=0 關閉;唔好每幀新建物件;位置要避開現有 HUD,用量度到嘅方塊計,唔好估。
純規則(幾時顯示、幾耐更新、放邊)抽成獨立函數,方便寫測試。
點驗收

第一身見到倒後鏡,鏡入面左右同現實鏡一致;轉返車後鏡頭,倒後鏡消失。

4

用 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
可以點樣交代 AI(做法摘要)
我唔想裝 Blender。請用 Python(trimesh)寫一個「車廠」流程:
1. 由遊戲自己嘅 vehicles.js 匯出車規格 JSON,模型程式讀呢份 JSON;
2. 出一部英式復古跑車(長車頭蓋、圓頭燈、銀色輪圈、米白間條);
3. 用 gltf-transform 做 meshopt 壓縮;
4. 預算:三角面 ≤ 8,000、壓縮後 ≤ 300 KB,只用頂點色。
先出一個測試方塊跑通流程,再出真車。
點驗收

用腳本讀 GLB 數三角面、用 ls -l 睇檔案大小,唔好信口講;兩個數字都要喺預算內。

5

踩坑:meshopt 壓縮後頂點被 clamp車身變暗變方嘅真正原因

症狀:車模型放入遊戲後,睇落又暗又方,同設計稿唔一樣。

真正原因:meshopt 壓縮後,頂點位置係 normalized int16(量化)。如果未轉做浮點數就將節點縮放烘入幾何,數值會被 clamp(限制)喺細範圍,車嘅形狀就被壓壞。

做法
  • 烘入節點縮放之前,先將 position 同 normal 轉成 Float32Array。
  • 加回歸測試:組裝後嘅車身包圍盒必須保持原本設計尺寸(長闊高都要喺規格範圍內),否則測試失敗。
可以點樣交代 AI(做法摘要)
車模型入遊戲後變暗變方。請先查原因,唔好直接調顏色或光:
檢查 meshopt 壓縮後嘅頂點屬性類型,如果係 normalized int16,
喺烘入節點縮放之前先轉成 float32。
修好之後加一個回歸測試,鎖住組裝後車身包圍盒嘅尺寸。
點驗收

測試入面包圍盒尺寸通過;遊戲內車身返回有弧度,尺寸同設計一致。

6

測試同上線先自動測試,再對比新舊,最後確認線上版本

做法
  • 自動測試:車模型測試 5 項通過、第一身鏡頭測試 10 項通過、倒後鏡測試 6 項通過(2026-11-22 重跑)。
  • 新舊對比:網址加 ?gfx=old 就關閉所有 Python 出嘅車模型,用返原本程式生成嘅車,方便 A/B 比較同出事時一鍵退回。
  • 任何載入失敗(模型檔缺失、解碼失敗等)都唔會令遊戲卡住,會繼續用原本嘅車。
  • 部署喺 Cloudflare Pages,上線版本係 v0.11.0,網址 macau-pocket-gp.pages.dev。
可以點樣交代 AI(做法摘要)
請幫我收尾:
1. 跑晒所有自動測試,貼出結果;
2. 確認網址加 ?gfx=old 會關閉新模型;
3. 模型載入失敗時要自動退返原本嘅車,唔准卡死;
4. 上線前列出改咗邊啲檔,等我批先部署。
點驗收

線上網址開到,頁面顯示版本 v0.11.0;手機有「鏡頭」掣,電腦撳 V 轉到第一身,見到倒後鏡同英式跑車。

常見問題

點解唔用 Blender?

想避免安裝大型 3D 軟件,所以用 Python 嘅 trimesh 由程式直接出 GLB,車嘅尺寸同位置由遊戲自己嘅規格檔讀取。

第一身視角點開?

電腦撳 V 鍵,手機撳「鏡頭」掣,喺「車後」同「第一身」之間切換;倒數同比賽中都可以轉。

想睇返舊車模型?

網址後面加 ?gfx=old,新模型就會關閉。

同澳門格蘭披治賽事有關係嗎?

冇。呢個係非官方卡通街機原型,與澳門格蘭披治賽事無關聯。

教訓 4 條

  1. 先加選項,唔好取代。第一身係多一個鏡頭選項,舊玩家習慣嘅車後鏡頭原封不動。
  2. 外觀出問題,先查數據再調顏色。車變暗變方,真因係頂點被 clamp,唔係光線或顏色。
  3. 每個坑都鎖一個回歸測試。包圍盒尺寸測試令同一個 bug 唔會悄悄返嚟。
  4. 留一個退路開關。?gfx=old 同 ?mirror=0 令新功能出事時一個參數就退返。