Cocos Gray Screen Camera Canvas Fix

Cocos Gray Screen — Camera + Canvas Fix

chrislamdev b9f2562 1.1 KB Updated

File contents

Cocos Gray Screen — Camera + Canvas Fix

Systematic debug for Cocos Creator gray/blue screen — covers Camera and Canvas configuration issues.

Quick Check

# 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'))"

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.

chrislamdev/cocos-creator-debug-skills/tree/main/skills/cocos-gray-screen-camera-canvas-fix commit b9f256291d

Frequently asked questions

npx skillmds@latest add chrislamdev/cocos-gray-screen-camera-canvas-fix