Игровое состояние: счёт и жизни

Состояние партии — маленькая база данных игры: сколько очков набрано, сколько жизней осталось, в какой фазе находится матч. Структура State держит эти поля вместе, и по типам видно, что чему принадлежит: score int, lives int, phase Phase — собственный целочисленный тип с константами через iota, как у сцен. Фаза — не сцена: сцены переключают экраны, а фазы описывают жизнь партии внутри боя — phasePlay и phaseGameOver. Счёт игры на Go живёт именно здесь, в данных, а не в надписях: строка SCORE 1200 — представление числа, а не само число, и пока вы держите их раздельно, интерфейс можно перекрашивать сколько угодно.

Правило отсечения простое: если значение переживёт кадр и что-то значит для логики — ему место в State; если оно существует лишь между двумя вызовами отрисовки — это локальная переменная Draw. Позиция героя — состояние; промежуточная позиция для сглаживания — нет. Такой фильтр держит структуру маленькой: у State игры курса четыре-шесть полей, и каждое понятно без комментариев. Если поле понадобилось двум методам сразу — верный знак, что оно живёт в State, а не в локальных переменных. Нулевые значения Go — готовое состояние старта, а явная функция reset делает старт видимым в коде и пригодным для рестарта.

HUD — слой поверх мира: цифры счёта, остаток жизней, подсказки клавиш. Он рисуется последним в Draw, после мира и камеры, поэтому всегда сверху, и живёт в координатах экрана, а не мира — скроллинг его не уносит. Текст берётся из урока про Ebitengine текст: источник шрифта text/v2 создаётся один раз при старте, а лицо GoTextFace можно собирать прямо в кадре — это дешёвая маленькая структура, кэш глифов живёт в источнике. Строка HUD собирается из State вызовом fmt.Sprintf: SCORE и LIVES печатаются из полей, а не дублируются вручную.

Разделение обязанностей здесь абсолютное: State не знает про текст, текст не знает про правила. Поменяете формат надписи — логика не заметит; поменяете правила начисления — HUD подхватит новые числа сам. Именно поэтому счёт игры на Go читают из структуры в момент отрисовки: между тиком логики и кадром картинки нет промежуточных копий, которые могли бы разойтись. Проверка на практике одна: выключите отрисовку мира — HUD обязан остаться и показать те же числа, потому что он читает State, а не пиксели мира.

Центральный закон урока повторяет пару из базового урока про окно и цикл: Update выполняется раньше Draw, и этот порядок — не деталь реализации, а контракт. Игровое состояние течёт в одну сторону: Update меняет State, Draw читает его и рисует. Нарушение потока — изменение счёта в Draw — делает картинку причиной логики: очки начнут зависеть от того, сколько кадров отрисовала машина, и две машины в одной партии разойдутся в результатах. Отладить такое почти невозможно: баг плавает вместе с частотой кадров и проявляется только на чужом железе.

Однонаправленность окупается тестами: State — обычная структура, и hitEnemy можно вызвать из теста без окна, проверив, что счёт вырос ровно на сто. Когда позже появятся горутины — сетевой режим, автосохранение — единственное место записи подскажет, где ставить мьютекс. Игровое состояние в Ebitengine остаётся обычными данными Go, и вся дисциплина сводится к одному вопросу: у каждого изменения ровно один автор — Update. Любое желание поправить число из Draw — сигнал, что Update недорабатывает, и править надо там, а не в отрисовке.

В браузерном мире рекорд хранят в localStorage, но в Go аналога нет — и это правильно: у настольной игры есть диск. Запись идёт в системный каталог конфигураций: os.UserConfigDir возвращает его путь — на Windows это Roaming-профиль пользователя, на Linux — XDG_CONFIG_HOME или домашний каталог, на macOS — Library Application Support. Путь собирается через filepath.Join с подкаталогом игры, чтобы не сваливать файлы в корень конфигураций, и создаётся os.MkdirAll при первом сохранении. Сам файл — несколько байт: strconv.Itoa рекорда или JSON со счётом, жизнями и датой.

Когда сохранять — вопрос баланса: каждый тик — лишняя работа с диском, поэтому сохранение вешают на моменты, а не на частоту: конец партии, потеря жизни, выход по Escape. Чтение — на старте: loadHighScore возвращает ноль при отсутствии файла, и первый запуск не отличается от сотого. Ошибка записи не роняет игру: нет доступа — играем без рекорда, и это честная деградация. Для игры курса хватает одного файла: слоты сохранений и настройки появятся вместе с итоговым проектом. Путь из UserConfigDir стоит печатать в лог при старте: игрок, который захочет перенести рекорд на другую машину или обнулить руками, скажет спасибо.

Жизни — счёт наоборот: он уменьшается, и каждое уменьшение — событие. killHero убирает жизнь и проверяет границу: ноль означает смену фазы на phaseGameOver, а смена фазы встраивается в автомат из урока про сцены: ветка боя перестаёт принимать ввод движения, экран поражения показывает счёт, клавиша R предлагает рестарт. Рестарт — чистый старт: State заменяется свежим значением с нулём очков и тремя жизнями, и никакие старые числа не переживают новый заход — та же гигиена входа, что у сцен с их хуками.

Фаз удобно держать чуть больше, чем кажется нужным: phaseReady перед стартом волны и phaseInvincible после смерти героя дают логике место для таймеров без россыпи булевых флагов. Дисциплина для всех полей State общая: каждое число меняет только Update, каждое условие проверяется там же, а фазы перечислимы — собственный тип Phase не даст записать в поле случайную семёрку. Проверьте связку на себе: потеря последней жизни меняет фазу в том же тике, и оверлей поражения появляется без задержки на кадр.