index

из группы move/walk
вызывает игрок
Шаг сущности в заданном направлении. Если клетка шага непроходима, сущность пробует обойти преграду: вместо шага по диагонали — шагнуть по одной из осей, вместо шага вдоль оси — шагнуть по диагонали в обход угла (насколько далеко сущность при этом продвигается, задаёт настройка игры «Обход угла», cornerOffset). Не обошла — пробует подойти к преграде вплотную (насколько близко к преграде сущность при этом подходит от центра своей клетки, задаёт настройка игры «Прижатие к преграде», creepDepth); не вышло и это — шага нет. Шагом этой команды сущность с зоной (компонент zone) либо с блужданием (событие группы move/randommove) за пределы своего дома не выходит. Дом — её зона, а у сущности без зоны — клетки не дальше радиуса привязки (параметр leash события блуждания) от точки появления (параметры spawn_x, spawn_y, spawn_z того же события). Вместо шага за эту границу игра прерывает сущности атаку — удар и выстрел (события групп fight/melee и fight/bolt) — и ставит ей движение move/walk/to домой, к ближайшей точке области зоны либо к точке появления. Собственная команда шага игрока прерывает его атаку. Нулевое направление шагом не является: оно останавливает движение — снимает событие группы move/walk, которое стоит у сущности, атаку не прерывая. Клиент игры шлёт нулевое направление, когда игрок касается джойстика движения, не сдвигая его: так игрок останавливается, не сделав шага. Когда игрок отпускает джойстик, клиент ничего не шлёт, и начатое движение — например к точке клика (событие move/walk/to) — идёт дальше. ИИ-помощник либо другая программа, которая вошла в игру игроком и отдаёт команды от его имени, останавливает движение так же — нулевым направлением. Как движение снимает перенос сущности событием группы status/changes (портал и т.п.), сказано в описании команды status/changes/index. Игрок с нулём здоровья тоже шагает этой командой. Пока такой игрок идёт, клиент игры рисует его полупрозрачным; когда он поднимается, сказано в описании команды status/resurrect/index.
Цена в кадре
Одно срабатывание: 0.06 мс процессорного времени
Срабатываний в минуту у одной сущности: 150
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
x обязателен
Составляющая направления движения по оси X: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Не число, составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока она отключает от игры, у прочих сущностей карта падает.
y обязателен
Составляющая направления движения по оси Y: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Не число, составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока она отключает от игры, у прочих сущностей карта падает.
Кому доступна
bot enemy spell animal player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

if(!is_numeric($data['x']) || !is_numeric($data['y']))
	throw new Exception($object->key.': Направление движения x и y должно быть числом для команды');

// Нулевое направление — ОСТАНОВКА: идти некуда, и активная команда группы снимается. Ею сценарий и
// клиент прерывают начатый маршрут (переносом чужой силой его обрывает status/changes): move/walk/to перевешивает себя каждым своим шагом, и прекращением команд
// он не останавливается вовсе; пошаговое движение так же встаёт, не дожидаясь следующего шага.
// Клиент шлёт её, когда палец лёг на джойстик без сдвига: так игрок встаёт, не сделав шага; сценариям и
// внешним клиентам иначе движение к точке нечем прервать. Ошибкой остаётся лишь нечисло: там направление
// не задано вовсе, а не задано нулём.
if($data['x'] == 0 && $data['y'] == 0)
{
	$object->events->remove('move/walk');
	return;
}

// если движение инициализировал игрок сбросим атаку и фаерболт который вызвает так же и движение
if($from_client)
{
	$object->events->remove('fight/bolt');
	$object->events->remove('fight/melee');
}

// направление движения
$object->forward = new Forward($data['x'], $data['y']);

// следующая позиция в указанном направлении длинной в один шаг
$new_position = $object->position->next($object->forward);

// что бы не хранился поиск пути
unset($object->buffer['pathFinding']);

