# Cocos Creator Install And Debug

> Cocos Creator 3.x Install & Debug

- Skill: `chrislamdev/cocos-creator-install-and-debug` (Agent Skill)
- Install (CLI): `npx skillmds@latest add chrislamdev/cocos-creator-install-and-debug`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chrislamdev/cocos-creator-install-and-debug/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: chrislamdev (https://skillmd.com/u/chrislamdev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chrislamdev/cocos-creator-install-and-debug

---


# Cocos Creator 3.x Install & Debug

Install Cocos Creator 3.x on macOS from terminal and fix common scene import errors.

## Install

```bash
# Download from official site
open "https://www.cocos.com/en/creator-download"
# Or use direct .dmg
open /path/to/CocosCreator_v3.x.dmg
```

Install to `/Applications/CocosCreator.app`.

## Common Scene Import Errors

| Error | Likely Cause | Quick Fix |
|-------|-------------|-----------|
| Error 1222/1223 | Corrupted scene JSON | Rebuild scene from backup |
| `scene._load is not a function` | Broken __id__ references | Don't manually edit scene JSON |
| Gray screen on preview | Script component not loaded | Check Canvas node exists in Hierarchy |
| Missing textures | Asset bundle not imported | Re-import assets in Editor |

## Debug Flow

1. Check Console in Cocos Creator (Window → Console)
2. Verify scene loads: `LoadScene MainScene.scene: XXms` in output
3. Read scene JSON integrity: `python3 -c "import json; json.load(open('assets/scenes/MainScene.scene'))"`
4. If scene corrupt, restore from git backup or rebuild

See `references/full-debug.md` for complete error catalog and fixes.