Metadata-Version: 2.4
Name: chengfeng
Version: 0.1.0
Summary: 乘风 ChengFeng - 3D drone flight demo with Ursina engine
Author: cycleuser
License: GPL-3.0
Project-URL: Homepage, https://github.com/CodeOfMe/ChengFeng
Project-URL: Repository, https://github.com/CodeOfMe/ChengFeng
Keywords: drone,3d,game,ursina,flight
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment :: Simulation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: ursina>=8.0.0
Requires-Dist: numpy>=1.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

# ChengFeng (乘风) - 3D Drone Flight Demo

A minimal 3D drone flight simulation built with the Ursina engine. Fly a
quadcopter over a green landscape with drifting clouds, hills, and a grid
ground reference.

## Features

- 3D quadcopter model with spinning propellers and landing skids
- Drifting volumetric clouds
- Textured ground with grid lines and decorative hills
- Directional sunlight with shadows
- Smooth camera follow
- Real-time HUD: altitude, speed, position, FPS

## Requirements

- Python 3.10+
- OpenGL-capable display

## Installation

```bash
pip install chengfeng
```

## Usage

```bash
chengfeng
# or
python -m chengfeng
```

## Controls

| Key | Action |
|-----|--------|
| W / S | Throttle up / down (ascend / descend) |
| A / D | Strafe left / right |
| Up / Down Arrow | Pitch forward / back |
| Left / Right Arrow | Yaw left / right |
| Space | Boost (2.5x speed) |
| R | Reset position |
| ESC | Quit |

## License

GPL-3.0
