v2.2.2

Author: NeoXider

CHANGELOG.md

@@ -5,6 +5,17 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.2]
+
+### Added
+- **Документация: физика из сцены редактора** — в [docs/physics.md](docs/physics.md) добавлен раздел «Получение и настройка физики из сцены редактора»: `s.get_physics(sprite)`, `set_bounce(0)`, задание скорости, удаление тела и создание своего, границы мира. Пример кода и ссылка на demoGames.
+- **demoGames/** в корне репозитория — пример сцены из редактора (level.json) с получением и настройкой физики в коде (платформер); README с инструкцией запуска и описанием.
+
+### Changed
+- Версия 2.2.2. В [docs/sprite_editor.md](docs/sprite_editor.md) и [docs/OVERVIEW.md](docs/OVERVIEW.md) добавлены упоминания `get_physics` и донастройки физики из кода. В разделе «Демо и примеры» [docs/physics.md](docs/physics.md) добавлен пункт про demoGames.
+
+---
+
 ## [2.2.0]
 
 ### Added

DOCUMENTATION_INDEX.md

@@ -2,6 +2,25 @@
 
 Полный указатель всей документации проекта SpritePro.
 
+---
+
+## 📚 Содержание
+
+| Полка | Что внутри |
+|-------|------------|
+| [📋 Основные документы](#-основные-документы-проекта) | README, OVERVIEW, ROADMAP, CONTRIBUTING, GAME_IDEAS |
+| [🎯 Старт и основы](#-основные-компоненты) | Sprite, игровой цикл, ввод, события, сцены, debug |
+| [⚙️ Физика](#-игровые-системы) | [physics.md](docs/physics.md) — типы тел, PhysicsShape, сцена из редактора; [physics_issues.md](docs/physics_issues.md) |
+| [🎨 Редактор сцен](#-основные-компоненты) | [sprite_editor.md](docs/sprite_editor.md) — редактор, spawn_scene, get_physics |
+| [🖼️ UI](#-ui-компоненты) | Button, Toggle, Slider, Text, TextInput, Layout, Pages, Bar |
+| [🎮 Игровые системы](#-игровые-системы) | Animation, Tween, Timer, Health, Particles, Builder, Networking |
+| [🔧 Утилиты](#-утилиты) | Save/Load, Surface, Color effects, ReadySprites |
+| [🎬 Демо-игры](#-демонстрационные-игры) | Список всех демо + [demoGames/](demoGames/README.md) (сцена из редактора) |
+| [🔍 Навигация](#-навигация-по-типам-документации) | По уровню, по категориям, порядок изучения |
+| [🔄 Обновления](#-обновления-документации) | Последние изменения в документации |
+
+---
+
 ## 📋 Основные документы проекта
 
 ### [README.md](README.md)
@@ -297,6 +316,7 @@
 - [Drag & Drop Demo](spritePro/demoGames/drag_drop_demo.py) - Перетаскивание
 - [Debug Overlay Demo](spritePro/demoGames/debug_overlay_demo.py) - Отладочная сетка и логи
 - [Physics Demo](spritePro/demoGames/physics_demo.py) - Физика: гравитация, отскок, платформы, статика и кинематика
+- [demoGames (сцена из редактора)](demoGames/) - Сцена из level.json: spawn_scene, s.get_physics(sprite), настройка отскока и скорости в коде (платформер). Запуск: `python demoGames/main.py` из корня репозитория. См. [demoGames/README.md](demoGames/README.md).
 - [Hoop Bounce Demo](spritePro/demoGames/hoop_bounce_demo.py) - Шарик в обруче: отскок без потери силы, смена цвета
 - [Object Pool Demo](spritePro/demoGames/object_pool_demo.py) - Пул объектов для переиспользования спрайтов
 - [Particle Pool Demo](spritePro/demoGames/particle_pool_demo.py) - Пул частиц (ParticleEmitter с use_pool=True)
@@ -361,12 +381,14 @@
 5. [Простые демо](spritePro/demoGames/) - Практические примеры
 
 ### Для разработки игр
-1. [docs/sprite.md](docs/sprite.md) - Спрайты и игровые объекты
-2. [docs/animation.md](docs/animation.md) - Анимации
-3. [docs/tween.md](docs/tween.md) - Плавные переходы (в т.ч. Fluent API)
-4. [docs/timer.md](docs/timer.md) - Игровое время
-5. [docs/health.md](docs/health.md) - Игровые системы
-6. [docs/save_load.md](docs/save_load.md) - Сохранения
+1. [docs/sprite.md](docs/sprite.md) — Спрайты и игровые объекты
+2. [docs/physics.md](docs/physics.md) — Физика (pymunk), типы тел, сцена из редактора
+3. [docs/sprite_editor.md](docs/sprite_editor.md) — Редактор сцен, spawn_scene, get_physics
+4. [docs/animation.md](docs/animation.md) — Анимации
+5. [docs/tween.md](docs/tween.md) — Плавные переходы (Fluent API)
+6. [docs/timer.md](docs/timer.md) — Игровое время
+7. [docs/health.md](docs/health.md) — Здоровье
+8. [docs/save_load.md](docs/save_load.md) — Сохранения
 
 ### Для продвинутых разработчиков
 1. [docs/layout.md](docs/layout.md) - Автолейауты
@@ -411,5 +433,5 @@
 
 ---
 
-**Совет**: Используйте поиск по файлам (Ctrl+F) для быстрого поиска нужной информации в документации! 🔍
+**Совет:** В начале документа — [содержание по полочкам](#-содержание-по-полочкам): все разделы сведены в одну таблицу для быстрого перехода. Используйте Ctrl+F для поиска по странице.
 

README.md

@@ -52,25 +52,13 @@ python -m spritePro.cli -e
 
 ## 📑 Содержание
 
-- [⚡ Почему SpritePro?](#-почему-spritepro)
-- [🌟 Что делает SpritePro особенным?](#-что-делает-spritepro-особенным)
-- [🚀 Быстрый старт](#-быстрый-старт-30-секунд)
-  - [Установка](#установка)
-  - [Ваша первая игра](#ваша-первая-игра-5-строк)
-- [💡 Примеры "Вау!" возможностей](#-примеры-вау-возможностей)
-- [🎮 Что можно создать?](#-что-можно-создать)
-- [📊 Сравнение с альтернативами](#-сравнение-с-альтернативами)
-- [🎯 Ключевые преимущества](#-ключевые-преимущества)
-- [🎬 Демо-игры](#-демо-игры)
-- [📦 Что внутри?](#-что-внутри)
-- [📖 Документация](#-документация)
-- [🎯 Примеры использования](#-примеры-использования)
-- [🆚 SpritePro vs Обычный pygame](#-spritepro-vs-обычный-pygame)
-- [🎁 Бонусы](#-бонусы)
-- [🚀 Начните прямо сейчас!](#-начните-прямо-сейчас)
-- [📊 Статистика](#-статистика)
-- [🤝 Сообщество](#-сообщество)
-- [📄 Лицензия](#-лицензия)
+- [⚡ Почему SpritePro?](#-почему-spritepro) · [🌟 Особенности](#-что-делает-spritepro-особенным)
+- [🚀 Быстрый старт](#-быстрый-старт-30-секунд) — установка, первая игра, шаблон `--create`
+- [💡 Примеры возможностей](#-примеры-вау-возможностей) · [🎮 Что можно создать?](#-что-можно-создать)
+- [📖 Документация](#-документация) — **главная карта** и ссылки по разделам
+- [🎬 Демо-игры](#-демо-игры) · [📦 Что внутри?](#-что-внутри)
+- [🎯 Ключевые преимущества](#-ключевые-преимущества) · [🆚 SpritePro vs pygame](#-spritepro-vs-обычный-pygame)
+- [🚀 Начните прямо сейчас!](#-начните-прямо-сейчас) · [🤝 Сообщество](#-сообщество) · [📄 Лицензия](#-лицензия)
 
 ---
 
@@ -467,20 +455,18 @@ pos = prefs.get_vector2("player_pos", (0, 0))
 
 ## 🎬 Демо-игры
 
-**Увидьте SpritePro в действии!** Все демо с открытым исходным кодом:
+Все с открытым исходным кодом. Полный список — [DOCUMENTATION_INDEX.md → Демо](DOCUMENTATION_INDEX.md#-демонстрационные-игры).
 
-- 🏓 **[Ping Pong](spritePro/demoGames/ping_pong.py)** - Полноценная игра с меню, звуком и UI
-- 🎆 **[Fireworks](spritePro/demoGames/fireworks_demo.py)** - Красивые эффекты частиц
-- 🎨 **[Tween Demo](spritePro/demoGames/tweenDemo.py)** - Плавные анимации
-- 🎮 **[Among Us Demo](spritePro/demoGames/amongus.py)** - Платформер с взаимодействиями
-- 💥 **[Particle Template Test](spritePro/demoGames/particle_template_test.py)** - Интерактивные частицы
-- 🌐 **Мультиплеер** - [local_multiplayer_demo](spritePro/demoGames/local_multiplayer_demo.py), [камень/ножницы/бумага](spritePro/demoGames/events_rps_demo.py); полный курс — [multiplayer_course](multiplayer_course/README.md)
+| Демо | Описание |
+|------|----------|
+| [Ping Pong](spritePro/demoGames/ping_pong.py) | Игра с меню, звуком, физикой |
+| [Physics Demo](spritePro/demoGames/physics_demo.py) | Гравитация, отскок, платформы, статика/кинематика |
+| [demoGames/](demoGames/README.md) | **Сцена из редактора**: level.json, spawn_scene, get_physics, платформер. `python demoGames/main.py` |
+| [Fireworks](spritePro/demoGames/fireworks_demo.py) | Частицы |
+| [Tween](spritePro/demoGames/tweenDemo.py) | Плавные анимации |
+| Мультиплеер | [local_multiplayer_demo](spritePro/demoGames/local_multiplayer_demo.py), курс [multiplayer_course](multiplayer_course/README.md) |
 
-**Запустите любую демо-игру и увидьте возможности!**
-
-```bash
-python spritePro/demoGames/ping_pong.py
-```
+Запуск из корня репозитория: `python -m spritePro.demoGames.physics_demo` или `python demoGames/main.py`.
 
 ---
 
@@ -494,11 +480,12 @@ python spritePro/demoGames/ping_pong.py
 - **Bar** - Полосы прогресса (HP, опыт и т.д.)
 
 ### 🎨 Игровые системы
-- **Animation** - Система анимаций
-- **Tween** - Плавные переходы (easing); **Fluent API**: `sprite.DoMove(...).SetEase(Ease.OutQuad)` — см. [Tween](docs/tween.md#fluent-api-do-твины) и [Fluent Tween Demo](spritePro/demoGames/fluent_tween_demo.py)
-- **Timer** - Таймеры для событий
-- **Health** - Система здоровья
-- **ParticleEmitter** - Генератор частиц
+- **Physics (pymunk)** — мир тел, DYNAMIC/STATIC/KINEMATIC, PhysicsShape, гравитация, коллизии, `s.get_physics(sprite)` из сцены. Подробно: [docs/physics.md](docs/physics.md).
+- **Animation** — система анимаций
+- **Tween** — плавные переходы; Fluent API: `sprite.DoMove(...).SetEase(Ease.OutQuad)`. [docs/tween.md](docs/tween.md)
+- **Timer** — таймеры для событий
+- **Health** — система здоровья
+- **ParticleEmitter** — генератор частиц
 
 ### 🛠️ Утилиты
 - **AudioManager** - Управление звуком и музыкой
@@ -520,25 +507,17 @@ python spritePro/demoGames/ping_pong.py
 
 ## 📖 Документация
 
-### 🚀 Быстрый старт
-- [Установка и настройка](#-быстрый-старт-30-секунд)
-- [Базовый пример](#ваша-первая-игра-5-строк)
-- [Быстрый старт 2.0](#-быстрый-старт-20-шаблон-проекта)
-
-### 📚 Индексы
-- [📖 Индекс документации](DOCUMENTATION_INDEX.md) - Полный список модулей
-- [📘 Документация папки docs](docs/README.md) - Навигация по разделам
-- [🌐 Сетевой мультиплеер](docs/networking.md) — Запуск, лобби (подробная инструкция), базовые примеры
-- [🎓 Мини-курс по мультиплеерным играм](multiplayer_course/README.md) - 10 уроков: от обмена сообщениями до готовой сетевой мини-игры
-
-### 🧩 Полный список документации
-- Основы: [Game Loop](docs/game_loop.md) • [Input](docs/input.md) • [Debug](docs/debug.md) • [Camera & Particles](docs/camera_and_particles.md)
-- Спрайты и графика: [Sprite](docs/sprite.md) • [Surface](docs/surface.md) • [Text](docs/text.md) • [Text FPS](docs/text_fps.md) • [Color Effects](docs/color_effects.md) • [ReadySprites](docs/readySprites.md)
-- UI: [Button](docs/button.md) • [Toggle Button](docs/toggle_button.md) • [Bar](docs/bar.md) • [Bar Background](docs/bar_background.md) • [Pages](docs/pages.md) • [Layout](docs/layout.md) • ScrollView (в [layout.md](docs/layout.md)) • [Готовые сцены](docs/README.md#готовые-сцены-readyscenes) (ChatScene)
-- Компоненты: [Animation](docs/animation.md) • [Tween](docs/tween.md) • [Tween Presets](docs/tween_presets.md) • [Timer](docs/timer.md) • [Health](docs/health.md) • [Mouse Interactor](docs/mouse_interactor.md) • [Draggable Sprite](docs/draggable_sprite.md)
-- Эффекты и частицы: [Particles](docs/particles.md)
-- Аудио: [Audio](docs/audio.md)
-- Сохранения и утилиты: [Save/Load](docs/save_load.md)
+**Главная карта** — [**DOCUMENTATION_INDEX.md**](DOCUMENTATION_INDEX.md): всё по полочкам (старт, основы, физика, редактор, UI, демо, порядок изучения).
+
+| Раздел | Куда смотреть |
+|--------|----------------|
+| **Старт** | [Установка](#установка), [Первая игра](#ваша-первая-игра-5-строк), [Шаблон проекта](#-быстрый-старт-20-шаблон-проекта) |
+| **Обзор** | [docs/OVERVIEW.md](docs/OVERVIEW.md) — Layout, физика, Builder, мультиплеер кратко |
+| **Физика** | [docs/physics.md](docs/physics.md) — pymunk, типы тел, PhysicsShape, сцена из редактора; [docs/physics_issues.md](docs/physics_issues.md) — нюансы |
+| **Редактор сцен** | [docs/sprite_editor.md](docs/sprite_editor.md) — редактор, spawn_scene, get_physics из сцены |
+| **Демо** | [DOCUMENTATION_INDEX.md → Демо](DOCUMENTATION_INDEX.md#-демонстрационные-игры); сцена из редактора: [demoGames/](demoGames/README.md) |
+| **Сеть** | [docs/networking.md](docs/networking.md); курс: [multiplayer_course/](multiplayer_course/README.md) |
+| **Вся документация** | [docs/README.md](docs/README.md) — навигация по docs |
 
 ---
 
@@ -645,27 +624,11 @@ while True:
 
 ## 🚀 Начните прямо сейчас!
 
-### 1. Установите
 ```bash
-pip install pygame
-git clone https://github.com/NeoXider/SpritePro.git
-```
-
-### 2. Скопируйте папку `spritePro` в ваш проект
-
-### 3. Создайте игру!
-```python
-import spritePro as s
-
-s.get_screen((800, 600), "My Game")
-player = s.Sprite("", (50, 50), s.WH_C, speed=5)
-
-while True:
-    s.update()
-    player.handle_keyboard_input()
+pip install spritepro
 ```
 
-**Готово!** У вас уже есть игра! 🎉
+Затем — [Ваша первая игра (5 строк)](#ваша-первая-игра-5-строк) выше или шаблон: `python -m spritePro.cli --create`.
 
 ---
 

demoGames/README.md

@@ -0,0 +1,37 @@
+# demoGames — сцена из редактора и физика
+
+Пример запуска игры, сцена которой сделана в **Sprite Editor** (level.json). Показывает, как получать и настраивать физику объектов из сцены в коде.
+
+## Запуск
+
+Из **корня репозитория** SpritePro:
+
+```bash
+python demoGames/main.py
+```
+
+Либо установить пакет в режиме разработки и запускать из любой папки:
+
+```bash
+pip install -e .
+python -c "import spritePro; print(spritePro.__file__)"
+python demoGames/main.py
+```
+
+## Что внутри
+
+- **main.py** — точка входа: экран, сцена `MainScene`, цикл `s.update()`.
+- **scenes/main_scene.py** — загрузка сцены через `spawn_scene("scenes/level.json", scene=self)`, получение игрока по имени, настройка физики в коде.
+- **scenes/level.json** — сцена, собранная в редакторе (объект `player` с типом физики Dynamic, платформы `rect*` и т.д.).
+- **config.py** — размер окна, FPS, скорость и высота прыжка.
+
+## Физика из сцены редактора
+
+1. В редакторе у объекта (например, player) выставляется **Physics: Dynamic** (и при необходимости Mass, Friction, Bounce).
+2. При загрузке `spawn_scene` таким объектам автоматически создаётся тело и они добавляются в `s.physics`.
+3. В коде тело получаем через **`s.get_physics(sprite)`** и донастраиваем:
+   - `body.set_bounce(0)` — без отскока при приземлении (как в Geometry Dash);
+   - `body.velocity.x = config.SPEED` — горизонтальная скорость;
+   - в `update()` по Space: `body.velocity.y = -config.JUMP` — прыжок.
+
+Подробнее: [docs/physics.md](../docs/physics.md) (раздел «Получение и настройка физики из сцены редактора»).

demoGames/config.py

@@ -0,0 +1,5 @@
+WINDOW_SIZE = (800, 600)
+FPS = 60
+
+SPEED = 200
+JUMP = 400

demoGames/main.py

@@ -0,0 +1,28 @@
+import sys
+from pathlib import Path
+
+# Корень репозитория — чтобы находился пакет spritePro при запуске из demoGames/
+_root = Path(__file__).resolve().parent.parent
+if str(_root) not in sys.path:
+    sys.path.insert(0, str(_root))
+
+import spritePro as s
+
+import config
+from scenes.main_scene import MainScene
+
+
+def main():
+    s.get_screen(config.WINDOW_SIZE, "My SpritePro Game")
+    s.enable_debug(True)
+    s.set_debug_hud_enabled(show_camera=False)
+    s.set_debug_camera_input(3)
+    s.debug_log_info("Game started")
+    s.set_scene(MainScene())
+
+    while True:
+        s.update(config.FPS, fill_color=(20, 20, 30))
+
+
+if __name__ == "__main__":
+    main()