aether-engine 1.1.0__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.1.0 → aether_engine-1.2.0}/aether/__init__.py

@@ -18,9 +18,12 @@ 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.editor import ModelEditor
+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.1.0"
+__version__ = "1.2.0"
 
 __all__ = [
     "Engine",
@@ -45,5 +48,11 @@ __all__ = [
     "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.1.0 → aether_engine-1.2.0}/aether/core/engine.py

@@ -54,7 +54,7 @@ class Engine:
         self.config.graphics.width = width
         self.config.graphics.height = height
 
-        print("[Aether] Initializing Engine v1.1.0...")
+        print("[Aether] Initializing Engine v1.2.0 by entiti937...")
 
         self.window = Window(
             self.config.graphics.width,
@@ -101,6 +101,7 @@ class Engine:
         self.free_camera = True
         self.fps_controller: Optional[FirstPersonController] = None
         self._update_callbacks = []
+        self.draw_hud = False  # overlay Renderer2D sprites on top of 3D
 
         self.event_bus.subscribe("window_resize", self._on_window_resize)
         self.event_bus.subscribe("engine_pause", self._on_pause)
@@ -327,7 +328,7 @@ class Engine:
 
     def _render(self):
         if self.mode == "2d":
-            self.renderer2d.begin_frame()
+            self.renderer2d.begin_frame(clear=True)
             self.renderer2d.render()
             self.renderer2d.end_frame()
             return
@@ -337,6 +338,18 @@ class Engine:
             self.renderer.render_scene(self.scene)
         self.renderer.end_frame()
 
+        if self.draw_hud:
+            # Overlay HUD without clearing the 3D framebuffer color
+            self.renderer2d.begin_frame(clear=False)
+            # Map HUD from pixel-ish coords: camera at 0, zoom so 1 unit ~= 1 px-ish
+            self.renderer2d.camera.x = 0
+            self.renderer2d.camera.y = 0
+            self.renderer2d.camera.zoom = 1.0
+            self.renderer2d.camera.width = float(self.config.graphics.width)
+            self.renderer2d.camera.height = float(self.config.graphics.height)
+            self.renderer2d.render()
+            self.renderer2d.end_frame()
+
     def on_update(self, callback):
         """Регистрирует callback(dt), вызываемый каждый кадр."""
         self._update_callbacks.append(callback)

{aether_engine-1.1.0 → aether_engine-1.2.0}/aether/graphics2d/__init__.py

@@ -100,12 +100,13 @@ class Renderer2D:
         self.sprites.append(sprite)
         return sprite
 
-    def begin_frame(self):
+    def begin_frame(self, clear: bool = True):
         glDisable(GL_DEPTH_TEST)
         glEnable(GL_BLEND)
         glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)
-        glClearColor(*self.clear_color)
-        glClear(GL_COLOR_BUFFER_BIT)
+        if clear:
+            glClearColor(*self.clear_color)
+            glClear(GL_COLOR_BUFFER_BIT)
 
     def render(self):
         self._shader.use()

aether_engine-1.2.0/aether/physics/raycast.py

@@ -0,0 +1,102 @@
+"""Raycasting against AABB / sphere colliders and voxel helpers."""
+from __future__ import annotations
+
+from typing import Optional
+
+import numpy as np
+
+
+class RaycastHit:
+    def __init__(self, point, normal, distance, entity=None, body=None):
+        self.point = np.asarray(point, dtype=np.float32)
+        self.normal = np.asarray(normal, dtype=np.float32)
+        self.distance = float(distance)
+        self.entity = entity
+        self.body = body
+
+
+def ray_aabb(origin, direction, bmin, bmax, max_distance=1000.0) -> Optional[float]:
+    origin = np.asarray(origin, dtype=np.float32)
+    direction = np.asarray(direction, dtype=np.float32)
+    length = np.linalg.norm(direction)
+    if length < 1e-8:
+        return None
+    direction = direction / length
+    tmin, tmax = 0.0, float(max_distance)
+    for i in range(3):
+        if abs(direction[i]) < 1e-8:
+            if origin[i] < bmin[i] or origin[i] > bmax[i]:
+                return None
+            continue
+        inv = 1.0 / direction[i]
+        t1 = (bmin[i] - origin[i]) * inv
+        t2 = (bmax[i] - origin[i]) * inv
+        if t1 > t2:
+            t1, t2 = t2, t1
+        tmin = max(tmin, t1)
+        tmax = min(tmax, t2)
+        if tmin > tmax:
+            return None
+    return tmin
+
+
+def ray_sphere(origin, direction, center, radius, max_distance=1000.0) -> Optional[float]:
+    origin = np.asarray(origin, dtype=np.float32)
+    direction = np.asarray(direction, dtype=np.float32)
+    center = np.asarray(center, dtype=np.float32)
+    length = np.linalg.norm(direction)
+    if length < 1e-8:
+        return None
+    direction = direction / length
+    oc = origin - center
+    b = float(np.dot(oc, direction))
+    c = float(np.dot(oc, oc) - radius * radius)
+    disc = b * b - c
+    if disc < 0:
+        return None
+    s = np.sqrt(disc)
+    t0 = -b - s
+    t1 = -b + s
+    for t in (t0, t1):
+        if 0.0 <= t <= max_distance:
+            return float(t)
+    return None
+
+
+class Raycaster:
+    """High-level raycast helper for PhysicsWorld3D bodies / custom AABBs."""
+
+    @staticmethod
+    def cast(world, origin, direction, max_distance=100.0) -> Optional[RaycastHit]:
+        if hasattr(world, "raycast"):
+            hit = world.raycast(origin, direction, max_distance)
+            if not hit:
+                return None
+            return RaycastHit(
+                point=hit["point"],
+                normal=(0, 1, 0),
+                distance=hit["distance"],
+                entity=hit.get("entity"),
+                body=hit.get("body"),
+            )
+        return None
+
+    @staticmethod
+    def cast_aabb_list(origin, direction, aabbs, max_distance=100.0) -> Optional[RaycastHit]:
+        """aabbs: iterable of (bmin, bmax, payload)."""
+        best_t = None
+        best_payload = None
+        for bmin, bmax, payload in aabbs:
+            t = ray_aabb(origin, direction, bmin, bmax, max_distance)
+            if t is None:
+                continue
+            if best_t is None or t < best_t:
+                best_t = t
+                best_payload = payload
+        if best_t is None:
+            return None
+        origin = np.asarray(origin, dtype=np.float32)
+        direction = np.asarray(direction, dtype=np.float32)
+        direction = direction / max(np.linalg.norm(direction), 1e-6)
+        point = origin + direction * best_t
+        return RaycastHit(point=point, normal=(0, 1, 0), distance=best_t, entity=best_payload)

aether_engine-1.2.0/aether/resources/save_load.py

@@ -0,0 +1,20 @@
+"""Simple JSON world / scene helpers."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any, Dict
+
+
+def save_json(path, data: Dict[str, Any]):
+    path = Path(path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data, indent=2), encoding="utf-8")
+    print(f"[Save] Wrote {path}")
+
+
+def load_json(path) -> Dict[str, Any]:
+    path = Path(path)
+    if not path.exists():
+        raise FileNotFoundError(path)
+    return json.loads(path.read_text(encoding="utf-8"))

aether_engine-1.2.0/aether/ui/__init__.py

@@ -0,0 +1,5 @@
+"""UI package."""
+
+from aether.ui.hud import Hud, HudBar
+
+__all__ = ["Hud", "HudBar"]

aether_engine-1.2.0/aether/ui/hud.py

@@ -0,0 +1,65 @@
+"""Minimal immediate-mode HUD overlay (screen-space quads via Renderer2D)."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Tuple
+
+from aether.graphics2d import Sprite
+
+
+@dataclass
+class HudBar:
+    label: str
+    value: float  # 0..1
+    color: Tuple[float, float, float, float] = (0.2, 0.85, 0.35, 0.95)
+    back: Tuple[float, float, float, float] = (0.1, 0.1, 0.12, 0.7)
+
+
+class Hud:
+    """Build sprites for a simple game HUD (hotbar, bars, crosshair)."""
+
+    def __init__(self, renderer2d):
+        self.r = renderer2d
+        self.sprites: List[Sprite] = []
+        self._owned: List[Sprite] = []
+
+    def clear(self):
+        for s in self._owned:
+            if s in self.r.sprites:
+                self.r.sprites.remove(s)
+        self._owned.clear()
+
+    def _add(self, sprite: Sprite) -> Sprite:
+        self.r.add_sprite(sprite)
+        self._owned.append(sprite)
+        return sprite
+
+    def draw_crosshair(self, size: float = 10.0, thickness: float = 2.0):
+        c = (1, 1, 1, 0.9)
+        self._add(Sprite(0, 0, size, thickness, color=c, layer=100))
+        self._add(Sprite(0, 0, thickness, size, color=c, layer=100))
+
+    def draw_hotbar(self, slots: int, selected: int, colors, y: float = -220):
+        slot_w, slot_h, gap = 44, 44, 6
+        total = slots * slot_w + (slots - 1) * gap
+        start_x = -total * 0.5 + slot_w * 0.5
+        for i in range(slots):
+            x = start_x + i * (slot_w + gap)
+            border = (1, 1, 0.3, 1) if i == selected else (0.15, 0.15, 0.18, 0.85)
+            self._add(Sprite(x, y, slot_w + 4, slot_h + 4, color=border, layer=90))
+            col = colors[i] if i < len(colors) else (0.4, 0.4, 0.4, 1)
+            self._add(Sprite(x, y, slot_w - 6, slot_h - 6, color=(*col[:3], 1.0), layer=91))
+
+    def draw_bar(self, x: float, y: float, width: float, height: float, bar: HudBar):
+        self._add(Sprite(x, y, width, height, color=bar.back, layer=80))
+        fill = max(0.0, min(1.0, bar.value)) * (width - 4)
+        self._add(
+            Sprite(
+                x - (width - fill) * 0.5 + 2,
+                y,
+                max(1.0, fill),
+                height - 4,
+                color=bar.color,
+                layer=81,
+            )
+        )

aether_engine-1.2.0/aether_engine.egg-info/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**