aether-engine 1.7.0__tar.gz → 1.8.0__tar.gz

{aether_engine-1.7.0/aether_engine.egg-info → aether_engine-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aether-engine
-Version: 1.7.0
+Version: 1.8.0
 Summary: 3D/2D game engine by entiti937 — OpenGL, physics, FPS, mandatory branding splash
 Home-page: https://pypi.org/project/aether-engine/
 Author: entiti937
@@ -31,13 +31,13 @@ Requires-Dist: trimesh>=3.21; extra == "models"
 Provides-Extra: build
 Requires-Dist: pyinstaller>=6.0; extra == "build"
 Provides-Extra: full
-Requires-Dist: freetype-py>=2.4; extra == "full"
-Requires-Dist: imageio>=2.31; extra == "full"
 Requires-Dist: pygame-ce>=2.5; extra == "full"
-Requires-Dist: pyyaml>=6.0; extra == "full"
 Requires-Dist: trimesh>=3.21; extra == "full"
-Requires-Dist: pymunk>=6.0; extra == "full"
+Requires-Dist: imageio>=2.31; extra == "full"
 Requires-Dist: pyinstaller>=6.0; extra == "full"
+Requires-Dist: pyyaml>=6.0; extra == "full"
+Requires-Dist: pymunk>=6.0; extra == "full"
+Requires-Dist: freetype-py>=2.4; extra == "full"
 Dynamic: author
 Dynamic: classifier
 Dynamic: description
@@ -52,10 +52,10 @@ Dynamic: summary
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.7.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.8.0 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
-> Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md)
+> Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md) · сайт: `aether website`
 
 ---
 
@@ -65,38 +65,26 @@ Dynamic: summary
 pip install -U "aether-engine[full]"
 ```
 
-## Что нового в 1.7.0
-
-- **AssetLoader** — загрузка любых моделей, спрайтов и текстур (OBJ/GLB/FBX/PNG/WebP/…)
-- `Sprite.from_image(path)` — быстрый импорт 2D-графики
-- Встроенный редактор **убран** (может вернуться в будущих версиях)
-
-## Showcase-игра
-
-Minecraft-like sandbox **на этом же движке**:
-
-```bash
-aether help
-aether build games/aether_craft.py --name AetherCraft
-python games/aether_craft.py
+```python
+import aether          # правильно
+# import aether_engine  # НЕПРАВИЛЬНО — такого модуля нет
 ```
 
-Там есть: воксельный мир, вид от 1 лица, ломать/ставить блоки, HUD, звуки, день/ночь, сейвы (F5/F9), урон и респавн.
-
-## Другие запуски
+## Что нового в 1.8.0
 
-```bash
-python games/orb_rush.py
-python examples/03_first_person.py
-python examples/04_physics2d.py
-aether website
-```
+- `Scene.remove()` / `despawn()` / `find()`
+- `MeshFactory.create_cylinder(...)`
+- `Camera.look_at(target)` + безопасное присвоение `cam.position = (x,y,z)`
+- HUD: `draw_rect`, `draw_panel`
+- Полный **API Reference** в документации (и `/plain/all` для ИИ)
 
 ## Минимальный код
 
 ```python
-from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-from aether.scene.component import Transform, MeshRenderer
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
 
 engine = Engine(1280, 720, "Game by you — engine by entiti937")
 scene = Scene("Main")
@@ -105,7 +93,8 @@ 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)
+mat = Material()
+mat.albedo[:] = (0.2, 0.85, 1.0)
 cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
 scene.spawn(cube)
 
@@ -114,20 +103,22 @@ engine.enable_first_person(camera)
 engine.run()
 ```
 
-## Возможности
-
-- PBR 3D + sprites 2D + HUD overlay
-- FPS (`enable_first_person`) и free-look камера
-- Физика 3D/2D + raycast
-- `AssetLoader` / `ModelLoader` — OBJ/GLB/glTF/STL/FBX/STEP/… + PNG/WebP спрайты
-- Procedural SFX, JSON save/load
-- Примеры и игры в репозитории
+## Частые операции
 
