$object — сущность, которой присваивают значение компонента$value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнееЗаписано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
// Срок лежания мёртвого тела ведётся РАЗНЫМИ механиками: игрок по истечении поднимается на месте,
// прочие существа уходят с карты и возвращаются на точку появления. Сроки у них свои и совпадать не обязаны.
// Вешаем не важно есть ли сущность на сцене: мёртвое существо могли создать в админке, и срок ему ни разу не ставился.
$deadline = $object->kind == EntityTypeEnum::Player->value ? 'status/resurrect' : 'status/despawn';
if(!$value)
{
// Группа, заводимая ВПЕРВЫЕ, встаёт на ближайший кадр, а не на свой срок: полную длительность даёт только
// сброс таймаута. Без него тело, созданное мёртвой записью (труп, разложенный по карте), снимает первый же
// кадр, где его события вообще обрабатываются, — существо возвращается живым почти сразу.
// Пришедшую с сохранённым состоянием группу не трогаем: у игрока, зашедшего мёртвым, остаток срока едет
// вместе с ним, и сброс дал бы бесконечное продление воскрешения простым перезаходом.
$fresh = !$object->events->isset($deadline);
$object->events->add($deadline, 'index');
if($fresh)
$object->events->get($deadline)->resetTimeout();
}
// проверим что объект уже был на сцене (существует поле).Есть isset есть exist - первый првоерит на существование и не null , второй любое значение в существовании
// если у нас сработал тигер и стало максимум жизней (например прибвалось здоровья или мы вошли в игру) ничего не делаем
if(World::isset($object->key) && $value<$object->components->get('hp_max'))
{
// если не первое создание сущности и было до момента изменения жизней смены максимально здоровья сбросим таймаут регенерации (запустим отсчет ее по новой с этого момента) - а том можем сразу вылечиться после удара
if ($object->components->get('hp') == $object->components->get('hp_max'))
$object->events->get("status/regenerationhp")->resetTimeout();
if (!$value)
{
// Сюда доходит только НАСТОЯЩАЯ смерть: при добавлении сущности в мир триггеры компонентов идут
// до её регистрации, и внешний World::isset ложен — вход в игру и переход между картами этот блок
// не проходят вовсе, а повторная запись прежнего значения триггера не запускает.
$object->events->add("status/dead", 'index');
$object->events->get($deadline)->resetTimeout();
}
}