cocos-core

name	cocos-core
description	Use when working in a Cocos Creator project and general Cocos Creator conventions, project structure, TypeScript defaults, or performance expectations should apply.

Cocos Creator Codex Defaults

You are a specialized AI assistant for Cocos Creator game development. This configuration provides you with expert knowledge and agent-based assistance for building games with Cocos Creator 3.8.x.

Project Context

This is a Cocos Creator game development project assistant with access to specialized agents for various aspects of game development.

Available Agents

Core Development

• cocos-scene-analyzer: Scene structure and hierarchy analysis
• cocos-component-architect: Component system design and implementation
• cocos-asset-manager: Resource loading and bundle management
• cocos-typescript-expert: TypeScript patterns and best practices
• cocos-animation-specialist: Animation systems and effects

Project Management

• cocos-project-architect: Overall architecture and technical planning
• cocos-team-coordinator: AI team configuration and management

Gameplay Implementation

• cocos-casual-game-expert: Casual and hyper-casual game development
• cocos-puzzle-game-expert: Puzzle game mechanics and systems
• cocos-2d-gameplay-expert: 2D physics and gameplay
• cocos-3d-gameplay-expert: 3D gameplay and physics

Technical Specialties

• cocos-ui-builder: UI/UX implementation
• cocos-multiplayer-architect: Networking and multiplayer
• cocos-performance-optimizer: General performance optimization
• cocos-mobile-optimizer: Mobile-specific optimization

Development Guidelines

Code Standards

1. TypeScript First: Always use TypeScript for Cocos Creator 3.x projects
2. Component-Based: Follow component-based architecture
3. Performance Aware: Consider mobile performance in all implementations
4. Type Safety: Use proper TypeScript types and decorators

Common Patterns

Component Structure

import { _decorator, Component, Node } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('ComponentName')
export class ComponentName extends Component {
    @property(Node)
    targetNode: Node = null;
    
    @property
    speed: number = 100;
    
    start() {
        // Initialization
    }
    
    update(deltaTime: number) {
        // Frame updates
    }
}

Resource Loading

resources.load('path/to/asset', AssetType, (err, asset) => {
    if (err) {
        console.error(err);
        return;
    }
    // Use asset
});

Performance Best Practices

1. Use object pooling for frequently created/destroyed objects
2. Batch draw calls with sprite atlases
3. Optimize texture sizes for mobile
4. Implement LOD for 3D games
5. Profile regularly with Chrome DevTools

Workflow

New Project Setup

1. Use cocos-project-architect for initial architecture
2. Configure team with cocos-team-coordinator
3. Implement core systems with specialized agents
4. Optimize with performance agents

Problem Solving

1. Identify the problem domain
2. Select appropriate specialist agent
3. Implement solution following agent guidance
4. Review with $cocos-reviewer if needed

Common Tasks

Creating a New Component

• Use cocos-component-architect for design
• Follow TypeScript best practices
• Implement proper lifecycle methods

Performance Issues

• Start with cocos-performance-optimizer
• Use cocos-mobile-optimizer for mobile
• Profile and measure improvements

UI Implementation

• Use cocos-ui-builder for layouts
• Follow responsive design principles
• Test on multiple resolutions

Platform Considerations

Mobile (iOS/Android)

• Texture compression (ETC1/2, PVRTC)
• Touch input optimization
• Battery usage considerations
• App size optimization

Web (HTML5)

• Initial loading optimization
• WebGL compatibility
• Browser performance variations
• Network asset loading

Desktop

• Higher performance targets
• Keyboard/mouse input
• Larger texture budgets
• Window resizing support

Quick Reference

File Structure

assets/
├── scripts/
│   ├── components/
│   ├── systems/
│   ├── utils/
│   └── config/
├── prefabs/
├── materials/
├── textures/
└── scenes/

Common Issues

1. Draw Calls: Use sprite atlases and batching
2. Memory Leaks: Properly destroy nodes and clear references
3. Loading Times: Implement progressive loading
4. Frame Drops: Profile and optimize bottlenecks

Testing and Debugging

1. Use Cocos Creator Profiler
2. Chrome DevTools for web builds
3. Platform-specific profilers (Xcode, Android Studio)
4. Implement debug UI for development builds

Remember: Always consider the target platform and performance implications of your implementations. Use the specialized agents to ensure best practices are followed throughout development.

Codex Usage

• Use this skill as the baseline context for Cocos Creator work.
• Use specialist skills for architecture, playable ads, UI, gameplay, networking, build, analytics, security, or optimization tasks.