move/walk0.06 мс процессорного времени150| Параметр | По умолчанию | Что задаёт |
|---|---|---|
x |
обязателен | Составляющая направления движения по оси X: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Не число, составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока она отключает от игры, у прочих сущностей карта падает. |
y |
обязателен | Составляющая направления движения по оси Y: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Не число, составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока она отключает от игры, у прочих сущностей карта падает. |
$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;