move/randommove0.1 мс процессорного времени20| Параметр | По умолчанию | Что задаёт |
|---|---|---|
point |
0 | Номер области зоны в порядке обхода, счёт с нуля; номер за последней областью зоны отсчитывается по кругу. Пока сущность идёт, номер называет область зоны, к точке которой сущность идёт, а когда команда patrol пропустила области зоны без пути к точкам этих областей зоны, — первую из пропущенных. Пока сущность стоит у точки области зоны, до которой дошла, номер называет следующую область зоны, к которой сущность пойдёт. Застав сущность при проверке у точки области зоны, команда patrol переводит номер на следующую область зоны; номер, заданный в событии, выбирает область зоны, с которой начнётся обход. |
wait |
3 | Сколько секунд сущность стоит у точки области зоны, прежде чем пойти к следующей области зоны; отсчёт идёт не с прихода сущности, а с первой после прихода проверки команды patrol. Когда пути нет ни к одной из точек областей зоны, через столько же секунд команда patrol снова проверяет, к точке какой из областей зоны путь есть. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
// Занят боем либо уже куда-то идёт — обход ждёт своей очереди, не перебивая текущее занятие.
if($object->events->get('fight/melee')->action || $object->events->get('fight/bolt')->action || $object->events->get('move/walk')->action)
return;
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
return;
$zone = $object->components->isset('zone') ? $object->components->get('zone') : null;
if(!$zone || !Map2D::hasZone($zone))
return;
$points = Map2D::zonePoints($zone, $object->position->z);
if(!$points)
return;
$count = count($points);
$index = (int)$data['point'] % $count;
// Точка ДРУГОЙ связной области карты недостижима шагами, а зона из нескольких областей законно бывает
// разнесена по карте — две поляны в разных её концах. Обход ведём только по достижимым точкам: иначе
// каждый его срок ставит заведомо невыполнимый ход, поиск пути отбивает цель по области, ход снимается,
// и всё это повторяется, пока моб жив.
$tile = $object->position->tile();
$goal = null;
for($i = 0; $i < $count; $i++)
{
$candidate = $points[($index + $i) % $count];
if(Map2D::sameArea($tile, $candidate->tile()))
{
$index = ($index + $i) % $count;
$goal = $candidate;
break;
}
}
// Ни одной достижимой точки — обходить нечего: ждём своего срока, поиск пути не тревожим.
if(!$goal)
{
$object->events->add('move/randommove', 'patrol', ['point' => $index, 'wait' => $data['wait']]);
$object->events->get('move/randommove')->resetTime((float)$data['wait']);
return;
}
// Дошли до точки — постоять и взять следующую. Зона из одной области — остаёмся на месте (охрана точки).
if($object->position->distance($goal) <= 1)
{
$object->events->add('move/randommove', 'patrol', ['point' => $index + 1, 'wait' => $data['wait']]);
$object->events->get('move/randommove')->resetTime((float)$data['wait']);
return;
}
$goal_array = $goal->toArray();
$object->events->add('move/walk', 'to', ['x' => $goal_array['x'], 'y' => $goal_array['y'], 'z' => $goal_array['z']]);
// Пока идём — проверять чаще раза в секунду незачем: сам маршрут ведёт событие движения.
$object->events->get('move/randommove')->resetTime(1);