PyBall Game | Проект Яндекс Лицей

Содержание

0. Инструкция по установке и запуску
1. Введение
   1. Идея проекта
   2. Игровой процесс
2. Описание реализации
   1. Структура игры
   2. Особенности реализации
   3. Используемые технологии
3. Заключение
   1. Планы на будущее

0. Инструкция по установке и запуску

1. Скачать и установить Python v3.9.x или выше
2. Скачать последнюю версию игры из раздела релизов
3. Установить зависимости с помощью pip pip install -r requirements.txt
4. Запустить игру python PyBall.py

P.S. Вы можете ускорять или замедлять временя в игре с помощью клавиш - или =

1.1 Идея проекта

Пояснительная записка

Презентация

PyBall - небольшая, но увлекательная игра, игровой процесс которой заключается в прохождении уровней, разрушая блоки различной прочности.

Примечание: на анимации здесь и далее могут наблюдаться артефакты, искажённые цвета и низкая частота кадров из-за особенностей формата gif. В игре таких проблем нет.

1.2 Игровой процесс

На каждом уровне игроку доступно некоторое количество шариков, которое определяется конкретным уровнем. Он можжет стрелять ими в блоки направление выстрела задаётся с помощью мыши. Шарики, попадая в блоки, снимают определённое количество прочности блока и отскакивают от него, соблюдая закон отражения. Блоки, когда теряют прочность, меняют свой цвет, а при достижении прочности 0 - разрушаются. После каждого хода блоки опускаются к ограничивающей линии. Игрок побеждает, если все блоки были разрушены, до того, как они достигнут ограничивающей линии. Пока шарики находятся в полёте игрок не может выстелить ещё раз. Особое внимание было уделено звуковым и визуальным эффектам. Присутствует возможность ускорять время.

2.1 Структура игры

1. PyBall.py - главный файл игры
2. requirements.txt - файл с перечнем зависимостей
3. fonts - папка с используемыми в игре шрифтами, на данных момент необходим только один
4. img - папка, содержащая изображения для спрайтов
5. levels - папка, в которой находятся уровни игры
6. sounds - содержит все звуки и музыку
7. Data - папка с пользовательскими данными
8. game_save.data - файл сохранения игрового прогресса, в зашифрованном виде
9. secret.key - файл, содержащий уникальный ключ для расшифровки game_save.data
10. LICENSES - папка, содержащая лицензии используемых ресурсов

2.2 Особенности реализации

• Простое добавление новых уровней
• Шифрование файла сохранения игрового процесса
• Простое добавление новых механик в будущем
• Все магические данные вынесены в виде констант
• Использование ООП и спрайтов
  1. GameMap - основной класс, управляющий игровым процессом
  2. Block и Ball - классы соответствующих названию спрайтов, описывающие их поведение
  3. TextRender - класс для более удобного размещения текста на экране
  4. BottomLine - класс, описывающий ограничивающую линию, является спрайтом
  5. AnimatedSprite - класс анимированного спрайта для добавления милой лисы на главный экран
  6. Button - класс кнопки, описывает её поведение и определяет логику взаимодействия, является спрайтом
  7. SimpleBall - класс, описывающий поведение декоративных шариков на главном экране
  8. Particle - класс для создания эффекта разрушения блока
  9. Image - класс, для добавления картинки на экран в виде спрайта

2.3 Используемые технологии

• Python 3.9.13
• PyGame 2.1.2
• Cryptography 39.0.1
• PhotoShop 2020

3.1 Планы на будущее

• Добавление новых уровней и механик, к примеру подбор новых шариков, бустеры и т.п.
• Добавление валюты и скинов для блоков и шариков
• Добавление настроек приложения прямо в его интерфейсе
• Мелкие улучшения