疑難排解

最常遇到的故障，以及它們真正的成因。這些問題大多看起來像是平台的程式錯誤，但其實不是——而是遊戲程式碼中的某個特定行為所造成。

遊戲

畫面空白或全白

幾乎都是以下三種情況之一，依可能性由高到低排列：

  1. 某個 src/ 檔案從未寫入。外殼引用了不存在的 script 檔案，因此整個遊戲都無法啟動。外殼還有待寫入的檔案時，執行期檢查會被略過，所以如果 AI 太早宣告成功，這個問題就可能漏網。請它列出遊戲的檔案，並寫入缺少的檔案。
  2. 載入順序。某個標記區塊或 harness 位於 script 標籤的下方，所以程式碼執行時 GAME_CONFIG 是 undefined。所有內容都必須放在 script 標籤的上方。
  3. script 路徑開頭多了一個斜線——src="/src/core/engine.js" 會解析到網站根目錄，結果回傳 404。

請你的 AI 執行一次驗證，或擷取一張試玩截圖：兩者都會回傳真正的主控台錯誤，而不必靠猜測。

生成的美術始終沒有出現

⚠

生成美術只會將它載入；程式碼實際繪製它，它才會出現。如果遊戲在那個位置仍然畫著佔位用的矩形，你就是花錢買了一張已經載入卻看不見的圖——而截圖看起來仍然像一款正常的遊戲，所以這個問題才會一直沒被發現。

請 AI 列出遊戲的素材，並處理它回報的每一條提示。平台在交付時會自動把這份清單回傳給 AI，所以正常的製作流程，理應永遠不會交付任何未被繪製的素材。

第二個原因：在標記那一行寫了防禦性的後備寫法。如果 game.html 裡有 window.GAME_ASSETS = window.GAME_ASSETS || {}; // __GI_ASSETS__，伺服器就完全無法改寫那個區塊，之後的每一次生成都會默默失敗，無法寫入遊戲。那一行必須是最單純的字面寫法 window.GAME_ASSETS = {}; // __GI_ASSETS__。

美術出現了，但各個物件的大小都不一致

生成器每次回傳的空白留邊多寡不一——同樣是 512×512 的畫布，可能 63% 是狐狸，也可能只有 41% 是熊。若直接按原圖繪製，其中一個看起來就會是另一個的 1.5 倍大。遊戲應該透過平台的 sprite 輔助函式來繪製，它會量出實際內容的範圍，並縮放到設計框內。請 AI 改用這個輔助函式。

遊戲明明有音樂，卻沒有聲音

原因有三個，而重新生成音訊無法解決其中任何一個：

  1. 程式碼從來沒有播放它。生成只會把曲目放進音訊表。
  2. 在使用者有任何互動之前就開始播放。瀏覽器會擋下這種播放。必須在第一次點擊或按鍵時才開始播放。
  3. 每一影格都建立一個新的音訊物件，這會讓聲音被截斷，還會大量耗用記憶體。
⚠

不要要求重新生成音效。這樣並不會改善播放效果，還會覆蓋掉你已經核准的那一版—— 而且要付全額。

載入條完成之後，美術才突然出現

遊戲是在頁面的 load 事件觸發時隱藏載入畫面，而這個事件觸發的時間遠早於圖片解碼完成。它應該改為等待平台的素材就緒訊號。平台也提供真實的進度計數，所以載入條可以顯示實際進度，而不只是一段動畫。

背景看起來被壓扁了

圖片被拉伸填滿畫布，而且 X 與 Y 是各自獨立縮放的。它需要等比縮放，再置中裁切。圓臉變成橢圓形，就是最明顯的徵兆。

編輯器

Inspector 空白，或只有一兩個控制項

AI 沒有把這些數值開放出來——它們仍然寫死在遊戲邏輯裡。請它把這些數值移進設定，並擴充 schema。這項修改只涉及程式碼，不收費；尤其是所有與難度相關的數值，更應該放在那裡。

滑桿可以拖動，但沒有任何效果

遊戲在啟動時就把設定複製到區域變數裡，而不是每一影格都重新讀取。有些數值改變時，也需要重建由它衍生出來的狀態——例如改變敵人數量，除非重建敵人池，否則不會有任何效果。這兩種情況，對 AI 來說都只是一行程式碼的修正。

儲存時顯示已經有別人先儲存了

有兩個人編輯了同一款遊戲。你會看到一條不會自動消失的橫幅，提供幾個選項：重新載入對方的版本、強制以你的版本覆蓋——這個選項會標明將覆蓋哪一個版本——或稍後再決定。系統不會自動合併任何內容，因為一組調校好的設定，是一組彼此權衡過的數值。開始長時間調校之前，請先查看線上狀態標示。

