aether-engine 1.0.4__tar.gz → 1.2.0__tar.gz

aether_engine-1.2.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: aether-engine
+Version: 1.2.0
+Summary: 3D/2D game engine by entiti937 — OpenGL, physics, FPS, model editor, HUD
+Home-page: https://pypi.org/project/aether-engine/
+Author: entiti937
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: glfw>=2.6
+Requires-Dist: PyOpenGL>=3.1.7
+Requires-Dist: Pillow>=10.0
+Provides-Extra: audio
+Requires-Dist: pygame-ce>=2.5; extra == "audio"
+Provides-Extra: physics
+Requires-Dist: pymunk>=6.0; extra == "physics"
+Provides-Extra: models
+Requires-Dist: trimesh>=3.21; extra == "models"
+Provides-Extra: full
+Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: pygame-ce>=2.5; extra == "full"
+Requires-Dist: trimesh>=3.21; extra == "full"
+Requires-Dist: pymunk>=6.0; extra == "full"
+Requires-Dist: freetype-py>=2.4; extra == "full"
+Requires-Dist: imageio>=2.31; extra == "full"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Aether Engine
+
+**3D / 2D игровой движок на Python + OpenGL**  
+**Разработчик:** entiti937 · **Версия:** 1.2.0 · **Лицензия:** MIT  
+**PyPI:** https://pypi.org/project/aether-engine/
+
+> Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
+
+---
+
+## Установка
+
+```bash
+pip install -U "aether-engine[full]"
+```
+
+## Showcase-игра (доказательство)
+
+Minecraft-like sandbox **на этом же движке**:
+
+```bash
+python games/aether_craft.py
+```
+
+Там есть: воксельный мир, вид от 1 лица, ломать/ставить блоки, HUD, звуки, день/ночь, сейвы (F5/F9), урон и респавн.
+
+## Другие запуски
+
+```bash
+python -m aether.editor
+python games/orb_rush.py
+python examples/03_first_person.py
+python examples/04_physics2d.py
+```
+
+## Минимальный код
+
+```python
+from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
+from aether.scene.component import Transform, MeshRenderer
+
+engine = Engine(1280, 720, "Game by you — engine by entiti937")
+scene = Scene("Main")
+camera = Camera(position=(0, 2, 6), yaw=-90)
+scene.set_main_camera(camera)
+
+cube = Entity("Cube")
+cube.add_component(Transform(position=(0, 1, 0)))
+mat = Material(); mat.albedo[:] = (0.2, 0.85, 1.0)
+cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
+scene.spawn(cube)
+
+engine.load_scene(scene)
+engine.enable_first_person(camera)
+engine.run()
+```
+
+## Возможности 1.2
+
+- PBR 3D + sprites 2D + HUD overlay
+- FPS (`enable_first_person`) и free-look камера
+- Физика 3D/2D + raycast
+- `ModelLoader` (OBJ/GLB/glTF/STL/FBX/…)
+- Встроенный voxel model editor
+- Procedural SFX, JSON save/load
+- Примеры и две игры в репозитории
+
+## Документация
+
+Все команды, API и туториалы: **[docs/GUIDE.md](docs/GUIDE.md)**
+
+---
+
+Aether Engine © **entiti937**

aether_engine-1.2.0/README.md

@@ -0,0 +1,74 @@
+# Aether Engine
+
+**3D / 2D игровой движок на Python + OpenGL**  
+**Разработчик:** entiti937 · **Версия:** 1.2.0 · **Лицензия:** MIT  
+**PyPI:** https://pypi.org/project/aether-engine/
+
+> Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
+
+---
+
+## Установка
+
+```bash
+pip install -U "aether-engine[full]"
+```
+
+## Showcase-игра (доказательство)
+
+Minecraft-like sandbox **на этом же движке**:
+
+```bash
+python games/aether_craft.py
+```
+
+Там есть: воксельный мир, вид от 1 лица, ломать/ставить блоки, HUD, звуки, день/ночь, сейвы (F5/F9), урон и респавн.
+
+## Другие запуски
+
+```bash
+python -m aether.editor
+python games/orb_rush.py
+python examples/03_first_person.py
+python examples/04_physics2d.py
+```
+
+## Минимальный код
+
+```python
+from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
+from aether.scene.component import Transform, MeshRenderer
+
+engine = Engine(1280, 720, "Game by you — engine by entiti937")
+scene = Scene("Main")
+camera = Camera(position=(0, 2, 6), yaw=-90)
+scene.set_main_camera(camera)
+
+cube = Entity("Cube")
+cube.add_component(Transform(position=(0, 1, 0)))
+mat = Material(); mat.albedo[:] = (0.2, 0.85, 1.0)
+cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
+scene.spawn(cube)
+
+engine.load_scene(scene)
+engine.enable_first_person(camera)
+engine.run()
+```
+
+## Возможности 1.2
+
+- PBR 3D + sprites 2D + HUD overlay
+- FPS (`enable_first_person`) и free-look камера
+- Физика 3D/2D + raycast
+- `ModelLoader` (OBJ/GLB/glTF/STL/FBX/…)
+- Встроенный voxel model editor
+- Procedural SFX, JSON save/load
+- Примеры и две игры в репозитории
+
+## Документация
+
+Все команды, API и туториалы: **[docs/GUIDE.md](docs/GUIDE.md)**
+
+---
+
+Aether Engine © **entiti937**

aether_engine-1.2.0/aether/__init__.py

