index

из группы status/changes
Канал изменения ЧУЖОЙ сущности: чтобы поменять данные другой сущности, ей ставят это событие с нужными изменениями — применяет их сама эта сущность в своём тике. Ставят его заявкой в очередь: изменения, которые в одном кадре поставили сущности несколько механик, применяются по очереди, по одному за кадр, и ни одно не теряется. Пакет сущности, стоящей на другой карте, сперва идёт на ту карту, поэтому изменения применятся не сразу. Порядок применения: пакет, несущий смену карты либо хоть одну координату, — перенос чужой силой (портал и т.п.), и он первым делом обрывает движение сущности (событие группы move/walk) вместе с проложенным маршрутом — после переноса сущность не идёт назад к точке, куда шла, и на новой карте прежний маршрут тоже не продолжается; затем карта — сущность переезжает на неё, затем координаты, затем остальные свойства и компоненты.
Цена в кадре
Одно срабатывание: 0.05 мс процессорного времени
Срабатываний в минуту у одной сущности: 2
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 1
Параметр По умолчанию Что задаёт
data обязателен
Пакет изменений для сущности: поля самой сущности (координаты x, y, z, карта, прочие свойства) и вложенный набор components — «идентификатор компонента → значение» (компонент применяет его своим кодом, в том числе как частичное изменение).
Кому доступна
bot enemy animal object player trader trader_silent
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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;
}
К игре