patrol

из группы move/randommove
повторяется
Обход зоны вместо блуждания (команда index этой группы). Зона сущности — области зоны, названные именем из компонента zone; область зоны — объект с площадью на слое объектов карты, точка области зоны — проходимая клетка области зоны, ближайшая к центру этой области зоны. Сущность по очереди идёт к точкам областей своей зоны. Области зоны идут в порядке слоёв карты снизу вверх — в том порядке, в каком карта рисует слои, у слоя внутри группы слоёв — на месте этой группы слоёв, — а на одном слое в том порядке, в каком заведены его объекты. Подойдя к точке области зоны не дальше чем на одну клетку по каждой оси, в том числе по диагонали, сущность стоит там и затем идёт к точке следующей области зоны, а после последней области зоны — снова к точке первой. Где сущность, команда patrol узнаёт проверками: первая идёт через одну секунду после того, как команда отправила сущность к точке области зоны, а следующие, пока сущность занята движением (группа move/walk) либо боем (группы fight/melee и fight/bolt), — через паузу группы move/randommove. Остановилась сущность, не дойдя до точки области зоны, — команда patrol снова отправляет её к этой точке области зоны. Команда patrol пропускает область зоны, к точке которой от клетки, где стоит сущность, шагами пути нет, а когда пути нет ни к одной из точек областей зоны, никуда не ведёт сущность. В зоне из одной области зоны сущность держится точки этой области зоны: после погони сущность возвращается к точке этой области зоны. Сущность с нулём здоровья и меньше обход не ведёт. У сущности без зоны команда patrol ничего не делает, и сущность стоит на месте; такой сущности ставьте событие блуждания (команда index этой группы).
Цена в кадре
Одно срабатывание: 0.1 мс процессорного времени
Срабатываний в минуту у одной сущности: 20
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
point 0
Номер области зоны в порядке обхода, счёт с нуля; номер за последней областью зоны отсчитывается по кругу. Пока сущность идёт, номер называет область зоны, к точке которой сущность идёт, а когда команда patrol пропустила области зоны без пути к точкам этих областей зоны, — первую из пропущенных. Пока сущность стоит у точки области зоны, до которой дошла, номер называет следующую область зоны, к которой сущность пойдёт. Застав сущность при проверке у точки области зоны, команда patrol переводит номер на следующую область зоны; номер, заданный в событии, выбирает область зоны, с которой начнётся обход.
wait 3
Сколько секунд сущность стоит у точки области зоны, прежде чем пойти к следующей области зоны; отсчёт идёт не с прихода сущности, а с первой после прихода проверки команды patrol. Когда пути нет ни к одной из точек областей зоны, через столько же секунд команда patrol снова проверяет, к точке какой из областей зоны путь есть.
Кому доступна
bot enemy
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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);
К игре