# 超级马里奥

**Repository Path**: psw456789/super-mario

## Basic Information

- **Project Name**: 超级马里奥
- **Description**: 一个致敬经典游戏的开源项目，复刻超级马里奥核心玩法，提供可扩展的2D平台引擎，助力开发者学习游戏开发与物理模拟。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-04
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 超级马里奥复刻版

这是一个使用 Python 和 Pygame 库开发的经典超级马里奥游戏复刻版本。项目完整还原了童年经典游戏的核心玩法，包括角色控制、敌人追踪、道具系统、关卡设计等核心功能。

## 游戏特性

- **经典玩法还原**：支持移动、跳跃、加速等多种操作
- **道具系统**：蘑菇、星星、火球等经典道具
- **敌人类型**：包括蘑菇怪、乌龟、食人花、霸王库巴等
- **多关卡设计**：包含4个不同的关卡地图
- **存档功能**：支持游戏进度保存与加载
- **音效系统**：完整的背景音乐和游戏音效

## 操作说明

| 功能 | 按键 |
|------|------|
| 向左移动 | ← |
| 向右移动 | → |
| 跳跃 | ↑ |
| 加速跑动 | 按住 S 键 |
| 开始游戏 | 回车键 |
| 发射火球 | 空格键（开火状态下） |

## 环境要求

- Python 3.x
- Pygame 库

安装依赖：

```bash
pip install pygame
```

## 运行方法

1. 克隆或下载项目代码
2. 进入项目目录
3. 执行以下命令启动游戏：

```bash
python main.py
```

## 项目结构

```
├── main.py                 # 游戏主入口
├── source/
│   ├── components/         # 游戏组件模块
│   │   ├── box.py          # 道具箱类
│   │   ├── brick.py        # 砖块类
│   │   ├── coin.py         # 金币类
│   │   ├── enemy.py        # 敌人基类及实现
│   │   ├── info.py         # 游戏信息显示
│   │   ├── manager.py      # 存档管理
│   │   ├── player.py       # 玩家角色类
│   │   ├── powerup.py      # 道具类
│   │   └── stuff.py        # 游戏场景物品
│   ├── states/             # 游戏状态管理
│   │   ├── level.py        # 关卡状态
│   │   ├── load_screen.py  # 加载界面
│   │   └── main_menu.py    # 主菜单
│   ├── tools.py            # 工具函数
│   ├── constants.py        # 常量定义
│   ├── setup.py            # 初始化配置
│   └── sound.py            # 音频处理
├── resources/
│   ├── data/               # 游戏数据
│   │   ├── maps/           # 关卡地图数据
│   │   ├── player/         # 角色数据
│   │   └── save/           # 存档文件
│   ├── graphics/           # 图像资源
│   ├── music/              # 背景音乐
│   └── sound/              # 游戏音效
└── dist/                   # 可执行文件目录
```

## 核心模块说明

### 游戏组件 (source/components/)

- **player.py**：玩家角色类，实现马里奥和路易吉的所有动作和状态
- **enemy.py**：敌人系统，包含多种敌人工智能和行为模式
- **brick.py** / **box.py**：地图元素交互系统
- **powerup.py**：道具系统，包括蘑菇、星星、火花等
- **coin.py**：金币收集系统
- **manager.py**：存档管理，负责游戏进度保存

### 游戏状态 (source/states/)

- **main_menu.py**：主菜单界面
- **level.py**：关卡游戏主逻辑
- **load_screen.py**：游戏加载和结束画面

## 资源目录

| 资源类型 | 目录位置 |
|---------|---------|
| 存档文件 | resources/data/save/ |
| 关卡地图 | resources/data/maps/ |
| 角色数据 | resources/data/player/ |
| 游戏音乐 | resources/music/ |
| 音效文件 | resources/sound/ |
| 图像资源 | resources/graphics/ |

## 注意事项

1. **输入法问题**：启动游戏时输入法会自动切换为中文，需切换至英文输入法按键才能正常响应
2. **关卡进度**：第二关尚未完全完善，在水管处按向下键可进入第二关出口
3. **双人模式**：目前仅搭建了框架，尚未实装完整功能

## 更新计划

- 完善第二关内容
- 实装双人游戏模式
- 优化关卡设计
- 增加更多道具和敌人类型

## 许可证

本项目仅供学习交流使用。

## 贡献者

感谢所有为项目提供支持和建议的开发者！

---

如果觉得项目不错，欢迎在 Gitee 上留下你的 Star⭐，你的认可是我持续贡献开源项目的动力！