Metadata-Version: 2.1
Name: retro_game_engine
Version: 0.1.0
Summary: A lightweight, authentic 8-bit and 16-bit style game development framework
Home-page: https://github.com/ahmed5145/retro_game_engine
License: MIT
Keywords: game,engine,retro,pygame,2d
Author: Ahmed Mohamed
Author-email: ahmedmohamed200354@gmai.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: pygame
Requires-Dist: numpy (>=1.24.0,<2.0.0)
Requires-Dist: pygame (>=2.5.0,<3.0.0)
Project-URL: Repository, https://github.com/ahmed5145/retro_game_engine
Description-Content-Type: text/markdown

# Retro Game Engine

A lightweight, authentic 8-bit and 16-bit style game development framework focused on delivering pixel-perfect retro gaming experiences.

## Features (Planned)

- Pixel-perfect 2D rendering with multiple resolution modes
- Sprite system with animation support
- Tile-based map system
- Collision detection system
- Physics system with retro-appropriate constraints
- Input handling (keyboard, mouse, gamepad)
- Audio system with chiptune support
- Scene management
- Entity-Component System
- Development tools (Sprite Editor, Tilemap Editor)

## Development Status

Currently in initial development phase. See [ROADMAP.md](./ROADMAP.md) for detailed plans.

## Requirements

- Python 3.11+
- Poetry (for dependency management)
- Pygame 2.5.0+
- pytest for testing

## Quick Start

1. Clone the repository:

```bash
git clone https://github.com/ahmed5145/retro_game_engine.git
cd retro_game_engine
```

2. Install dependencies:

```bash
poetry install
```

3. Run tests:

```bash
poetry run pytest
```

## Project Structure

```text
retro_game_engine/
├── src/                  # Source code
│   ├── core/            # Core engine components
│   ├── graphics/        # Rendering and visual systems
│   └── utils/           # Utility functions
├── tests/               # Test suite
├── docs/                # Documentation
├── examples/            # Example games and demos
└── tools/               # Development tools
```

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.

## License

MIT License - See [LICENSE](./LICENSE) for details.

