메뉴
Use when Cocos Creator shows gray/blue screen on Play or Preview.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | cocos-gray-screen-camera-canvas-fix |
| description | Use when Cocos Creator shows gray/blue screen on Play or Preview. |
Systematic debug for Cocos Creator gray/blue screen — covers Camera and Canvas configuration issues.
# 1. Check Camera._near in scene JSON
python3 -c "import json; d=json.load(open('assets/scenes/MainScene.scene')); c=[o for o in d if 'Camera' in str(o.get('_type',''))]; print([(o.get('_name'), o.get('_near')) for o in c])"
# 2. Check Canvas exists in Hierarchy (not just in JSON)
# Open Cocos Creator → Hierarchy panel → look for Canvas node
# 3. Check gfx-webgl2 is enabled
cat settings/engine.json | python3 -c "import sys,json; print(json.load(sys.stdin).get('gfx-webgl2'))"
If Canvas node exists in MainScene.scene JSON but is not visible in Editor Hierarchy:
See references/deep-diagnostics.md for comprehensive debugging.
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.