---

Ты абсолютно прав, извини за путаницу! Я не должен был писать проект в формате Python-файла. Школьный проект — это текстовый документ (Word/Google Docs), а не код. Мне нужно было просто выдать готовый текст, который ты скопируешь и вставишь в документ.

---

Вот полный текст школьн

РАЗРАБОТКА 2D-ПЛАТФОРМЕРА НА ЯЗЫКЕ PYTHON С ИСПОЛЬЗОВАНИЕМ БИБЛИОТЕКИ PYGAME

---

ВВЕДЕНИЕ

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

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

В качестве инструмента разработки был выбран язык программирования Python и библиотека Pygame. Python отличается простым и понятным синтаксисом, что делает его идеальным для обучения программированию, а Pygame предоставляет готовые инструменты для работы с графикой, звуком и пользовательским вводом, позволяя сосредоточиться на логике игры, а не на низкоуровневых деталях.

Объектом исследования является процесс создания 2D-платформера, предметом — программная реализация игровой механики, системы анимации и уровневого дизайна.

---

ЦЕЛИ И ЗАДАЧИ ПРОЕКТА

Цель проекта: разработать полноценную двумерную компьютерную игру в жанре платформер с системой физики, анимацией персонажа, загружаемыми уровнями и игровыми препятствиями.

Задачи проекта:

1. Изучить теоретические основы разработки компьютерных игр: жанры, базовые принципы геймдизайна, технологии создания.
2. Разработать визуальную составляющую игры: создать спрайты персонажа, текстуры стен и элементы окружения.
3. Обеспечить совместимость текстур стен между собой для формирования цельного и эстетичного игрового мира.
4. Реализовать многокадровую анимацию персонажа с учётом направления движения.
5. Написать программный код игры, включающий физику движения, систему столкновений, обработку пользовательского ввода и загрузку уровней.
6. Протестировать игру и устранить выявленные ошибки.

---

1. ТЕОРЕТИЧЕСКАЯ ЧАСТЬ. ОСНОВЫ РАЗРАБОТКИ КОМПЬЮТЕРНЫХ ИГР

1.1. Что такое компьютерная игра

Компьютерная игра — это интерактивная программа, которая преобразует пользовательский ввод (нажатия клавиш, движения мыши) в изменения на экране по определённым правилам. В отличие от пассивных форм развлечения (кино, литература), игра предполагает активное участие человека, который принимает решения и влияет на развитие событий.

Игры строятся на трёх ключевых компонентах:
- Геймплей — правила и механики, определяющие, что делает игрок и какие действия доступны.
- Графика — визуальное оформление: персонажи, окружение, эффекты.
- Звук — музыкальное сопровождение и звуковые эффекты, создающие атмосферу.

1.2. Жанры компьютерных игр

Компьютерные игры делятся на жанры по типу геймплея. Основные жанры включают:
- Шутеры — игры, в которых основной механикой является стрельба.
- RPG (ролевые игры) — игры с развитием персонажа, прокачкой навыков и сюжетом.
- Стратегии — игры, требующие планирования и управления ресурсами.
- Платфореры — игры, в которых игрок управляет персонажем, перемещающимся по платформам и преодолевающим препятствия с помощью прыжков.

Платфореры появились в 1980-х годах (игры Super Mario Bros., Sonic the Hedgehog) и остаются популярными до сих пор благодаря простым правилам и высокой реиграбельности.

1.3. Технологии разработки игр

Современные игры создаются с помощью игровых движков — специализированных программных сред, которые берут на себя рутинные задачи: отрисовку графики, обработку физики, воспроизведение звука, управление сценами. Примеры движков: Unity, Unreal Engine, Godot.

Для начинающих разработчиков и учебных проектов часто используются более простые инструменты. Библиотека Pygame для языка Python предоставляет базовые возможности для создания 2D-игр: работу с изображениями и спрайтами, обработку событий клавиатуры и мыши, управление временем и кадрами. Pygame не является полноценным движком, но позволяет с нуля реализовать все необходимые механики, что делает его отличным выбором для обучения.

1.4. Основные понятия

Спрайт — двумерное изображение, используемое в игре для представления персонажа, объекта или элемента интерфейса. В отличие от статичной картинки, спрайт может перемещаться по экрану, изменяться и взаимодействовать с другими объектами.

Хитбокс (от англ. hit box — «ударная рамка») — невидимый прямоугольник, привязанный к спрайту, который используется для проверки столкновений. Хитбокс часто меньше самого спрайта, чтобы столкновения выглядели естественно.

Игровой цикл — бесконечный цикл, внутри которого происходит вся работа игры: обработка ввода, обновление состояния объектов, проверка столкновений, отрисовка кадра. Один проход цикла — один кадр.

FPS (frames per second) — количество кадров в секунду. Для плавной картинки достаточно 60 FPS.

---

2. ПРАКТИЧЕСКАЯ ЧАСТЬ. СОЗДАНИЕ ИГРЫ

