# NinJaGame

**Repository Path**: shenjuncaci/NinJaGame

## Basic Information

- **Project Name**: NinJaGame
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# NinJaGame - 忍者无尽爬升游戏

基于 Phaser 3 + TypeScript + Vite 构建的 HTML5 无尽爬升忍者动作游戏。

## 项目简介

一款快节奏的无尽爬升平台跳跃游戏，玩家控制忍者角色不断向上攀登，躲避障碍物和敌人，挑战最高分。游戏采用像素风格美术，包含冲刺、攻击等多种动作系统。

## 技术栈

- **游戏引擎**: Phaser 3.60+
- **开发语言**: TypeScript
- **构建工具**: Vite
- **运行环境**: 现代浏览器 (支持 WebGL)

## 功能特性

- 🎮 无尽爬升玩法 - 永无止境的攀登挑战
- 🦹 忍者角色 - 包含站立、冲刺、下落、攻击多种动画状态
- 🎯 简洁操控 - 方向键控制移动，支持多键组合操作
- 📊 高分排行 - 本地记录最高分数
- 🌙 多主题支持 - 内置多种游戏主题皮肤

## 快速开始

### 环境要求

- Node.js 16+
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

### 预览生产版本

```bash
npm run preview
```

## 游戏操作

| 按键 | 功能 |
|------|------|
| ← / → | 左右移动 |
| ↑ | 跳跃 / 攀爬 |
| ↓ | 下落 / 快速落地 |
| Space | 攻击 |

## 项目结构

```
NinJaGame/
├── public/                  # 静态资源
│   ├── minato.png          # 忍者站立图
│   ├── minato_attack.png  # 忍者攻击图
│   ├── minato_dash.png     # 忍者冲刺图
│   └── minato_fall.png    # 忍者下落图
├── src/
│   ├── main.ts             # 游戏入口配置
│   ├── style.css          # 页面样式
│   └── scenes/            # 游戏场景
│       ├── BootScene.ts   # 加载场景
│       ├── TitleScene.ts # 标题场景
│       ├── GameScene.ts  # 游戏主场景
│       └── GameOverScene.ts # 游戏结束场景
├── index.html             # HTML 入口
├── vite.config.ts         # Vite 配置
└── tsconfig.json          # TypeScript 配置
```

## 开发指南

### 添加新场景

1. 在 `src/scenes/` 目录下创建新的场景文件
2. 继承 `Phaser.Scene` 类
3. 在 `main.ts` 中注册场景

### 添加新角色动画

在对应的精灵表单(Atlas)中添加新动画帧，然后在 `GameScene.ts` 中使用 `this.anims.create()` 创建动画。

### 自定义主题

在 `GameScene.ts` 中的 `THEMES` 数组中添加新的主题配置：

```typescript
const THEMES: ThemeConfig[] = [
  {
    name: '主题名称',
    background: '#颜色值',
    platform: '#颜色值',
    // ...
  }
];
```

## 许可证

MIT License

## 贡献指南

欢迎提交 Issue 和 Pull Request！

---

*控制忍者，攀登巅峰！*