Шпаргалка по pygame

Q: Подходит ли эта шпаргалка для pygame и pygame-ce?

Да. Оба импортируются через import pygame, и API у них почти полностью общий. Строки с пометкой pygame-ce (FRect, scale_by, get_just_pressed, перенос текста и move_towards_ip) требуют pygame-ce, а всё остальное работает в обоих.

Q: Почему окно pygame не отвечает?

Игровой цикл не читает события. Вызывайте pygame.event.get() один раз в каждом кадре, даже если события вам не нужны, и заканчивайте каждый кадр вызовами pygame.display.flip() и clock.tick(60).

Q: Что использовать для ввода: события или key.get_pressed()?

Используйте событие KEYDOWN для действий, которые происходят один раз за нажатие, например для прыжка или открытия меню. Используйте pygame.key.get_pressed() для действий, которые длятся, пока клавиша зажата, например для ходьбы.

Последнее обновление 28 октября 2026 г.

Попробуйте вживую в песочнице Pygame Изучайте Pygame бесплатно

Установка и игровой цикл

Каждая программа на pygame открывает окно, а затем повторяет один цикл, пока игрок не выйдет.

Действие	Код
Установить pygame-ce	`python3 -m pip install pygame-ce`
Импортировать и запустить pygame	`import pygame pygame.init()`
Открыть окно	`screen = pygame.display.set_mode((640, 480))`
Задать заголовок окна	`pygame.display.set_caption("My Game")`
Создать часы	`clock = pygame.time.Clock()`
Игровой цикл	`running = True while running: for event in pygame.event.get(): if event.type == pygame.QUIT: running = False screen.fill("black") pygame.display.flip() clock.tick(60)`
Завершить работу после цикла	`pygame.quit()`

Экран

Экран является объектом Surface: ничего не появится, пока вы не вызовете flip.

Действие	Код
Показать готовый кадр	`pygame.display.flip()`
Обновить только часть экрана	`pygame.display.update([rect1, rect2])`
Очистить экран	`screen.fill((30, 30, 46))`
Размер окна	`screen.get_size()`, `screen.get_width()`
Экран как Rect	`screen.get_rect()`
Окно с изменяемым размером	`pygame.display.set_mode((640, 480), pygame.RESIZABLE)`
Полный экран в разрешении рабочего стола	`pygame.display.set_mode((0, 0), pygame.FULLSCREEN)`

Цвета и рисование

Функции pygame.draw принимают поверхность, цвет и позицию. width=0 заливает фигуру.

Действие	Код
Цвет в RGB	`(255, 140, 0)`
Цвет по имени или в hex	`"tomato"`, `"#ff8c00"`, `pygame.Color("gold")`
Прямоугольник	`pygame.draw.rect(screen, "red", (x, y, w, h))`
Контур и скруглённые углы	`pygame.draw.rect(screen, "red", rect, width=2, border_radius=8)`
Круг (по центру)	`pygame.draw.circle(screen, "blue", (cx, cy), radius)`
Линия	`pygame.draw.line(screen, "white", (x1, y1), (x2, y2), 3)`
Многоугольник	`pygame.draw.polygon(screen, "green", [(0, 0), (40, 0), (20, 30)])`
Эллипс внутри прямоугольника	`pygame.draw.ellipse(screen, "purple", (x, y, w, h))`

Rect

Rect хранит позицию и размер целыми числами.

Действие	Код
Создать Rect	`player = pygame.Rect(x, y, width, height)`
Поставить по любой точке	`player.center = (320, 240)`, `player.bottom = 400`
Стороны и углы	`left`, `right`, `top`, `bottom`, `topleft`, `midbottom`
Сдвинуть на месте	`player.move_ip(dx, dy)`
Сдвинутая копия	`moved = player.move(dx, dy)`
Удержать внутри экрана	`player.clamp_ip(screen.get_rect())`
Увеличить вокруг центра	`bigger = player.inflate(20, 20)`
Дробные координаты (pygame-ce)	`pygame.FRect(10.5, 20.25, 40, 40)`

Изображения, Surface и blit

Загружайте изображения один раз до цикла, а затем выводите их через blit в каждом кадре.

