$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.' не найдена либо непроходима целиком — проверьте имя у существа либо разметку карты');