zone

строка со своим кодом
Имя зоны сущности. Зона — все области зоны на карте сущности, названные этим именем; область зоны — объект с площадью (прямоугольник, эллипс либо многоугольник) на слое объектов карты, объект-переход областью зоны не бывает. В зону идёт лишь область зоны, где есть хотя бы одна проходимая клетка: к области зоны без проходимой клетки сущность не подвести. Точка области зоны — проходимая клетка области зоны, ближайшая к центру этой области зоны. Вне боя сущность держится своей зоны: как её водят блуждание и обход и каким сущностям их ставит код входа, сказано в описаниях группы move/randommove и её команд, а на кого сущность нападает по своей инициативе — в описании команды fight/search/index. Погоня и ответная ближняя атака идут движением к цели (команда move/walk/to), а границу зоны держит лишь шаг по направлению (команда move/walk/index): в погоне сущность выходит из зоны и бросает погоню, когда цель отходит от неё дальше и радиуса жизни преследующей сущности (поле сущности lifeRadius), и радиуса жизни цели. Когда на карте сущности нет ни одной области зоны с этим именем и с проходимой клеткой, карта с такой сущностью не запускается, а в журнал ошибок песочницы карты ложится запись с сущностью, именем и картой; смена значения на такое имя по ходу игры даёт ту же запись, и работающая карта падает. Пустое значение — зоны нет: сущность держится радиуса привязки (параметр leash команды move/randommove/index) вокруг точки появления.
Стартовое значение
пусто
Сущность получает компонент пустым: ноль у числа, пустая строка у текста, пустой набор у списка.
Кому выдаётся
bot enemy
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
/** @var EntityAbstract $object @var ?string $value */

// Имя области, которого на карте нет, молча превращает существо в привязанное к точке появления:
// поведение похожее, но дом у существа совсем другой, и разметчик карты об этом не узнает никогда.
// Тот же отказ покрывает и разметку, чьи области непроходимы целиком: такие в зону не идут, и имени за ними не остаётся.
// Проверка стоит ЗДЕСЬ, а не в событиях ИИ: значение приходит сюда всеми каналами — и при загрузке
// существа на карту, и при любой позднейшей смене, а событий-читателей у него несколько.
if((string)$value !== '' && !Map2D::hasZone((string)$value))
	throw new Error($object->key.': область «'.$value.'» на карте '.MAP_ID.' не найдена либо непроходима целиком — проверьте имя у существа либо разметку карты');
К игре