我換上的素材不見了

換上的素材只會暫存並在本機預覽，必須按下 Save 才會寫入遊戲。若未儲存就離開，這些素材將會被捨棄，與滑桿的調整完全相同。

發佈按鈕似乎沒有任何反應

其實有。發佈時會先開啟一個真正的瀏覽器，對遊戲進行互動測試，大約需要 15 秒；之後遊戲會進入審核佇列，狀態顯示為審核中。在審核人員核准之前，它都不會公開。

編輯器連結把我導向遊玩頁面

你只有遊玩權限——可能是透過「只能玩」層級的分享邀請，也可能你是以 Player 角色加入的團隊成員。請向擁有者或團隊管理員申請編輯權限。

Credits 與方案

生成在中途停止

目前使用中的錢包額度已用盡。生成會停止並顯示訊息，而不會改扣另一個錢包—— 這種隔離是刻意的設計。請切換錢包、儲值，或請團隊管理員提高你的額度。生成以外的所有功能都會照常運作。

某個工具顯示需要 Pro

只有 3D 模型生成、圖片轉 3D、3D 動畫，以及附材質的基本幾何體受方案限制，因為它們要透過外部供應商執行。凡是在平台自有硬體上執行的功能——2D 美術、 sprite、動畫、Live2D、音效、音樂、語音——所有方案都能使用，只受 credits 限制。

用量頁面顯示有花費，卻沒有對應的遊戲

那是設計階段的工作，尤其是概念圖。它在遊戲建立之前就已經扣款，當下還沒有遊戲可以歸屬，所以無法在發生的那一刻就記到某款遊戲上。這是花在一款真實遊戲上的真實花費。

預算模式的製作回報未超出預算，但餘額顯示並非如此

原因相同。遊戲建立之前生成的概念圖，預算工具看不到，所以一次製作可以誠實地回報「5,000 / 5,000」，但實際數字其實更高。請你的助理將設計階段的美術納入計畫，並在遊戲建立之後傳入遊戲 id。

MCP 連線

症狀原因與解決方法
401，或要求你進行驗證標頭缺少或格式錯誤。必須是 Authorization: Bearer gi_…——中間要有空格，也要保留 gi_ 前綴。沒有 OAuth 備援方案，所以無法設定標頭的用戶端就無法連線。
「要有 MCP key 才能用」伺服器沒有收到任何可用的金鑰。請檢查標頭名稱，並確認金鑰在貼上時沒有被截斷。
沒有出現任何 Gamentic 工具用戶端還沒有重新載入設定。請重新啟動用戶端，再到它的 MCP 面板確認伺服器顯示為已連線。
工具在任務中途消失，之後又出現這是正常的。伺服器重新啟動會讓工作階段失效，用戶端會自動在背景重新初始化。如果問題持續，請重新啟動用戶端。
較長的工具呼叫逾時在 Agent Lab 開啟連線不穩模式，讓遊戲改以可續傳的分段方式上傳，而不是透過一次冗長的呼叫。
明明看得到的 id，卻出現「找不到遊戲」通常是權限問題，而不是打錯字——這組金鑰所屬的帳號沒有那款遊戲的存取權。id 本身的容錯度很高：加了引號、反引號，或直接貼上編輯器的網址，都能接受。
編輯因為會遺失素材而被拒絕這次寫入會移除遊戲中已有的圖片、音訊或模型。這代表防護機制正在發揮作用。如果確實要移除，AI 必須明確表示同意——或改用刪除工具，它會先建立快照。
AI 表示它剛寫入的素材被還原了它根據過時的副本送出了整個檔案的改寫，結果以伺服器上目前的素材為準。回應中會列出保留了哪些素材。它不應該試著去「修正」這些素材，而應該先重新讀取檔案。

內容與公開設定

我看不到別人傳連結給我的遊戲

可能是那款遊戲設為私人，而你沒有受邀；也可能它被分級為成人內容。成人遊戲需要成年帳號，並在帳號設定中開啟允許成人內容——這個選項預設為關閉，而未登入的訪客永遠看不到成人內容。

註冊時要求輸入邀請碼

公測期間，註冊設有門檻。你遇到的是這道門檻，而不是你輸入的內容有錯。

還是無法解決

網站的每一頁角落都有一個回報錯誤 / 提建議按鈕，會自動附上相關的背景資訊。在編輯器裡，把執行中的遊戲截圖並在上面畫記，是描述任何視覺問題最快的方法。