Документация Игрового Мира: Выживание Юнитов

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

🗺️ Обзор Игрового Мира

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

🧬 Юниты

Каждый юнит — это уникальное существо со своей родословной, которая определяется уникальным ID. Этот ID передается всем потомкам, позволяя отслеживать генеалогию. В начале игры каждый новый юнит стартует с 200 единицами энергии.

Энергия: Двигатель Жизни

Энергия расходуется на:

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

Важно: Если энергия юнита опускается до нуля или выполнение команды приводит к ошибке, юнит погибает.

📜 Код Поведения Юнита

Юниты выполняют заранее заданный код, состоящий из последовательности команд. Команды делятся на два типа: действия и операции.

🚶 Действия (Одна операция за Ход)

Эти команды определяют физическое взаимодействие юнита с миром. За один игровой ход юнит может выполнить только одно действие.

MOVE [направление]
- Описание: Перемещает юнита в указанном направлении (UP, DOWN, LEFT, RIGHT).
- Направления: UP (вверх), DOWN (вниз), LEFT (влево), RIGHT (вправо).
- Затраты энергии: 10 единиц.
- Пример: MOVE UP (двигаться вверх)
WAIT
- Описание: Юнит остается на текущей позиции, не совершая никаких действий.
- Затраты энергии: 0 единиц (бесплатно).
- Пример: WAIT (ждать)
REPRODUCE [кол-во энергии]
- Описание: Создает нового юнита-потомка. Указывает, сколько энергии текущий юнит передаст своему потомку.
- Затраты энергии: 50 единиц (плюс переданная потомку энергия).
- Пример: REPRODUCE 100 (размножиться, передав потомку 100 энергии)

🧠 Остальные Операции (Выполняются до Действия)

Эти команды выполняются до тех пор, пока не будет встречена команда действия (MOVE, WAIT, REPRODUCE). Они позволяют юниту обрабатывать информацию и принимать решения.

SCAN [адрес памяти], [тип объекта]
- Описание: Сканирует область вокруг юнита (радиус 4 клетки) и записывает информацию о найденных объектах в указанный адрес памяти.
  - Первая ячейка памяти ([адрес памяти]) будет содержать количество найденных объектов.
  - Следующие пары ячеек памяти будут содержать относительные координаты (X, Y) каждого найденного объекта. Координата X записывается первой, затем Y.
- Типы объектов:
  - UNIT: Сканирует других юнитов.
  - FOOD: Сканирует точки пропитания.
  - ALL: Сканирует все объекты (юниты и пропитание).
- Затраты энергии: 1 единица.
- Пример: Если SCAN A1, FOOD находит 2 точки пропитания с относительными координатами (-1, 0) и (2, 2), то память будет выглядеть так:
```
A1 = 2
A2 = -1
A3 = 0
A4 = 2
A5 = 2
```
ADD [адрес памяти], [адрес памяти/число]
- Описание: Суммирует значение первого операнда (содержимое адреса памяти) со значением второго операнда (содержимое другого адреса памяти или число) и записывает результат обратно в первый адрес памяти.
- Затраты энергии: 1 единица.
- Пример: ADD A1, A2 (A1 = A1 + A2); ADD A3, 5 (A3 = A3 + 5)
SUB [адрес памяти], [адрес памяти/число]
- Описание: Вычитает значение второго операнда (содержимое адреса памяти или число) из значения первого операнда (содержимое адреса памяти) и записывает результат обратно в первый адрес памяти.
- Затраты энергии: 1 единица.
- Пример: SUB A1, A2 (A1 = A1 - A2); SUB A3, 10 (A3 = A3 - 10)
RAND [адрес памяти], [максимальное значение]
- Описание: Генерирует случайное целое число в диапазоне от 0 до максимального значения (включительно) и записывает его в указанный адрес памяти.
- Затраты энергии: 1 единица.
- Пример: RAND A1, 100 (A1 = случайное число от 0 до 100)
GOTO [метка/номер строки]
- Описание: Безусловно переводит выполнение кода к указанной метке или номеру строки.
- Затраты энергии: 1 единица.
- Пример: GOTO LOOPSTART; GOTO 15
[метка]:
- Описание: Определяет точку в коде, к которой можно перейти с помощью команды GOTO или IF. Каждая программа юнита должна содержать хотя бы одну метку START:.
- Затраты энергии: 0 единиц (бесплатно).
- Пример: START: (начало программы); SEARCHFOOD: (метка для поиска еды)
IF [выражение] GOTO [метка/номер строки]
- Описание: Если выражение истинно, то выполнение кода переходит к указанной метке или номеру строки.
- Выражение: Состоит из двух операндов (содержимое адреса памяти или число) и операции сравнения.
- Операции сравнения:
  - < (меньше)
  - > (больше)
  - = (равно)
- Затраты энергии: 2 единицы.
- Пример: IF A1 > 0 GOTO FOUNDFOOD (если в A1 больше нуля, перейти к метке FOUNDFOOD)

🛠️ Память Юнита

Юниты используют простую систему памяти для хранения числовых значений. Доступ к ячейкам памяти осуществляется по адресу памяти (например, A1, A10 и т.д.). Доступно 30 ячеек памяти A0-A29

🛑 Условия Гибели Юнита

Юнит погибает в двух случаях:

Истощение энергии: Если запас энергии юнита падает до 0 или ниже.
Ошибка выполнения: Если команда не может быть выполнена корректно (например, некорректные аргументы).

Желаю удачи в создании вашей игры! Если у вас возникнут дополнительные вопросы или потребуется дальнейшая доработка документации, обращайтесь!