Действие	Код
Загрузить изображение с прозрачностью	`img = pygame.image.load("player.png").convert_alpha()`
Загрузить изображение без прозрачности	`bg = pygame.image.load("sky.png").convert()`
Нарисовать изображение	`screen.blit(img, (x, y))`
Нарисовать по центру	`screen.blit(img, img.get_rect(center=(320, 240)))`
Новая пустая Surface	`panel = pygame.Surface((200, 100))`
Прозрачная Surface	`layer = pygame.Surface((200, 100), pygame.SRCALPHA)`
Сделать всю Surface полупрозрачной	`img.set_alpha(128)`
Вырезать кадр из спрайт-листа	`frame = sheet.subsurface((0, 0, 32, 32))`
Сохранить скриншот	`pygame.image.save(screen, "shot.png")`

Преобразования

Каждая функция возвращает новую Surface; преобразуйте оригинал, а не последний результат.

Действие	Код
Изменить размер	`pygame.transform.scale(img, (64, 64))`
Масштабировать с коэффициентом	`pygame.transform.scale_by(img, 2)`
Плавно изменить размер	`pygame.transform.smoothscale(img, (64, 64))`
Повернуть (против часовой стрелки, в градусах)	`pygame.transform.rotate(img, 45)`
Повернуть вокруг центра	`rotated = pygame.transform.rotate(original, angle) rect = rotated.get_rect(center=rect.center)`
Отразить по горизонтали	`pygame.transform.flip(img, True, False)`

События и клавиатура

События нужны для одиночных нажатий, а get_pressed() для удерживаемых клавиш.

Действие	Код
Прочитать события этого кадра	`for event in pygame.event.get():`
Окно закрыто	`event.type == pygame.QUIT`
Нажата клавиша	`event.type == pygame.KEYDOWN and event.key == pygame.K_SPACE`
Отпущена клавиша	`event.type == pygame.KEYUP`
Введённый символ	`event.unicode`
Клавиши, зажатые сейчас	`keys = pygame.key.get_pressed() if keys[pygame.K_LEFT]: x -= 5`
Направление по двум клавишам	`dx = keys[pygame.K_RIGHT] - keys[pygame.K_LEFT]`
Клавиши, нажатые в этом кадре (pygame-ce)	`pygame.key.get_just_pressed()[pygame.K_SPACE]`
Константы клавиш	`K_a`...`K_z`, `K_0`...`K_9`, `K_UP`, `K_RETURN`, `K_ESCAPE`, `K_LSHIFT`
Название клавиши	`pygame.key.name(event.key)`
Своё событие	`HIT = pygame.event.custom_type() pygame.event.post(pygame.event.Event(HIT))`

Мышь

Кнопки: 1 левая, 2 средняя, 3 правая.

Действие	Код
Нажата кнопка	`event.type == pygame.MOUSEBUTTONDOWN and event.button == 1`
Где её нажали	`event.pos`
Позиция курсора сейчас	`x, y = pygame.mouse.get_pos()`
Кнопки, зажатые сейчас	`left, middle, right = pygame.mouse.get_pressed()`
Мышь сдвинулась	`event.type == pygame.MOUSEMOTION`, `event.rel`
Прокручено колесо	`event.type == pygame.MOUSEWHEEL`, `event.y`
Клик внутри кнопки	`button_rect.collidepoint(event.pos)`
Скрыть курсор	`pygame.mouse.set_visible(False)`

Спрайты и группы

У спрайта есть image и rect; группа обновляет и рисует сразу много спрайтов.

Действие	Код
Класс спрайта	`class Coin(pygame.sprite.Sprite): def __init__(self, pos): super().__init__() self.image = coin_img self.rect = self.image.get_rect(center=pos)`
Создать группу	`coins = pygame.sprite.Group()`
Добавить в группу	`coins.add(Coin((100, 50)))`
Обновить все спрайты	`coins.update()`
Нарисовать все спрайты	`coins.draw(screen)`
Удалить спрайт из всех групп	`coin.kill()`
Группа из одного спрайта	`player = pygame.sprite.GroupSingle(Player())`

Столкновения

Rect сталкиваются, когда перекрываются; простое касание краями не считается.

Действие	Код
Два прямоугольника	`a.colliderect(b)`
Точка внутри	`rect.collidepoint(x, y)`
Первый из нескольких	`rect.collidelist(walls)` # index or -1
Спрайт с группой	`hits = pygame.sprite.spritecollide(player, coins, True)`
Есть ли хоть одно столкновение	`pygame.sprite.spritecollideany(player, enemies)`
Группа с группой	`pygame.sprite.groupcollide(bullets, enemies, True, True)`
С точностью до пикселя	`pygame.sprite.spritecollide(a, group, False, pygame.sprite.collide_mask)`
Круги	`pygame.Vector2(a).distance_to(b) < r1 + r2`

Текст и шрифты