-> Встроенный редактор моделей/пиксель-арт **временно убран** — планируется вернуть позже. Сейчас используйте Blender, Aseprite и т.д., файлы подгружайте через `AssetLoader`.
+```python
+scene.remove(entity)                 # удалить объект
+MeshFactory.create_cylinder(0.5, 2)  # цилиндр
+cam.look_at(player_tf.position)      # смотреть на игрока
+engine.free_camera = False           # своя камера (не WASD fly)
+```
 
-## Документация
+## Возможности
 
-Все команды, API и туториалы: **[docs/GUIDE.md](docs/GUIDE.md)**
+- PBR 3D + sprites 2D + HUD overlay
+- FPS / free-look / `look_at` follow-камера
+- Физика 2D (pymunk) + лёгкий 3D solver
+- `AssetLoader` — модели и спрайты
+- `aether website` + plain docs для LLM
 
 ---
 

aether_engine-1.8.0/README.md

@@ -0,0 +1,74 @@
+# Aether Engine
+
+**3D / 2D игровой движок на Python + OpenGL**  
+**Разработчик:** entiti937 · **Версия:** 1.8.0 · **Лицензия:** MIT  
+**PyPI:** https://pypi.org/project/aether-engine/
+
+> Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md) · сайт: `aether website`
+
+---
+
+## Установка
+
+```bash
+pip install -U "aether-engine[full]"
+```
+
+```python
+import aether          # правильно
+# import aether_engine  # НЕПРАВИЛЬНО — такого модуля нет
+```
+
+## Что нового в 1.8.0
+
+- `Scene.remove()` / `despawn()` / `find()`
+- `MeshFactory.create_cylinder(...)`
+- `Camera.look_at(target)` + безопасное присвоение `cam.position = (x,y,z)`
+- HUD: `draw_rect`, `draw_panel`
+- Полный **API Reference** в документации (и `/plain/all` для ИИ)
+
+## Минимальный код
+
+```python
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
+
+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()
+```
+
+## Частые операции
+
+```python
+scene.remove(entity)                 # удалить объект
+MeshFactory.create_cylinder(0.5, 2)  # цилиндр
+cam.look_at(player_tf.position)      # смотреть на игрока
+engine.free_camera = False           # своя камера (не WASD fly)
+```
+
+## Возможности
+
+- PBR 3D + sprites 2D + HUD overlay
+- FPS / free-look / `look_at` follow-камера
+- Физика 2D (pymunk) + лёгкий 3D solver
+- `AssetLoader` — модели и спрайты
+- `aether website` + plain docs для LLM
+
+---
+
+Aether Engine © **entiti937**

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/__init__.py

@@ -31,7 +31,7 @@ from aether.audio.sfx import SfxBank
 from aether.resources.save_load import save_json, load_json
 from aether.physics.raycast import Raycaster
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"
 
 from aether.graphics.voxel_mesh import ChunkedVoxelMesher
 from aether.accelerators import is_native_available, backend_name

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/cli.py

@@ -15,10 +15,11 @@ QUICK_REFERENCE = f"""
 
 УСТАНОВКА
   pip install -U "aether-engine[full]"
+  # пакет на PyPI: aether-engine
+  # импорт в коде:  import aether   (НЕ aether_engine)
 
 МИНИМАЛЬНЫЙ КОД (3D)
-  from aether import Engine, Scene, Entity, MeshFactory, Material, Camera
-  from aether.scene.component import Transform, MeshRenderer
+  from aether import Engine, Scene, Entity, Transform, MeshRenderer, MeshFactory, Material, Camera
 
   engine = Engine(1280, 720, "My Game")
   scene = Scene("Main")
@@ -27,7 +28,8 @@ QUICK_REFERENCE = f"""
 
   cube = Entity("Cube")
   cube.add_component(Transform(position=(0, 1, 0)))
