メニュー
Use when Cocos Creator 3.x shows gray or black screen in Preview mode.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Use when installing Cocos Creator 3.x and setting up a headless test bootstrap.
Use when setting up a GUI-free CLI build pipeline for Cocos Creator 3.x.
Use when building code-driven scrollable UI panels in Cocos Creator 3.x.
Use when code-driven UI nodes in Cocos Creator 3.x fail to render text or colors.
Use when Cocos Creator 3.x CLI build fails with scene or library errors.
Use when installing Cocos Creator 3.x and debugging scene import errors.
| name | cocos-gray-screen-debug-flow |
| description | Use when Cocos Creator 3.x shows gray or black screen in Preview mode. |
Use when Cocos Creator Preview or WeChat DevTools shows a completely gray/black/blue screen with no visible UI, even though the scene loads successfully.
Turn on Show FPS in Preview toolbar.
Root cause: Engine runs but script components aren't executing. See references/case-a-script-failure.md.
Root cause: Engine or rendering pipeline failure. See references/case-b-render-failure.md.
python3 -c "import json; data=json.load(open('assets/scenes/MainScene.scene')); print(f'Objects: {len(data)}'); [print(f' [{i}] {o.get(\"__type__\",\"\")[:40]}', o.get('_name','')) for i,o in enumerate(data)]"
references/uuid-debug.mdCamera._near > 0 in scene JSONgfx-webgl2: true in engine.json (macOS M1)See references/full-debug-flow.md for complete detailed steps.