Отрисуйте текст на Surface, а затем выведите её через blit.

Действие	Код
Шрифт по умолчанию	`font = pygame.font.Font(None, 36)`
Системный шрифт	`font = pygame.font.SysFont("arial", 24)`
Файл шрифта	`font = pygame.font.Font("pixel.ttf", 32)`
Отрисовать текст	`text = font.render("Score: 10", True, "white")`
Нарисовать по центру	`screen.blit(text, text.get_rect(center=(320, 40)))`
Перенос длинного текста (pygame-ce)	`font.render(story, True, "white", None, 400)`
Размер без отрисовки	`font.size("Hello")`
Установленные шрифты	`pygame.font.get_fonts()`

Звук и музыка

Загружайте звуки один раз. Музыка воспроизводит один трек потоком прямо из файла.

Действие	Код
Загрузить звук	`jump = pygame.mixer.Sound("jump.ogg")`
Воспроизвести	`jump.play()`
Громкость звука	`jump.set_volume(0.5)`
Загрузить музыку	`pygame.mixer.music.load("theme.ogg")`
Зациклить музыку	`pygame.mixer.music.play(-1)`
Пауза и продолжение	`pygame.mixer.music.pause()`, `pygame.mixer.music.unpause()`
Остановить музыку	`pygame.mixer.music.stop()`

Время и таймеры

Тики измеряются в миллисекундах.

Действие	Код
Ограничить частоту кадров	`clock.tick(60)`
Дельта времени в секундах	`dt = clock.tick(60) / 1000`
Текущая частота кадров	`clock.get_fps()`
Миллисекунды с момента init	`pygame.time.get_ticks()`
Повторяющееся событие таймера	`SPAWN = pygame.event.custom_type() pygame.time.set_timer(SPAWN, 1000)`
Одноразовый таймер	`pygame.time.set_timer(SPAWN, 2000, loops=1)`
Остановить таймер	`pygame.time.set_timer(SPAWN, 0)`

Vector2

Дробные числа для позиций и скоростей.

Действие	Код
Создать вектор	`pos = pygame.Vector2(100, 200)`
Сдвинуть на скорость	`pos += velocity * dt`
Длина	`velocity.length()`
Одинаковая скорость по диагонали	`if direction.length() > 0: direction = direction.normalize()`
Расстояние между точками	`pos.distance_to(target)`
Повернуть	`velocity.rotate(90)`
Шаг к точке (pygame-ce)	`pos.move_towards_ip(target, 5)`

Код pygame, который нужен при создании 2D-игры на Python, сгруппирован по задачам: игровой цикл, окно, цвета и рисование, Rect, изображения и blit, масштабирование и поворот, ввод с клавиатуры и мыши, спрайты и группы, столкновения, текст, звук, таймеры и Vector2. В каждой строке короткий фрагмент кода, который можно вставить, а рядом описание того, что он делает.

Всё здесь написано для pygame-ce 2.5, версии pygame от сообщества, которую по-прежнему импортируют через import pygame. Строки с пометкой pygame-ce используют её дополнения; все остальные строки работают и в оригинальном pygame. Любой фрагмент можно попробовать в песочнице pygame, которая запускает pygame прямо в браузере без установки. Только начинаете изучать Python? Начните со шпаргалки по Python.

Частые вопросы о шпаргалке по pygame

Эта шпаргалка по pygame бесплатная?

Да. Она бесплатная и не требует регистрации. Добавьте её в закладки или сохраните в PDF через печать в браузере и возвращайтесь, когда понадобится точный вызов для группы спрайтов, звука или проверки столкновений.

Подходит ли эта шпаргалка для pygame и pygame-ce?

Да. Оба импортируются через import pygame, и API у них почти полностью общий. Строки с пометкой pygame-ce (FRect, scale_by, get_just_pressed, перенос текста и move_towards_ip) требуют pygame-ce, а всё остальное работает в обоих.

Почему окно pygame не отвечает?

Игровой цикл не читает события. Вызывайте pygame.event.get() один раз в каждом кадре, даже если события вам не нужны, и заканчивайте каждый кадр вызовами pygame.display.flip() и clock.tick(60).

Что использовать для ввода: события или key.get_pressed()?

Используйте событие KEYDOWN для действий, которые происходят один раз за нажатие, например для прыжка или открытия меню. Используйте pygame.key.get_pressed() для действий, которые длятся, пока клавиша зажата, например для ходьбы.

Связанные ресурсы

Другие шпаргалки

Иллюстрация языков программирования Coddy

Изучайте Pygame с Coddy

Начать