# Pycraft

**Repository Path**: mmoon/pycraft

## Basic Information

- **Project Name**: Pycraft
- **Description**: Python大作业
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2025-07-29
- **Last Updated**: 2025-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pycraft

Pycraft是一个使用Python和OpenGL开发的3D游戏引擎，提供了基础的3D渲染、物理碰撞、音频系统等功能。

## 功能特性

- 3D图形渲染
- 物理碰撞检测
- 音频系统
- 世界生成
- 粒子系统
- 用户界面
- 模型加载
- 调试工具

## 系统要求

- Python 3.8+
- OpenGL兼容的显卡
- Windows操作系统

## 安装说明

1. 克隆仓库：
```bash
git clone https://gitee.com/asfgjkzxvbm/pycraft.git
cd Pycraft
```

2. 创建并激活虚拟环境：
```bash
python -m venv .venv
.venv\Scripts\activate
```

3. 安装依赖：
```bash
pip install -r requirements.txt
```

## 运行游戏

直接运行`main.py`文件：
```bash
python main.py
```

或者使用提供的`run.vbs`脚本（Windows系统）。

## 项目结构

- `Pycraft.py` - 主游戏引擎文件
- `World/` - 世界生成和地形相关代码
- `Utils/` - 工具函数
- `Resources/` - 游戏资源文件
- `Screenshots/` - 游戏截图
- `Saves/` - 游戏存档

## 主要依赖

- numpy - 数值计算
- pyrr - 3D数学运算
- glfw - 窗口管理
- PyOpenGL - OpenGL绑定
- PyOpenAL - 音频系统
- pillow - 图像处理
- numba - 性能优化
- noise - 噪声生成
- ttkbootstrap - 用户界面

## 开发说明

项目使用Python开发，主要依赖OpenGL进行3D渲染。代码结构清晰，模块化程度高，便于扩展和维护。

## 许可证

本项目采用MIT许可证。详见[LICENSE](LICENSE)文件。

## 贡献

欢迎提交Issue和Pull Request来帮助改进项目。

## 联系方式

如有问题或建议，请通过GitHub Issues联系。

## 展示截图

游戏实机截图（Windows系统）：

| 主菜单 | 加载界面 |
|:---:|:---:|
| <img src="Resources/Readme_Images/main_menu.png" alt="Screenshot 0" width="480"/> | <img src="Resources/Readme_Images/loading.png" alt="Screenshot 1" width="480"/> |

| 场景1 | 场景2 |
|:---:|:---:|
| <img src="Resources/Readme_Images/scene0.png" alt="Screenshot 2" width="480"/> | <img src="Resources/Readme_Images/scene1.png" alt="Screenshot 3" width="480"/> |

| 物品栏与背包 | 场景3 |
|:---:|:---:|
| <img src="Resources/Readme_Images/inventory.png" alt="Screenshot 4" width="480"/> | <img src="Resources/Readme_Images/scene2.png" alt="Screenshot 5" width="480"/> |

| 场景4 | 场景5 |
|:---:|:---:|
| <img src="Resources/Readme_Images/scene3.png" alt="Screenshot 6" width="480"/> | <img src="Resources/Readme_Images/scene4.png" alt="Screenshot 7" width="480"/> |