Очки в играх на Python с Arcade

Таблица результатов с очками двух команд

Очки — важная часть многих игр. Они показывают прогресс и достижения игрока. В Python библиотека Arcade даёт простой и эффективный набор инструментов для управления очками. Хорошо продуманная система очков повышает вовлечённость и делает игровой процесс более интересным.

Быстрый старт: установка и требования

Убедитесь, что у вас установлен pip. Установите библиотеку Arcade командой:

pip install arcade

Совет: используйте виртуальное окружение (venv) для изоляции зависимостей.

Код, используемый в статье, доступен в репозитории на GitHub и распространяется по лицензии MIT.

Простая игра: базовый шаблон

Ниже — минимальная рабочая игра: круг управляется стрелками влево/вправо, на экране есть прямоугольное препятствие, и счёт хранится в объекте игры.

import arcade

# Параметры окна
SCREEN_WIDTH = 800
SCREEN_HEIGHT = 600

class MyGame(arcade.Window):
    def __init__(self, width, height):
        super().__init__(width, height)
        self.player_x = width // 3
        self.score = 0

    def on_key_press(self, key, modifiers):
        if key == arcade.key.LEFT:
            self.player_x -= 10
        elif key == arcade.key.RIGHT:
            self.player_x += 10

    def update(self, delta_time):
        # Логика игры обновляется здесь
        pass

    def on_draw(self):
        arcade.start_render()
        arcade.draw_circle_filled(self.player_x, 50, 20, arcade.color.BLUE)
        arcade.draw_rectangle_filled(400, 50, 100, 50, arcade.color.RED)

def main():
    game = MyGame(SCREEN_WIDTH, SCREEN_HEIGHT)
    arcade.run()

if __name__ == "__main__":
    main()

Отслеживание и расчёт очков

Добавьте логику начисления очков в метод update. В простейшем варианте очки увеличиваются, когда игрок оказывается в пределах x-промежутка препятствия.

class MyGame(arcade.Window):
    def __init__(self, width, height):
        super().__init__(width, height)
        self.player_x = width // 3
        self.score = 0

    def on_key_press(self, key, modifiers):
        if key == arcade.key.LEFT:
            self.player_x -= 10
        elif key == arcade.key.RIGHT:
            self.player_x += 10

    def update(self, delta_time):
        # Если игрок касается области препятствия — начисляем очки
        if 330 < self.player_x < 470:
            self.score += 1

Важно: в реальной игре стоит ограничивать начисление очков по времени (например, не более N очков в секунду) и учитывать дельту времени delta_time.

Отображение очков

Добавьте текст в on_draw, чтобы показать текущий счёт игроку.

class MyGame(arcade.Window):
    # ...
    def on_draw(self):
        arcade.start_render()
        arcade.draw_circle_filled(self.player_x, 50, 20, arcade.color.BLUE)
        arcade.draw_rectangle_filled(400, 300, 100, 50, arcade.color.RED)

        score_text = f"Очки: {self.score}"
        arcade.draw_text(score_text, 10, 10, arcade.color.WHITE, 14)

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

Сохранение рекорда (high score)

Хранение лучшего результата повышает повторяемость игры. Ниже — два варианта: простой файловый и более надёжный вариант с безопасной записью.

Простой файл high_score.txt:

class MyGame(arcade.Window):
    def __init__(self, width, height):
        super().__init__(width, height)
        self.player_x = width // 3
        self.score = 0
        self.high_score = self.load_high_score()

    def load_high_score(self):
        try:
            with open("high_score.txt", "r") as file:
                return int(file.read())
        except FileNotFoundError:
            return 0

    def save_high_score(self):
        with open("high_score.txt", "w") as file:
            file.write(str(self.high_score))

    def update(self, delta_time):
        # ...
        if self.score > self.high_score:
            self.high_score = self.score
            self.save_high_score()

Более безопасный подход: использовать pathlib и атомарную запись (запись в временный файл и переименование). Это уменьшит риск повреждения файла при аварийном завершении приложения.

from pathlib import Path
import tempfile

class MyGame(arcade.Window):
    DATA_FILE = Path("high_score.txt")

    def load_high_score(self):
        try:
            return int(self.DATA_FILE.read_text())
        except Exception:
            return 0

    def save_high_score(self):
        tmp = tempfile.NamedTemporaryFile('w', delete=False)
        try:
            tmp.write(str(self.high_score))
            tmp.flush()
            tmp.close()
            Path(tmp.name).replace(self.DATA_FILE)
        finally:
            try:
                Path(tmp.name).unlink()
            except Exception:
                pass

Отображение рекорда

Добавьте текст для рекорда чуть выше текущего счёта:

high_score_text = f"Рекорд: {self.high_score}"
arcade.draw_text(high_score_text, 10, 30, arcade.color.WHITE, 14)

Окно Arcade с синим кругом, перекрывающим красный прямоугольник; в левом нижнем углу показаны очки и рекорд

Дополнительные функции: как оживить систему очков

Ниже — идеи и примеры реализации, которые помогают сделать систему очков глубже и интереснее.

Пауэр-апы (Power-Ups)

Пауэр-апы дают временные преимущества или бонусные очки. Управление состоянием пауэр-апа удобно реализовать через флаг и планировщик Arcade.

