index

из группы object/portal
Инициализация портала: проверяет заданную ему точку прибытия (она не может попадать в клетку самого портала; при перемещении в пределах текущей карты она обязана быть проходимой клеткой — иначе игрок застрял бы в непроходимой), собирает из неё готовые данные перемещения и ставит порталу событие status/collision/portal с этими данными и радиусом 0 — проверка столкновений, которая идёт каждый кадр, дальше работает с готовыми проверенными данными. Радиус 0 обязателен: точки прибытия встречных порталов стоят в 1–2 клетках друг от друга, и радиус 1 и больше ловит прибывшего игрока и тут же отправляет его обратно — игрок без конца переезжает между двумя порталами. По той же причине точку прибытия нельзя ставить на клетку встречного портала (а при увеличении радиуса — и вплотную к ней). Портал без заданных координат точки прибытия считается ненастроенным и молча бездействует.
Цена в кадре
Одно срабатывание: 0.05 мс процессорного времени
Срабатываний в минуту у одной сущности: 60
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 4
Параметр По умолчанию Что задаёт
map 0 Номер карты назначения: не ноль — игрок переезжает на эту карту, и координаты точки прибытия — в её клетках; ноль — прибытие в пределах текущей карты.
x пусто Координата точки прибытия по оси X в клетках карты назначения. Обязательна вместе с координатой Y.
y пусто Координата точки прибытия по оси Y в клетках карты назначения. Обязательна вместе с координатой X.
z 0 Этаж точки прибытия (z). Ноль — этаж игрока при перемещении не меняется.
Кому доступна
portal
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

// цель телепорта приходит параметрами стартового события портала (x, y обязательны; z, map — опционально)
// x/y не заданы числами (портал без настроенной цели) — тихо выходим: throw на объекте (не игроке) роняет карту (Frame::tick перебрасывает исключение)
if(!is_numeric($data['x'] ?? null) || !is_numeric($data['y'] ?? null))
	return;

$position = new Position($data['x'], $data['y'], (is_numeric($data['z'] ?? null) ? $data['z'] : 0));
if($object->position->tile() == $position->tile())
	throw new Exception('клетка '.$position.' равна округленной позиции игрока (слишком маленькая дистанция у портала)');

if(empty($data["map"]) && empty(Map2D::getCurrentMapTiles()[$position->tile()]))
	throw new Exception('позиция '.(string)$position.' непроходима на текущей карте');

$pkg = array();
if(!empty($data["z"]))
	$pkg['z'] = $data["z"];
if(!empty($data["x"]))
	$pkg['x'] = $data["x"];
if(!empty($data["y"]))
	$pkg['y'] = $data["y"];
if(!empty($data["map"]))
	$pkg['map'] = $data["map"];

$object->events->add('status/collision', 'portal', ['data'=>$pkg, 'distance'=>0]);
К игре