-  mat = Material(); mat.albedo[:] = (0.2, 0.9, 0.3)
+  mat = Material()
+  mat.albedo[:] = (0.2, 0.9, 0.3)
   cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
   scene.spawn(cube)
 
@@ -35,6 +37,34 @@ QUICK_REFERENCE = f"""
   engine.enable_first_person(cam)   # FPS
   engine.run()                      # ESC — выход
 
+УДАЛЕНИЕ ОБЪЕКТОВ
+  scene.remove(entity)     # убрать из сцены + destroy()
+  # или entity.destroy()  # только компоненты (лучше scene.remove)
+
+ПРИМИТИВЫ MeshFactory
+  create_cube(size=1)
+  create_plane(size=10)
+  create_sphere(radius=1, sectors=24, stacks=16)
+  create_cylinder(radius=0.5, height=1, segments=24)
+  create_pyramid(size=1, height=1)
+
+КАМЕРА
+  cam.position = (x, y, z)   # numpy array под капотом
+  cam.yaw, cam.pitch, cam.fov
+  cam.look_at(target)        # смотреть на точку/игрока
+  cam.rotate(dx, dy)
+  engine.free_camera = False # если управляете камерой сами
+
+TRANSFORM
+  tf.position  # np.ndarray float32, можно tf.position[:] = (x,y,z)
+  tf.set_position(x,y,z) / set_rotation / set_scale
+  tf.translate(dx,dy,dz)
+
+HUD
+  engine.draw_hud = True
+  hud = Hud(engine.renderer2d)
+  hud.clear(); hud.draw_crosshair(); hud.draw_bar(...); hud.draw_hotbar(...)
+
 FPS / КАМЕРА
   engine.enable_first_person(camera, eye_height=1.7, walk_speed=6)
   engine.free_camera = True         # WASD + Tab (мышь)

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/core/_identity.py

@@ -20,7 +20,7 @@ _B = {
     ]),
     "sig": bytes([
         230, 194, 211, 207, 194, 213, 135, 226, 201, 192, 206, 201, 194,
-        135, 150, 137, 144, 137, 151,
+        135, 150, 137, 159, 137, 151,
     ]),
 }
 

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/graphics/camera.py

@@ -1,10 +1,16 @@
 """Камера"""
+from __future__ import annotations
+
+from typing import Sequence, Union
+
 import numpy as np
 
+Vec3 = Union[Sequence[float], np.ndarray]
+
 
 class Camera:
     def __init__(self, position=(0, 2, 10), yaw=-90, pitch=0, fov=60):
-        self.position = np.array(position, dtype=np.float32)
+        self._position = np.array(position, dtype=np.float32)
         self.yaw = float(yaw)
         self.pitch = float(pitch)
         self.fov = float(fov)
@@ -15,6 +21,17 @@ class Camera:
 
         self._update_vectors()
 
+    @property
+    def position(self) -> np.ndarray:
+        return self._position
+
+    @position.setter
+    def position(self, value: Vec3):
+        self._position = np.asarray(value, dtype=np.float32).reshape(3)
+
+    def set_position(self, x: float, y: float, z: float):
+        self._position[:] = (x, y, z)
+
     def _update_vectors(self):
         front = np.array(
             [
@@ -36,12 +53,24 @@ class Camera:
         self.right = right
         self.up = np.cross(self.right, self.front)
 
+    def look_at(self, target: Vec3, world_up=(0.0, 1.0, 0.0)):
+        """Point the camera at a world-space target (updates yaw/pitch)."""
+        target = np.asarray(target, dtype=np.float32).reshape(3)
+        direction = target - self._position
+        length = float(np.linalg.norm(direction))
+        if length < 1e-6:
+            return
+        direction = direction / length
+        self.pitch = float(np.degrees(np.arcsin(np.clip(direction[1], -1.0, 1.0))))
+        self.yaw = float(np.degrees(np.arctan2(direction[2], direction[0])))
+        self.pitch = max(-89.0, min(89.0, self.pitch))
+        self._update_vectors()
+
     def get_view_matrix(self) -> np.ndarray:
-        # Column-vector math matrix (uploaded with GL_TRUE / row-major).
         s = self.right
         u = self.up
         f = self.front
-        p = self.position
+        p = self._position
 
         view = np.identity(4, dtype=np.float32)
         view[0, :3] = s
@@ -67,22 +96,22 @@ class Camera:
         )
 
     def move_forward(self, dt):
-        self.position += self.front * self.speed * dt
+        self._position += self.front * self.speed * dt
 
     def move_backward(self, dt):
-        self.position -= self.front * self.speed * dt
+        self._position -= self.front * self.speed * dt
 
     def move_left(self, dt):
-        self.position -= self.right * self.speed * dt
+        self._position -= self.right * self.speed * dt
 
     def move_right(self, dt):
-        self.position += self.right * self.speed * dt
+        self._position += self.right * self.speed * dt
 
     def move_up(self, dt):
-        self.position[1] += self.speed * dt
+        self._position[1] += self.speed * dt
 
     def move_down(self, dt):
-        self.position[1] -= self.speed * dt
+        self._position[1] -= self.speed * dt
 
     def rotate(self, dx, dy):
         self.yaw += dx * self.sensitivity

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/graphics/mesh_factory.py

@@ -134,6 +134,74 @@ class MeshFactory:
 
         return Mesh(vertices, indices)
 
+    @staticmethod
+    def create_cylinder(
+        radius: float = 0.5,
+        height: float = 1.0,
+        segments: int = 24,
+        capped: bool = True,
+    ) -> Mesh:
+        """
+        Cylinder along Y axis, centered at origin.
+        height is full height (from -h/2 to +h/2).
+        """
+        segments = max(3, int(segments))
+        half = height * 0.5
+        vertices: list[float] = []
+        indices: list[int] = []
+
+        # Side rings (top and bottom edge)
+        for i in range(segments + 1):
+            angle = i * 2.0 * math.pi / segments
+            c = math.cos(angle)
+            s = math.sin(angle)
+            x = radius * c
+            z = radius * s
+            nx, nz = c, s
+            u = i / segments
+            # bottom
+            vertices.extend([x, -half, z, nx, 0.0, nz, u, 0.0])
+            # top
+            vertices.extend([x, half, z, nx, 0.0, nz, u, 1.0])
+
+        for i in range(segments):
+            b0 = i * 2
+            t0 = b0 + 1
+            b1 = (i + 1) * 2
+            t1 = b1 + 1
+            indices.extend([b0, b1, t1, b0, t1, t0])
+
+        if capped:
+            # Bottom cap center + rim
+            center_bottom = len(vertices) // 8
+            vertices.extend([0.0, -half, 0.0, 0.0, -1.0, 0.0, 0.5, 0.5])
+            rim_start = center_bottom + 1
+            for i in range(segments):
+                angle = i * 2.0 * math.pi / segments
+                x = radius * math.cos(angle)
+                z = radius * math.sin(angle)
+                vertices.extend([x, -half, z, 0.0, -1.0, 0.0, 0.5 + 0.5 * math.cos(angle), 0.5 + 0.5 * math.sin(angle)])
+            for i in range(segments):
+                i0 = rim_start + i
+                i1 = rim_start + ((i + 1) % segments)
+                indices.extend([center_bottom, i1, i0])
+
+            # Top cap
+            center_top = len(vertices) // 8
+            vertices.extend([0.0, half, 0.0, 0.0, 1.0, 0.0, 0.5, 0.5])
+            rim_start = center_top + 1
+            for i in range(segments):
+                angle = i * 2.0 * math.pi / segments
+                x = radius * math.cos(angle)
+                z = radius * math.sin(angle)
+                vertices.extend([x, half, z, 0.0, 1.0, 0.0, 0.5 + 0.5 * math.cos(angle), 0.5 + 0.5 * math.sin(angle)])
+            for i in range(segments):
+                i0 = rim_start + i
+                i1 = rim_start + ((i + 1) % segments)
+                indices.extend([center_top, i0, i1])
+
+        return Mesh(vertices, indices)
+
     @staticmethod
     def create_sphere(radius: float = 1.0, sectors: int = 24, stacks: int = 16) -> Mesh:
         """

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/scene/component.py