2.1. Создание спрайтов и визуальных ресурсов

2.1.1. Спрайты персонажа и многокадровая анимация

Для создания ощущения «живого» персонажа недостаточно одного статичного изображения — необходима анимация. Анимация в 2D-играх строится на принципе смены кадров: за определённый промежуток времени на экране последовательно отображаются разные изображения, создавая иллюзию движения.

В разработанной игре персонаж имеет четыре состояния анимации:
- idle (покой) — два кадра, персонаж слегка «дышит»;
- walk (ходьба) — два кадра, чередующиеся при движении;
- jump (прыжок) — один кадр, персонаж в воздухе;
- fall (падение) — один кадр, персонаж падает.

Каждое состояние представлено спрайтами для двух направлений: вправо (0) и влево (1). Спрайт для левого направления получается отражением спрайта для правого по горизонтали с помощью функции `pg.transform.flip()`. Такой подход экономит время и дисковое пространство: вместо рисования отдельных спрайтов для каждого направления достаточно иметь один набор и программно его отражать.

Все спрайты хранятся в словаре `player_dict`, организованном по принципу: состояние → направление → список кадров. Это позволяет легко получить нужный кадр, зная текущее состояние персонажа и направление его движения.

Смена кадров происходит в методе `update_animation()` класса `Player`. Там используется таймер `anim_timer`, который увеличивается каждый кадр игры. Когда таймер достигает значения `anim_speed` (15 кадров), происходит переключение на следующий кадр с помощью операции взятия остатка от деления: `(текущий_кадр + 1) % количество_кадров`. Это обеспечивает циклическую анимацию: после последнего кадра снова показывается первый.

2.1.2. Текстуры стен и их совместимость

Игровой мир состоит из блоков размером 32×32 пикселя. Для создания эстетичного и цельного уровня недостаточно одной текстуры стены — нужны различные варианты для разных ситуаций: прямые участки, углы, внутренние углы, заполнение внутренних областей.

В проекте используются следующие типы текстур стен:
- Прямая стена (`wall.png`) — базовая текстура, которая поворачивается на 0°, 90°, 180° и 270° для создания горизонтальных и вертикальных участков.
- Наружный угол (`corner_wall.png`) — используется на внешних углах конструкций, поворачивается четырьмя способами.
- Внутренний угол (`inner_corner_wall.png`) — заполняет внутренние углы, где две стены соединяются под прямым углом изнутри.
- Пустая стена (`empty_wall.png`) — сплошная текстура для заполнения внутренних областей, не видимых игроку.

Ключевой особенностью является совместимость текстур между собой. Все текстуры имеют одинаковый размер (32×32 пикселя) и единый визуальный стиль, поэтому при размещении рядом они образуют бесшовную картинку. Например, горизонтальная стена (`wall[0]`) плавно переходит в наружный угол (`corner_wall[0]`), а тот, в свою очередь, соединяется с вертикальной стеной (`wall[1]`). Внутренние углы корректно заполняют пространство между перпендикулярными стенами, не оставляя пустот.

Также в игре присутствуют шипы — опасные объекты, которые возвращают персонажа на старт при касании. Шипы имеют высоту 16 пикселей (половину клетки) и могут быть направлены вверх или вниз.

2.1.3. Система символов карты

Для удобного создания уровней была разработана система, в которой каждый игровой объект кодируется символом. Уровень записывается в обычный текстовый файл (`level_map.txt`), где каждая строка — это ряд клеток, а каждый символ — тип объекта:

- `•` — пустое пространство;
- `S` — стартовая позиция персонажа;
- `F` — финишная зона;
- `▀`, `▌`, `▄`, `▐` — прямые стены (вверх, вправо, вниз, влево);
- `█` — заполнение внутренней области;
- `▜`, `▛`, `▙`, `▟` — наружные углы;
- `▝`, `▘`, `▖`, `▗` — внутренние углы;
- `▲`, `▼` — шипы (вверх, вниз).

Использование псевдографических символов позволяет визуально представить уровень прямо в текстовом файле, что значительно упрощает процесс редактирования и тестирования.

---

2.2. Написание программного кода игры

2.2.1. Инициализация и загрузка ресурсов

Программа начинается с импорта библиотеки Pygame (`import pygame as pg`) и инициализации игрового окна размером 1280×640 пикселей. Для удобства работы с изображениями создана функция `get_img()`, которая загружает спрайт из папки `Sprites`, масштабирует его до 32×32 пикселей и при необходимости отражает по горизонтали или вертикали.

Все спрайты загружаются в начале программы и сохраняются в глобальных переменных и словарях. Карта уровня читается из текстового файла построчно, каждая строка преобразуется в список символов. Затем программа проходит по каждому символу и создаёт соответствующий игровой объект: стену, шип, стартовую точку или финишную зону. Все объекты позиционируются по сетке с шагом 32 пикселя.

2.2.2. Класс Player — игровой персонаж

