climb/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Cocos Creator 3.8.7 2D game project focused on pathfinding mechanics. The game implements A* pathfinding with camera following behavior in a tile-based environment.

Project Structure

• assets/scripts/ - Core game logic TypeScript files
• assets/scenes/ - Cocos Creator scene files (main.scene)
• assets/resources/ - Game assets including tile maps and animations
• settings/v2/packages/ - Cocos Creator engine and project configuration

Key Components

GameController (assets/scripts/GameController.ts)

• Main game logic handling player movement, pathfinding, and camera control
• Implements A* pathfinding algorithm for grid-based navigation
• Manages touch input for player movement commands
• Contains hardcoded map data (5x10 grid with obstacles)

CameraFollow2D (assets/scripts/CameraFollow2D.ts)

• Dedicated camera following component with smooth interpolation
• Provides map boundary constraints to prevent camera from going outside map limits
• Configurable offset and smoothing parameters

Manager (assets/scripts/Manager.ts)

• Currently minimal/empty - likely intended for game state management

Engine Configuration

• Engine Version: Cocos Creator 3.8.7
• Design Resolution: 720x1334 (mobile portrait)
• Enabled Modules: 2D rendering, UI, animation, audio, physics-2d, tiled-map, spine-3.8, dragon-bones
• TypeScript: Uses strict mode disabled for development flexibility

Development Notes

• The project uses a grid-based coordinate system with 32px grid size
• Map data is currently hardcoded in GameController - consider externalizing for level design
• Camera movement uses lerp interpolation with configurable smoothing
• Pathfinding supports 4-directional movement (no diagonal)