# cards

**Repository Path**: nofree5th/cards

## Basic Information

- **Project Name**: cards
- **Description**: 一个类似空当接龙的风靡了21世纪的创意卡牌游戏
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: tmp
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cards

微信小游戏项目 (2D)

## 开发

```bash
# 安装依赖
npm install

# 开发模式（自动监听文件变化）
npm run dev

# 构建
npm run build
```

**注意：** 如果项目需要图片、音频等静态资源，请创建 `assets/` 目录并在 `package.json` 的 `build` 脚本中添加：
```json
"build": "npm run clean && webpack && cp -r assets dist/miniprogram/ && cp game.json dist/miniprogram/ && cp project.config.json dist/"
```

## 微信开发者工具

1. 打开微信开发者工具
2. 导入项目，选择 `dist` 目录
3. AppID 使用测试号或填写你的小游戏 AppID

## 项目结构

```
src/
├── core/           # 核心框架（引擎无关，可按需修改）
├── scenes/         # 场景（引擎适配基类和示例由 CLI 自动生成）
├── gameobjects/    # 游戏对象示例
├── utils/          # 工具类（Logger/WechatShare）
└── main.js         # 入口文件
```

## 开发指南

本项目遵守 no.js 规范，CodeBuddy 规则已配置在 `.codebuddy/rules/` 目录下。

### 核心框架（src/core/）

引擎无关的场景驱动架构，支持按需修改：

- `Game` - 游戏主循环
- `Scene` - 场景基类（生命周期：onEnter/update/cleanup）
- `GameObject` - 游戏对象基类
- `EventBus` - 全局事件总线
- `InputManager` - 输入管理（自动解决事件穿透）
- `TimeManager` - 时间管理（暂停、时间缩放）
- `ScreenAdapter` - 屏幕适配工具
- `ObjectPool` - 对象池（性能优化）

### 示例代码（src/scenes/）

- `LoadingScene` - 加载场景（游戏忠告、资源预加载）
- `MenuScene` - 菜单场景（按钮、模态对话框示例）
- `GameScene` - 游戏场景（GameObject 管理、输入处理）

### 快速开始

1. 本项目为 2D 游戏
2. 场景继承 `PixiScene`
3. 用自然语言描述游戏功能，让 CodeBuddy 帮你实现！