portal

из группы status/collision
повторяется
Проверка столкновений с порталом: перебирает сущностей в пределах радиуса срабатывания (параметр distance) и каждому игроку среди них ставит заявкой событие status/changes с готовыми данными перемещения — перемещение исполняется уже на самом игроке, как любой перенос событием группы status/changes (что перенос делает с движением, сказано в описании команды status/changes/index). Переезд на карту, не соседнюю с текущей, проходит через сохранение персонажа и переподключение клиента. Отдельная команда от object/portal/index, чтобы работать с готовыми данными, проверенными при инициализации портала.
Цена в кадре
Одно срабатывание: 0.04 мс процессорного времени
Срабатываний в минуту у одной сущности: 60 * fps
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 3
Параметр По умолчанию Что задаёт
count 1 У этой команды параметр не действует: событие перемещения получает каждый игрок в радиусе срабатывания (параметр distance).
data обязателен
Готовые данные перемещения, которые ставятся заявкой каждому найденному игроку: координаты точки прибытия (x, y и опционально z, номер карты; без карты перемещение в пределах текущей). Приходят проверенными от инициализации портала — здесь не проверяются.
distance 1
Радиус срабатывания вокруг портала в клетках: 0 — только клетка самого портала, 1 — квадрат 3×3 вокруг неё и так далее. Инициализация портала задаёт 0 — почему, сказано в описании команды object/portal/index.
Кому доступна
item spell object portal
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

Код команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.

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

<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */

World::filter($object->x, $object->y, $object->z, static function(EntityAbstract $object) use($data):bool
{
	if($object instanceOf Player)
	{
		$object->events->push("status/changes", "index", ["data"=>$data['data']]);
	}

	return false;
}, $data['distance'], $data['count']);
К игре