class MyGame(arcade.Window):
    def __init__(self, width, height):
        super().__init__(width, height)
        self.player_x = width // 3
        self.score = 0
        self.power_up_active = False

    def update(self, delta_time):
        if self.power_up_active:
            # Применяем эффекты пауэр-апа
            self.apply_power_up_effects()
            self.score += 10

    def apply_power_up_effects(self):
        # Логика пауэр-апа (увеличение скорости, защита и т.д.)
        pass

    def activate_power_up(self):
        self.power_up_active = True
        # Запустить деактивацию через 10 секунд
        arcade.schedule(self.deactivate_power_up, 10.0)

    def deactivate_power_up(self, delta_time):
        self.power_up_active = False
        arcade.unschedule(self.deactivate_power_up)

Совет: при использовании schedule не забывайте unschedule, чтобы избежать накопления вызовов.

Система комбо

Комбо поощряет последовательность успешных действий. Чем выше комбо, тем больше очков.

class MyGame(arcade.Window):
    def __init__(self, width, height):
        super().__init__(width, height)
        self.player_x = width // 3
        self.score = 0
        self.combo_counter = 0

    def update(self, delta_time):
        if self.check_successful_action():
            self.increase_combo_counter()
        else:
            self.reset_combo_counter()

    def increase_combo_counter(self):
        self.combo_counter += 1
        self.score += self.combo_counter

    def reset_combo_counter(self):
        self.combo_counter = 0

Лучшие практики управления очками

Ниже ключевые рекомендации, проверенные на практике.

Дизайн значимой системы очков

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

Визуальная обратная связь

Когда счёт меняется, показывайте эффект: вспышка, анимация, частички. Игрок воспринимает такой отклик как награду.

Звуки и анимации

Добавьте звуковой отклик при достижении вехи или получении большого бонуса. Аудио усиливает эмоциональную составляющую.

Баланс сложности и масштабирования очков

При увеличении сложности корректируйте выдачу очков. Если уровень трудности растёт, логично увеличивать и потенциальную награду.

Альтернативные подходы хранения рекордов

Файловое хранение (как выше) — простое и подходит для локальных игр.
JSON с дополнительными метаданными (имя игрока, дата) — удобнее для отображения таблицы лидеров.
SQLite — если нужна локальная база с возможностью фильтрации и сортировки.
Серверный leaderboard — для многопользовательских игр и защиты от читинга.

Пример минимального JSON для нескольких рекордов:

import json
from pathlib import Path

SCORES_FILE = Path("scores.json")

def load_scores():
    try:
        return json.loads(SCORES_FILE.read_text())
    except Exception:
        return []

def save_scores(scores):
    SCORES_FILE.write_text(json.dumps(scores, ensure_ascii=False))

Когда простая система очков не подойдёт

Если игра предполагает онлайн-таблицы рекордов — нужен сервер.
Для соревновательных игр важна защита от читинга; локальные файлы легко подменить.
Для сохранения большого количества метаданных удобнее БД.

Тесты и критерии приёмки

Критерии приёмки простых сценариев:

При соприкосновении игрока с зоной начисляется очко в заданный момент.
Рекорд сохраняется и корректно загружается после перезапуска.
Пауэр-ап активируется/деактивируется по таймеру.
Комбо увеличивает очки и сбрасывается при ошибке.

Минимальные тесты (unit/integration):

Тест загрузки/сохранения рекорда (файловая система — mock).
Тест начисления очков при попадании в зону.
Тест активации и деактивации пауэр-апа.

Чек-лист ролей при выпуске

Разработчик:

Реализовать учёт очков, рекорд и отображение.
Обработать ошибки ввода/выхода при работе с файлами.
Написать юнит-тесты.

Дизайнер:

Подобрать визуальные и звуковые сигналы для начисления очков.
Определить таблицу очков за действия.

QA:

Проверить сохранение рекорда на разных ОС.
Тестировать на разных разрешениях экрана.

Советы по безопасности и приватности

Если вы храните имена игроков — информируйте пользователей и соблюдайте требования приватности (например, GDPR). Не сохраняйте лишние персональные данные.
Для онлайн-лидербордов используйте аутентификацию и серверные проверки результатов.

Совместимость и миграция

Arcade поддерживает Python 3.7+. Проверяйте текущую совместимость в документации Arcade перед релизом.
При миграции от файлового хранения к SQLite: экспортируйте данные в CSV/JSON и импортируйте в таблицу.
На мобильных платформах пути к файлам отличаются. Используйте библиотеку appdirs для определения корня данных.

Шпаргалка (cheat sheet)

arcade.draw_text(text, x, y, color, size) — отрисовка текста.
arcade.schedule(func, interval) — периодические вызовы.
arcade.unschedule(func) — отмена расписания.
pathlib.Path — удобная работа с файлами.

Примерный процесс внедрения (мини-методология)

Прототип: реализуйте базовый счёт и отображение.
Тестирование: добавьте юнит- и интеграционные тесты для начисления и сохранения.
Расширение: добавьте пауэр-апы и комбо.
Хранение: выберите стратегию хранения рекордов (файл, JSON, SQLite, сервер).
Релиз: проверка на целевых платформах и мониторинг багов.

Когда стоит переходить на серверный leaderboard

Если нужна глобальная таблица лидеров.
Если требуется честная верификация результатов.
Если игра многопользовательская.

Mermaid-диаграмма принятия решения:

flowchart TD
  A[Нужен ли глобальный лидерборд?] -->|Да| B[Сервер + API]
  A -->|Нет| C[Локальное хранение]
  B --> D[Аутентификация + валидация данных]
  C --> E[Файл/SQLite/JSON]

Заключение

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

Важно: тестируйте сценарии начисления очков и сохранения рекорда на целевых платформах.

Ключевые шаги: прототип → тесты → расширение (пауэр-апы/комбо) → выбор стратегии хранения → релиз.

Управление очками в играх на Python с Arcade