chrislamdev Cocos Creator 3.x Install & Debug
Install Cocos Creator 3.x on macOS from terminal and fix common scene import errors.
Install
# 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
- Check Console in Cocos Creator (Window → Console)
- Verify scene loads:
LoadScene MainScene.scene: XXmsin output - Read scene JSON integrity:
python3 -c "import json; json.load(open('assets/scenes/MainScene.scene'))" - If scene corrupt, restore from git backup or rebuild
See references/full-debug.md for complete error catalog and fixes.