@@ -0,0 +1,58 @@
+"""Aether Engine — 3D / 2D game engine"""
+
+from aether.core.engine import Engine
+from aether.scene.scene import Scene
+from aether.scene.entity import Entity
+from aether.scene.component import (
+    Transform,
+    MeshRenderer,
+    CameraComponent,
+    LightComponent,
+    RigidbodyComponent,
+    ScriptComponent,
+)
+from aether.graphics.mesh_factory import MeshFactory
+from aether.graphics.material import Material
+from aether.graphics.camera import Camera
+from aether.graphics.first_person import FirstPersonController
+from aether.resources.loaders.model_loader import ModelLoader
+from aether.physics import PhysicsWorld2D, PhysicsWorld3D, BoxCollider, SphereCollider
+from aether.graphics2d import Renderer2D, Sprite, Camera2D
+from aether.ui.hud import Hud, HudBar
+from aether.audio.sfx import SfxBank
+from aether.resources.save_load import save_json, load_json
+from aether.physics.raycast import Raycaster
+
+__version__ = "1.2.0"
+
+__all__ = [
+    "Engine",
+    "Scene",
+    "Entity",
+    "Transform",
+    "MeshRenderer",
+    "CameraComponent",
+    "LightComponent",
+    "RigidbodyComponent",
+    "ScriptComponent",
+    "MeshFactory",
+    "Material",
+    "Camera",
+    "FirstPersonController",
+    "ModelLoader",
+    "PhysicsWorld2D",
+    "PhysicsWorld3D",
+    "BoxCollider",
+    "SphereCollider",
+    "Renderer2D",
+    "Sprite",
+    "Camera2D",
+    "ModelEditor",
+    "Hud",
+    "HudBar",
+    "SfxBank",
+    "save_json",
+    "load_json",
+    "Raycaster",
+    "__version__",
+]

aether_engine-1.2.0/aether/audio/sfx.py

@@ -0,0 +1,85 @@
+"""Procedural sound helpers (no asset files required)."""
+from __future__ import annotations
+
+import math
+import struct
+import tempfile
+import wave
+from pathlib import Path
+from typing import Optional
+
+
+def _write_wav(path: Path, samples, rate: int = 22050):
+    with wave.open(str(path), "w") as wf:
+        wf.setnchannels(1)
+        wf.setsampwidth(2)
+        wf.setframerate(rate)
+        frames = b"".join(struct.pack("<h", int(max(-1, min(1, s)) * 32767)) for s in samples)
+        wf.writeframes(frames)
+
+
+def make_tone(
+    frequency: float = 440.0,
+    duration: float = 0.08,
+    volume: float = 0.35,
+    kind: str = "square",
+    rate: int = 22050,
+) -> Path:
+    """Generate a short WAV tone and return its path."""
+    n = int(rate * duration)
+    samples = []
+    for i in range(n):
+        t = i / rate
+        env = 1.0
+        if i < rate * 0.01:
+            env = i / (rate * 0.01)
+        elif i > n - rate * 0.02:
+            env = max(0.0, (n - i) / (rate * 0.02))
+        phase = 2 * math.pi * frequency * t
+        if kind == "sine":
+            val = math.sin(phase)
+        elif kind == "noise":
+            # deterministic pseudo-noise
+            val = math.sin(phase * 12.9898) * 2.0 % 2.0 - 1.0
+        else:
+            val = 1.0 if math.sin(phase) >= 0 else -1.0
+        samples.append(val * volume * env)
+
+    path = Path(tempfile.gettempdir()) / f"aether_tone_{int(frequency)}_{kind}.wav"
+    _write_wav(path, samples, rate)
+    return path
+
+
+class SfxBank:
+    """Lazy bank of procedural SFX played through Engine.audio."""
+
+    def __init__(self, audio_manager):
+        self.audio = audio_manager
+        self._cache = {}
+
+    def _get(self, key: str, factory):
+        if key not in self._cache:
+            path = factory()
+            # AudioManager.load_sound(name, path)
+            self._cache[key] = self.audio.load_sound(key, str(path))
+        return self._cache[key]
+
+    def play_break(self):
+        snd = self._get("break", lambda: make_tone(180, 0.07, 0.4, "noise"))
+        if snd:
+            self.audio.play_sound("break", volume=0.45)
+
+    def play_place(self):
+        snd = self._get("place", lambda: make_tone(520, 0.06, 0.3, "square"))
+        if snd:
+            self.audio.play_sound("place", volume=0.4)
+
+    def play_select(self):
+        snd = self._get("select", lambda: make_tone(760, 0.04, 0.25, "sine"))
+        if snd:
+            self.audio.play_sound("select", volume=0.35)
+
+    def play_hurt(self):
+        snd = self._get("hurt", lambda: make_tone(120, 0.12, 0.45, "square"))
+        if snd:
+            self.audio.play_sound("hurt", volume=0.5)

aether_engine-1.2.0/aether/core/__init__.py

@@ -0,0 +1,17 @@
+"""Core subsystem of Aether Engine."""
+
+from aether.core.engine import Engine
+from aether.core.window import Window
+from aether.core.input import Input
+from aether.core.time_manager import Time
+from aether.core.event_bus import EventBus
+from aether.core.config import EngineConfig
+
+__all__ = [
+    "Engine",
+    "Window",
+    "Input",
+    "Time",
+    "EventBus",
+    "EngineConfig",
+]