Класс `Player` является центральным элементом игры. Он содержит:

- Физические параметры: вертикальная и горизонтальная скорость (`vel_y`, `vel_x`), сила гравитации (`gravity = 0.5`), хитбокс размером 24×32 пикселей.
- Состояния: направление движения (`direction`), флаг стояния на земле (`standing`), количество оставшихся прыжков (`jumps_left`).
- Анимационные переменные: таймер, текущий кадр, скорость анимации.

Метод `jump(power)` реализует двойной прыжок: первый прыжок выполняется с земли с силой −8, второй (в воздухе) — с силой −7. Приземление сбрасывает счётчик прыжков до двух.

Метод `collision_move_update(solids)` — самый сложный и важный. Он обновляет позицию персонажа и разрешает столкновения с твёрдыми объектами. Движение по вертикали и горизонтали обрабатывается отдельно, что предотвращает застревание персонажа в углах. Алгоритм проверяет четыре направления столкновений:
- Снизу — приземление на платформу (сбрасывает вертикальную скорость, устанавливает флаг `standing`);
- Сверху — удар головой о потолок (останавляет движение вверх);
- Справа и слева — столкновение со стенами (останавливает горизонтальное движение).

2.2.3. Классы Spike и Solid — игровые объекты

Класс `Spike` представляет опасные объекты. При создании экземпляра он добавляется в глобальный список `all_spikes`. Хитбокс шипа имеет высоту 16 пикселей, что соответствует визуальному размеру спрайта.

Класс `Solid` представляет твёрдые статические объекты (стены и платформы). Все экземпляры добавляются в список `all_solids` и используются для проверки столкновений с персонажем.

2.2.4. Игровой цикл и управление

Основной игровой цикл (`while running`) выполняется 60 раз в секунду (ограничение через `clock.tick(60)`). Каждая итерация включает:

1. Обработку событий — проверка нажатий клавиш и закрытия окна. Пробел — прыжок, A и D — движение влево-вправо, R — перезапуск уровня.
2. Обновление скорости — в зависимости от нажатых клавиш A/D устанавливается горизонтальная скорость ±4 пикселя за кадр.
3. Обновление физики — вызов `collision_move_update()` для перемещения и разрешения столкновений.
4. Проверку опасностей — столкновение со шипами возвращает персонажа на старт.
5. Проверку падения — если персонаж упал ниже уровня (y > 1000), он возвращается на старт.
6. Отрисовку — очистка экрана, отрисовка всех объектов в правильном порядке: фон, твёрдые объекты, шипы, финишные зоны (зелёные прямоугольники), персонаж.

---

3. ЗАКЛЮЧЕНИЕ

В ходе выполнения проекта была разработана полноценная двумерная компьютерная игра в жанре платформер на языке Python с использованием библиотеки Pygame.

Что было сделано:

1. Изучены теоретические основы разработки компьютерных игр: жанры, технологии, базовые принципы геймдизайна.
2. Создана визуальная составляющая игры: спрайты персонажа с многокадровой анимацией для четырёх состояний (покой, ходьба, прыжок, падение) и двух направлений движения; текстуры стен четырёх типов (прямые, наружные углы, внутренние углы, заполнение), совместимые между собой для формирования цельного игрового мира; спрайты шипов как опасных объектов.
3. Реализована система загрузки уровней из текстовых файлов с использованием псевдографических символов, что позволяет легко создавать и редактировать игровые пространства без изменения программного кода.
4. Написан программный код, включающий: физику движения с гравитацией и двойным прыжком; систему столкновений с раздельной обработкой вертикального и горизонтального движения; многокадровую анимацию персонажа с таймером смены кадров; обработку пользовательского ввода (клавиатура); механику шипов и финишных зон; систему перезапуска уровня.
5. Проведено тестирование: проверена корректность столкновений, работа анимации, загрузка уровней, реакция на пользовательский ввод.

Почему именно такой проект:

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

Зачем это нужно:

Разработка собственной игры — это не только создание развлекательного продукта, но и глубокое изучение программирования. В процессе работы пришлось разобраться с объектно-ориентированным программированием (классы, объекты, методы), работой с файлами, обработкой событий, математикой движения и столкновений. Полученные навыки применимы не только в геймдеве, но и в других областях программирования.

В дальнейшем проект можно развивать: добавить новые уровни, врагов, сбор предметов, систему очков, звуковое сопровождение, анимированные фоны и меню. Также возможен переход на более мощные инструменты, такие как движок Godot или Unity, для создания масштабных проектов.

---

Список использованных источников:

1. МакГрат М. «Программирование игр на Python». — СПб.: БХВ-Петербург, 2022.
2. Sweigart A. «Making Games with Python & Pygame». — CreateSpace, 2012.
3. Официальная документация Pygame: https://www.pygame.org/docs/
4. История жанра платформеров: https://ru.wikipedia.org/wiki/Платформер

---

Если нужно что-то добавить, убрать или переписать — скажи!