SpritePro

Высокоуровневый 2D game framework на Python (поверх pygame). Desktop, web и mobile из одной кодовой базы.

---

Установка

pip install spritepro

Для mobile: pip install "spritepro[kivy]"

Шаблон проекта: python -m spritePro.cli --create (минимальный: --create --simple)

Обновление

pip install --upgrade spritepro

---

Почему SpritePro

Обычно приходится	В SpritePro
Ручной игровой цикл	s.run(scene=...) — сцена + auto-render
Своя камера	Camera API, follow, zoom, shake
UI с нуля	Button, ToggleButton, TextSprite, Slider, TextInput, Layout
Физика отдельно	pymunk-интеграция, типы тел, коллизии
Визуальный editor	Sprite Editor → JSON → spawn_scene(...)
Сохранения парсить	PlayerPrefs → JSON
Мультиплеер с нуля	TCP, лобби, ChatScene, синхронизация
Mobile отдельно	platform="kivy" — та же логика
Скроллируемый UI	ScrollView + ClipMask — готовый клиппинг

SpritePro = pygame + физика, Layout, ScrollView, ClipMask, редактор сцен, мультиплеер, UI.

---

Быстрый старт

import spritePro as s

class MainScene(s.Scene):
    def __init__(self):
        super().__init__()
        self.player = s.Sprite("", (50, 50), s.WH_C, speed=5, scene=self)

    def update(self, dt):
        self.player.handle_keyboard_input()

s.run(scene=MainScene, size=(800, 600), title="My Game")

Всё: окно, сцена, игровой цикл, управление.

---

Что внутри

• Sprite — базовый класс с движением, эффектами, иерархией parent-child
• UI: Button, ToggleButton, Slider, TextInput, TextSprite, Layout (flex/grid/circle/line)
• ClipMask — маска обрезки для viewport, инвентарей, чатов
• ScrollView — скроллируемый контент с колёсиком и drag-and-drop
• Физика: pymunk, DYNAMIC/STATIC/KINEMATIC тела, коллизии
• Анимации: Tween, Fluent API (DoMove, DoScale, SetEase...)
• Частицы: ParticleEmitter, шаблоны, пулы
• Мультиплеер: TCP, лобби, ChatScene, синхронизация
• Audio: звук и музыка
• Save/Load: PlayerPrefs в JSON
• Sprite Editor: визуальная сборка сцен → JSON

---

Sprite Editor

Визуальный редактор сцен с иерархией, инспектором, gizmo.

python -m spritePro.cli --editor

Собираете сцену → сохраняете в JSON → загружаете в игре:

rt = spawn_scene("level.json", scene=self)
player = rt.exact("player").Sprite(speed=5)

---

Мультиплеерный чат

Готовая сцена чата с маской обрезки и скроллом:

from spritePro.readyScenes import ChatScene, ChatStyle
import spritePro as s

s.run(scene=ChatScene, multiplayer=True, multiplayer_use_lobby=True, title="Chat")

---

Сравнение

Функция	pygame	arcade	SpritePro
Авто-рендер	❌	✅	✅
Готовая камера	❌	✅	✅
Физика (pymunk)	❌	✅	✅
Layout (flex/grid)	❌	❌	✅
Редактор сцен (JSON)	❌	❌	✅
Маска обрезки / ScrollView	❌	❌	✅
Мультиплеер (TCP)	❌	❌	✅
PlayerPrefs	❌	❌	✅

---

Что создать

• Платформеры, аркады, RPG
• Пазлы, tower defense
• Мультиплеерные игры
• Мобильные игры (platform="kivy")

---

Демо-игры

python -m spritePro.demoGames.physics_demo       # физика
python -m spritePro.demoGames.fluent_tween_demo   # твины
python -m spritePro.demoGames.layout_demo         # лейауты
python -m spritePro.demoGames.local_multiplayer_demo --quick

Слизарио (andrulok)

Мультиплеерный клон Slither.io и эталон сетевой игры на SpritePro: host-authoritative еда и боты, подтверждение действий хостом, подключение в середине игры. Разбор архитектуры — в ARCHITECTURE.md.

# одиночная игра
python spritePro/demoGames/slisario_andrulok/main.py --single

# локально: хост + клиент, два окна
python spritePro/demoGames/slisario_andrulok/main.py --quick

Подробнее: spritePro/demoGames/slisario_andrulok/README.md

Все 54 демо

---

Mobile и Web

s.run(scene=MainScene, platform="kivy")  # Android/iOS

python -m spritePro.cli --android . --android-orientation portrait

Web: docs/builds/building_web.md

---

Документация

Что	Где
Полный индекс	DOCUMENTATION_INDEX.md
Оглавление папки docs/	docs/README.md
API Reference	docs/API_REFERENCE.md
Для новичков	docs/GETTING_STARTED.md
Физика	docs/core/physics_guide.md
UI/Layout	docs/ui/layout_ui.md
ClipMask	docs/ui/clip_mask.md
Мультиплеер	docs/systems/networking_guide.md
Sprite Editor	docs/editor/sprite_editor.md
Mobile	docs/builds/mobile_kivy.md

---

Вклад

• CONTRIBUTING.md — как внести вклад
• ROADMAP.md — планы развития
• CHANGELOG.md — история изменений

---

📖 Документация · 💬 GitHub Issues