# x-game

**Repository Path**: Jeaden/x-game

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-07
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# X-Game - 2D像素风游戏

基于 Phaser.js + Electron + Vite 的2D像素风平台跳跃游戏。

## 🎮 游戏特色

- **像素风格** - 经典的8位像素艺术风格
- **平台跳跃** - 经典的横版闯关玩法
- **收集要素** - 收集金币获得分数
- **敌人系统** - 避开移动的敌人
- **生命系统** - 3条生命，增加挑战性

## 🚀 快速开始

### 环境要求
- Node.js 16+ 
- npm 或 yarn

### 安装依赖
```bash
npm install
```

### 开发模式

#### Web版本 (推荐开发时使用)
```bash
npm run dev
```
游戏将在 `http://localhost:5173/` 打开

#### Electron版本
```bash
npm run electron:dev
```
启动桌面应用版本

### 构建发布

#### 构建Web版本
```bash
npm run build
```

#### 打包Electron应用
```bash
npm run electron:pack
```

#### 构建发布版本
```bash
npm run electron:dist
```

## 🎯 游戏操作

- **移动**: 方向键 ←→ 或 A/D 键
- **跳跃**: 方向键 ↑ 或 W 键 或 空格键
- **重新开始**: 游戏结束后按空格键
- **返回菜单**: 点击游戏中的 MENU 按钮

## 🎲 游戏玩法

1. 控制绿色角色在平台间跳跃
2. 收集黄色金币获得分数 (每个10分)
3. 避开红色敌人 (碰到会失去1条生命)
4. 收集120分即可获胜
5. 失去所有生命则游戏结束

## 📁 项目结构

```
x-game/
├── src/                    # 游戏源码
│   ├── scenes/            # 游戏场景
│   │   ├── MenuScene.js   # 菜单场景
│   │   └── GameScene.js   # 游戏场景
│   ├── objects/           # 游戏对象
│   │   └── Player.js      # 玩家类
│   ├── utils/             # 工具函数
│   │   └── config.js      # 游戏配置
│   └── main.js            # 游戏入口
├── electron/              # Electron配置
│   └── main.js            # 主进程
├── public/                # 静态资源
├── dist/                  # 构建输出
├── build/                 # 打包输出
├── index.html             # 游戏页面
├── vite.config.js         # Vite配置
└── package.json           # 项目配置
```

## 🛠️ 技术栈

- **Phaser.js 3.90** - 2D游戏引擎
- **Electron 38** - 桌面应用框架
- **Vite 7** - 构建工具
- **JavaScript ES6+** - 编程语言

## 🎨 自定义开发

### 添加新场景
1. 在 `src/scenes/` 创建新场景文件
2. 在 `src/main.js` 中注册场景

### 修改游戏配置
编辑 `src/utils/config.js` 中的常量

### 添加新的游戏对象
在 `src/objects/` 目录创建新的类文件

## 📦 打包说明

- **Windows**: 生成 `.exe` 安装包
- **macOS**: 生成 `.dmg` 磁盘映像
- **Linux**: 生成 `.AppImage` 应用

## 🔧 开发提示

- 开发时推荐使用 Web 版本 (`npm run dev`)，热重载更快
- 需要测试桌面功能时使用 Electron 版本
- 游戏使用像素完美渲染，关闭了抗锯齿
- 所有图形都是代码生成的，方便修改颜色和尺寸

## 📝 许可证

ISC License