object/portal0.05 мс процессорного времени60| Параметр | По умолчанию | Что задаёт |
|---|---|---|
map |
0 | Номер карты назначения: не ноль — игрок переезжает на эту карту, и координаты точки прибытия — в её клетках; ноль — прибытие в пределах текущей карты. |
x |
пусто | Координата точки прибытия по оси X в клетках карты назначения. Обязательна вместе с координатой Y. |
y |
пусто | Координата точки прибытия по оси Y в клетках карты назначения. Обязательна вместе с координатой X. |
z |
0 | Этаж точки прибытия (z). Ноль — этаж игрока при перемещении не меняется. |
$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]);