status/changes0.05 мс процессорного времени2| Параметр | По умолчанию | Что задаёт |
|---|---|---|
data |
обязателен | Пакет изменений для сущности: поля самой сущности (координаты x, y, z, карта, прочие свойства) и вложенный набор components — «идентификатор компонента → значение» (компонент применяет его своим кодом, в том числе как частичное изменение). |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
// $data — словарь ПАРАМЕТРОВ события: полезная нагрузка лежит в параметре data
$changes = $data['data'];
// Перенос чужой силой (портал и т.п.) обрывает движение существа: маршрут проложен от прежнего места, и шаг
// по нему повёл бы его назад — из портала обратно в портал. Снимается до смены карты: переезд уносит состояние
// существа пакетом новой локации, а код выхода игры пересчитал бы прежнюю цель под соседнюю карту.
if(array_key_exists('map', $changes) || isset($changes['x']) || isset($changes['y']) || isset($changes['z']))
{
$object->events->remove('move/walk');
unset($object->buffer['pathFinding'], $object->buffer['walkToTarget']);
}
// Смена карты — ПЕРВОЙ: __set('map') помечает существо на переезд (remove + рассылка),
// свойство map при этом остаётся прежним, а последующие изменения уедут пакетом новой локации.
if(array_key_exists('map', $changes))
{
$object->map = $changes['map'];
unset($changes['map']);
}
// Координаты существу ТЕКУЩЕЙ карты напрямую не присваиваются (__set бросает «используйте новый экземпляр
// Position») — собираем их в объект Position, недостающие оси берём из текущей позиции.
if(isset($changes['x']) || isset($changes['y']) || isset($changes['z']))
{
$object->position = new Position(
$changes['x'] ?? $object->x,
$changes['y'] ?? $object->y,
$changes['z'] ?? $object->z
);
unset($changes['x'], $changes['y'], $changes['z']);
}
foreach($changes as $key=>$value)
{
if($key == 'components')
{
foreach($value as $name=>$component)
{
$object->components->add($name, $component);
}
}
else
$object->$key = $value;
}