if(!Map2D::isPassable($new_position, $object))
{
	$fx = $object->forward->x;
	$fy = $object->forward->y;
	$found = false;

	$only_x = $fx != 0 ? $object->position->next(new Forward($fx, 0)) : null;
	$only_y = $fy != 0 ? $object->position->next(new Forward(0, $fy)) : null;
	$can_x = $only_x && Map2D::isPassable($only_x, $object);
	$can_y = $only_y && Map2D::isPassable($only_y, $object);

	if($can_x && $can_y)
		[$new_position, $found] = [abs($fx) >= abs($fy) ? $only_x : $only_y, true];
	elseif($can_x)
		[$new_position, $found] = [$only_x, true];
	elseif($can_y)
		[$new_position, $found] = [$only_y, true];

	if(!$found && ($fx == 0 || $fy == 0))
	{
		$pos = $object->position->toArray();
		if($fy == 0)
		{
			$prefer = $pos['y'] >= round($pos['y'], 0, PHP_ROUND_HALF_EVEN) ? CORNER_OFFSET : -CORNER_OFFSET;
			$diag1 = $object->position->next(new Forward($fx * CORNER_OFFSET, $prefer));
			$diag2 = $object->position->next(new Forward($fx * CORNER_OFFSET, -$prefer));
		}
		else
		{
			$prefer = $pos['x'] >= round($pos['x'], 0, PHP_ROUND_HALF_EVEN) ? CORNER_OFFSET : -CORNER_OFFSET;
			$diag1 = $object->position->next(new Forward($prefer, $fy * CORNER_OFFSET));
			$diag2 = $object->position->next(new Forward(-$prefer, $fy * CORNER_OFFSET));
		}

		$cur_tile = $object->position->tile();
		foreach([$diag1, $diag2] as $diag)
			if(Map2D::isPassable($diag, $object) && $diag->tile() != $cur_tile)
				{ $new_position = $diag; $found = true; break; }
	}

	if(!$found && ($creep = Map2D::tryCreep($object->position, $fx, $fy, $object)))
		[$new_position, $found] = [$creep, true];

	if(!$found)
		return;
}

// зона/leash: не даём уйти далеко от дома. Компонент zone (именованная область карты)
// приоритетнее радиуса от спавна; вышел за зону → возврат к ближайшей её области.
// Нет зоны либо имя не найдено на карте → прежний radius-leash (данные в move/randommove).
$zone = $object->components->isset('zone') ? $object->components->get('zone') : null;
if($zone !== null && Map2D::hasZone($zone))
{
	if(!Map2D::inZone($zone, $new_position))
	{
		$object->events->remove('fight/melee');
		$object->events->remove('fight/bolt');
		if($home = Map2D::nearestZonePoint($zone, $object->position))
			$object->events->add('move/walk', 'to', ['x'=>$home->x, 'y'=>$home->y, 'z'=>$home->z]);
		return;
	}
}
elseif($object->events->isset('move/randommove'))
{
	$rmData = $object->events->get('move/randommove')->data;
	$spawn = new Position($rmData['spawn_x'], $rmData['spawn_y'], $rmData['spawn_z']);
	$leashRange = $rmData['leash'] + rand(0, (int)($rmData['leash'] / 2));

	if($new_position->distance($spawn) > $leashRange)
	{
		$object->events->remove('fight/melee');
		$object->events->remove('fight/bolt');
		$object->events->add('move/walk', 'to', ['x'=>$rmData['spawn_x'], 'y'=>$rmData['spawn_y'], 'z'=>$rmData['spawn_z']]);
		return;
	}
}

$new_position = Map2D::clearance($new_position, $object);

$old_arr = $object->position->toArray();
$new_arr = $new_position->toArray();
$dx = ($new_arr['x'] - $old_arr['x']) / STEP;
$dy = ($new_arr['y'] - $old_arr['y']) / STEP;
// Сдвиг бывает длиннее шага: clearance отводит точку от стены дальше, когда стеной оказалась клетка, из которой
// существо вышло (его поставили в неё напрямую), либо клетка сбоку после обхода угла. Направление длиннее единицы
// Forward не принимает — ужимаем его до единицы, ракурс тот же.
$length = sqrt($dx * $dx + $dy * $dy);
// Отвод от стены вернул точку на прежнее место — шага нет.
if(!$length)
	return;
if($length > 1)
	[$dx, $dy] = [$dx / $length, $dy / $length];
if(abs($dx - $object->forward->x) > 0.01 || abs($dy - $object->forward->y) > 0.01)
	$object->forward = new Forward($dx, $dy);

$object->action = 'walk';
$object->position = $new_position;
К игре