@@ -84,8 +84,8 @@ class Transform(Component):
         self._matrix_dirty = False
 
     def get_model_matrix(self) -> np.ndarray:
-        if self._matrix_dirty:
-            self._update_matrix()
+        # Always rebuild so in-place edits like tf.position[0] = x stay correct
+        self._update_matrix()
         return self._cached_matrix
 
     def set_position(self, x, y, z):
@@ -109,7 +109,7 @@ class Transform(Component):
         self._matrix_dirty = True
 
     def look_at(self, target):
-        target = np.asarray(target, dtype=np.float32)
+        target = np.asarray(target, dtype=np.float32).reshape(3)
         direction = target - self.position
         length = np.linalg.norm(direction)
         if length < 1e-6:

aether_engine-1.8.0/aether/scene/scene.py

@@ -0,0 +1,55 @@
+"""Сцена"""
+from typing import List, Optional
+from aether.scene.entity import Entity
+from aether.graphics.camera import Camera
+
+
+class Scene:
+    def __init__(self, name="Scene"):
+        self.name = name
+        self.entities: List[Entity] = []
+        self.main_camera: Optional[Camera] = None
+
+    def spawn(self, entity: Entity):
+        """Add entity to the scene."""
+        if entity not in self.entities:
+            self.entities.append(entity)
+        return entity
+
+    def remove(self, entity: Entity) -> bool:
+        """Remove entity from the scene and call destroy() on it."""
+        if entity not in self.entities:
+            return False
+        self.entities.remove(entity)
+        entity.destroy()
+        return True
+
+    def despawn(self, entity: Entity) -> bool:
+        """Alias for remove()."""
+        return self.remove(entity)
+
+    def find(self, name: str) -> Optional[Entity]:
+        """Find first entity by name, or None."""
+        for ent in self.entities:
+            if ent.name == name:
+                return ent
+        return None
+
+    def set_main_camera(self, camera: Camera):
+        self.main_camera = camera
+
+    def awake(self):
+        pass
+
+    def start(self):
+        pass
+
+    def update(self, dt: float):
+        for entity in list(self.entities):
+            if entity.enabled:
+                entity.update(dt)
+
+    def destroy(self):
+        for entity in list(self.entities):
+            entity.destroy()
+        self.entities.clear()

