# Game-Plant Star Brawl

**Repository Path**: nullshow/plant-star-brawl

## Basic Information

- **Project Name**: Game-Plant Star Brawl
- **Description**: 学习B站Voidmatrix课程《植物明星大乱斗》时写的源码
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-14
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Cpp, game

## README

# 植物明星大乱斗 | Plant Star Brawl

> 基于 B 站 [Voidmatrix](https://www.bilibili.com/video/BV1jx4y1t7eP?vd_source=b1a61d6b078b6e795dda5bac409d910e) 教程的 C++ 游戏开发学习项目，聚焦框架设计与核心玩法实现。

> A C++ game development project based on the [Voidmatrix](https://www.bilibili.com/video/BV1jx4y1t7eP?vd_source=b1a61d6b078b6e795dda5bac409d910e) tutorial on Bilibili, focusing on framework design and core gameplay implementation.

---

## 项目概览 | Project Overview

**技术栈 | Tech Stack**：C++ + EasyX

**项目目标 | Project Goals**：

- 使用多头文件组织结构，提升模块化与可维护性  
  Modular organization using multiple header files for better maintainability  
- 引入“场景”设计，划分游戏阶段，实现功能解耦  
  Scene-based architecture to separate game stages and decouple functionality  
- 实现基础物理模拟与单向碰撞平台  
  Basic physics simulation and one-way collision platforms  
- 封装常见游戏功能：**摄像机**、**定时器**、**粒子系统**  
  Encapsulation of common game features: **camera**, **timer**, and **particle system**  
- 提升动画表现力与音效丰富度，增强项目完成度  
  Enhanced animation and sound effects for a more polished experience  

---

## 核心玩法 | Core Gameplay

- 支持本地双人对战，玩家可选择不同角色  
  Local two-player battle with selectable characters  
- 在平台间跳跃、移动，使用普通攻击与特殊技能造成伤害  
  Jump and move across platforms, using normal and special attacks to deal damage  
- 攻击可积累能量，能量蓄满后可释放强力技能  
  Gain energy through attacks and unleash powerful skills when full  
- 玩家生命值归零或坠落平台下方即判定失败  
  Players are defeated when HP reaches zero or they fall off the platform  

---

## 操作说明 | Controls

**玩家1 | Player 1**

- `A`：左移 | Move Left
- `D`：右移 | Move Right
- `W`：跳跃 | Jump
- `F`：普通攻击 | Normal Attack
- `G`：特殊攻击 | Special Attack

**玩家2 | Player 2**

- `←`：左移 | Move Left
- `→`：右移 | Move Right
- `↑`：跳跃 | Jump
- `.`：普通攻击 | Normal Attack
- `/`：特殊攻击 | Special Attack

---

## 快速开始 | Getting Started

### 中文说明：

1. 使用 Visual Studio 2022 打开项目解决方案文件（`.sln`）或新建空项目并导入源码  
2. 安装并配置 EasyX 图形库（包含目录和库目录）  
3. 选择“Release”或“Debug”模式，点击“本地 Windows 调试器”运行项目  

### English Instructions:

1. Open the `.sln` solution file in Visual Studio 2022, or create a new project and import the source files  
2. Install and configure the EasyX graphics library (include and lib paths)  
3. Select "Release" or "Debug" mode and run the project using "Local Windows Debugger"  

---

## 教程博客 | Tutorial Blog

👉 中文博客：[点击查看](https://nullshowjl.github.io/p/从零开始的c-游戏开发植物明星大乱斗之框架设计/)  
👉 Tutorial in English: [Read here](https://nullshowjl.github.io/en/p/c-game-dev-from-scratchplant-star-brawl-framework-design/)

---

## 致谢 | Acknowledgements

感谢B站UP主 **Voidmatrix** 提供高质量教程内容  
Special thanks to **Voidmatrix** for the excellent tutorial series