Metadata-Version: 2.4
Name: s3d-engine
Version: 1.0.0
Summary: Professional 3D Game Engine for Python
Home-page: https://github.com/hcode-lang/s3d-engine
Author: Fastech Türkiye
Author-email: communication@fasth.tech
License: MIT
Project-URL: Documentation, https://docs.s3dengine.com
Project-URL: Source, https://github.com/s3dengine/s3d-engine
Project-URL: Tracker, https://github.com/s3dengine/s3d-engine/issues
Keywords: 3d engine game development opengl graphics rendering
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygame>=2.0.0
Requires-Dist: PyOpenGL>=3.1.0
Requires-Dist: PyOpenGL-accelerate>=3.1.0
Requires-Dist: numpy>=1.20.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# S3D Engine - Professional 3D Game Engine for Python

**The easiest way to create stunning 3D games in Python!**

[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)](https://github.com/s3dengine/s3d-engine)

S3D Engine combines the performance of C# with the simplicity of Python, giving you professional 3D graphics with minimal code.

## 🚀 Quick Start

```python
import s3d

# That's it! One line creates a 3D window with a rotating cube
s3d.show("My Amazing Game")
```

## ✨ Features

- **🎯 Ultra Simple API** - Get 3D graphics running in seconds
- **⚡ High Performance** - C# core with Python bindings
- **🎮 Complete Game Engine** - ECS, Physics, Audio, Networking
- **🎨 Advanced Graphics** - PBR, Shadows, Post-processing, Compute Shaders
- **📱 Cross-Platform** - Windows, Linux, macOS support
- **🔧 Professional Tools** - Scene editor, Asset pipeline, Profiler
- **📚 Rich Documentation** - Comprehensive guides and examples
- **🌟 Modern Architecture** - Entity-Component-System design

## 📦 Installation

```bash
pip install s3d-engine
```

## 🎮 Examples

### Ultra Simple

```python
import s3d
s3d.show("My Game")  # One line = 3D window with rotating cube!
```

### Basic Game

```python
import s3d

# Create engine
engine = s3d.Engine.create_opengl("My 3D Game", 1920, 1080)

# Create entities
player = s3d.create_cube("Player")
player.transform.position = s3d.Vector3(0, 1, 0)

camera = s3d.create_camera("MainCamera")
camera.transform.position = s3d.Vector3(0, 2, -5)

light = s3d.create_light("Sun", s3d.LightType.DIRECTIONAL)

# Run the game
engine.run()
```

### FPS Controller

```python
class PlayerController(s3d.ScriptComponent):
    def update(self, delta_time):
        # Movement
        h = s3d.Input.get_axis("Horizontal")
        v = s3d.Input.get_axis("Vertical")
        
        move = self.transform.forward * v + self.transform.right * h
        self.transform.translate(move * 5.0 * delta_time)
        
        # Mouse look
        mouse = s3d.Input.get_mouse_delta()
        self.transform.rotate(s3d.Vector3(0, mouse.x * 2.0, 0))

player.add_component(PlayerController)
```

## 🎯 Use Cases

- **Indie Games** - Rapid prototyping to full production
- **Game Jams** - Get impressive results quickly
- **Educational Projects** - Learn 3D graphics programming
- **Simulations** - Scientific and engineering visualizations
- **VR/AR Applications** - Immersive experiences
- **Architectural Visualization** - 3D walkthroughs
- **Product Showcases** - Interactive 3D presentations

## 🏗️ Architecture

S3D Engine uses a modern Entity-Component-System (ECS) architecture:

```python
# Entities are containers
player = s3d.create_entity("Player")

# Components add functionality
transform = player.add_component(s3d.Transform)
renderer = player.add_component(s3d.MeshRenderer)
rigidbody = player.add_component(s3d.Rigidbody)

# Systems process components
physics_system = s3d.PhysicsSystem()
render_system = s3d.RenderSystem()
```

## 📚 Documentation

- **[Complete API Documentation](S3D-API-Documentation.md)** - Full reference with examples
- **[Ultra Simple Demo](ultra_simple_demo.py)** - One-line 3D graphics

## 📄 License

S3D Engine is released under the MIT License, making it free for both personal and commercial projects.

---

**Made with ❤️ by the S3D Engine Team**

**Ready to create amazing 3D games? Try the demo now!**

```bash
python ultra_simple_demo.py
```