{aether_engine-1.7.0 → aether_engine-1.8.0}/aether/ui/hud.py

@@ -63,3 +63,33 @@ class Hud:
                 layer=81,
             )
         )
+
+    def draw_rect(
+        self,
+        x: float,
+        y: float,
+        width: float,
+        height: float,
+        color=(1.0, 1.0, 1.0, 1.0),
+        layer: int = 70,
+    ):
+        """Draw a solid screen-space rectangle (center at x,y)."""
+        self._add(Sprite(x, y, width, height, color=color, layer=layer))
+
+    def draw_panel(
+        self,
+        x: float,
+        y: float,
+        width: float,
+        height: float,
+        fill=(0.05, 0.06, 0.08, 0.75),
+        border=(0.9, 0.9, 0.95, 0.9),
+        border_thickness: float = 2.0,
+    ):
+        """Draw a simple bordered panel (no text — use window title / print for text)."""
+        self.draw_rect(x, y, width, height, color=fill, layer=70)
+        t = border_thickness
+        self.draw_rect(x, y + height * 0.5, width, t, color=border, layer=71)
+        self.draw_rect(x, y - height * 0.5, width, t, color=border, layer=71)
+        self.draw_rect(x - width * 0.5, y, t, height, color=border, layer=71)
+        self.draw_rect(x + width * 0.5, y, t, height, color=border, layer=71)