cocos-creator-install-and-debug
Use when installing Cocos Creator 3.x and debugging scene import errors.
Source facts
- Repository
- ChrisLamDev/cocos-creator-debug-skills
- Last source activity
- July 4, 2026 at 01:36
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 1
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cocos-creator-install-and-debug
- description
- Use when installing Cocos Creator 3.x and debugging scene import errors.
# 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.
View on GitHub