| name | cocos-gray-screen-camera-canvas-fix |
| description | Use when Cocos Creator shows gray/blue screen on Play or Preview. |
Cocos Gray Screen — Camera + Canvas Fix
Systematic debug for Cocos Creator gray/blue screen — covers Camera and Canvas configuration issues.
Quick Check
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])"
cat settings/engine.json | python3 -c "import sys,json; print(json.load(sys.stdin).get('gfx-webgl2'))"
Common Pattern: Canvas in JSON but not in Editor
If Canvas node exists in MainScene.scene JSON but is not visible in Editor Hierarchy:
- Scene serialization corruption
- UUID mismatch on component reference
- Fix: Manually create Canvas via Editor (right-click → Create → UI → Canvas)
See references/deep-diagnostics.md for comprehensive debugging.