move/walk0.33 + 0.001 * Math.min(400 * lifeRadiusMax / 24, walkable * 0.2) мс процессорного времени150| Параметр | По умолчанию | Что задаёт |
|---|---|---|
target |
пусто | Ключ сущности-цели на запущенной карте, за которой идёт движущаяся сущность: точка цели на каждом шаге берётся из позиции сущности-цели, поэтому маршрут ведёт за ней, даже когда она движется. Если сущность-цель пропала с карты — снята с неё, вышла из игры, ушла через переход на другую карту и т.п., — движение снимается. Пусто — сущность идёт к точке из параметров x и y. |
then |
пусто | Событие, которое движение поставит сущности по прибытии: словарь из полного идентификатора команды «категория/группа/команда» (event) и её параметров (data). Прибыть — встать на клетку цели; у непроходимой цели — на проходимую клетку, выбранную вместо неё; у сущности-цели — подойти на дистанцию удержания, а когда дистанция не задана, дойти до клетки сущности-цели. Так ведётся подход: событие, ради которого сущность шла, ставится заново уже на месте. Движение, снятое раньше (маршрута нет либо он оборвался, сущность-цель пропала с карты, цель оказалась дальше предела, это движение заменило другое событие группы move/walk — в том числе поставленное командой игрока), события не ставит. Параметр задаётся только кодом механик: присланный в команде игрока — нарушение: игрок отключается от игры. Пусто — по прибытии ничего. |
max_distance |
пусто | Дистанция удержания в клетках при сущности-цели: подойдя к сущности-цели на эту дистанцию либо ближе, движущаяся сущность останавливается — это прибытие, и событие из параметра then ставится. Пусто либо ноль — сущность идёт до клетки сущности-цели. |
x |
обязателен | Координата цели по оси X в клетках карты: это точка на карте, а не направление. Не число — ошибка: игрока она отключает от игры, у прочих сущностей карта падает. Задана сущность-цель — точка цели берётся из позиции сущности-цели, а значение этого параметра не используется, хотя передать его нужно. |
y |
обязателен | Координата цели по оси Y в клетках карты: это точка на карте, а не направление. Не число — ошибка: игрока она отключает от игры, у прочих сущностей карта падает. Задана сущность-цель — точка цели берётся из позиции сущности-цели, а значение этого параметра не используется, хотя передать его нужно. |
z |
пусто | Этаж карты, на котором стоит цель. Путь ищется по этому этажу: шагом этаж не сменить, и цель на другом этаже недостижима — движение снимается. Пусто — этаж самой сущности. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client @var bool $client_origin */
// Движение, начатое игроком, прерывает его удар, выстрел и лечение — но лишь когда оно состоялось: шагнуло либо
// прибыло. Отброшенный клик (цель дальше предела, пути нет) атаку не трогает — отказ атомарен.
// Отметка «маршрута нет» для удара, выстрела и лечения — клетка цели этого движения: ставится, когда оно сняло
// себя, не найдя пути, либо отбило пределом дальности подход, поставленный кодом механик; отбитый клик игрока
// её не ставит. Атака снимается, когда её цель стоит на этой клетке. Факт «пути нет» держит само движение, а не
// параметр атаки: так его проверяет любая атака без своей копии клетки (решение автора 2026-11-02).
unset($object->buffer['walkNoRoute']);
$interrupt = function() use ($object, $from_client): void
{
if(!$from_client)
return;
$object->events->remove('fight/bolt');
$object->events->remove('fight/melee');
$object->events->remove('magic/heal');
};
if($from_client)
{
// Команду по прибытии ставит только код механик: присланная игроком позвала бы по прибытии
// любую команду мимо проверки, может ли её отдать сам игрок. Клиент такого поля не шлёт вовсе —
// пришедшее есть нарушение.
if($data['then'])
throw new Exception('команда по прибытии пришла в пакете игрока — её ставит только код механик (move/walk/to)');
}
// Подход (к контейнеру, к вещи на земле) ведёт само движение: дойдя до цели, оно ставит команду, ради
// которой шли, и та повторяется уже на месте. Отменяет подход любая новая команда движения — она занимает
// эту же группу, — а маршрута нет либо цель ушла — движение снимается, не дойдя, и команды не ставит.
$then = $data['then'];
$arrive = function() use ($object, $then, $interrupt): void
{
$interrupt();
$object->events->remove('move/walk');
if(!$then)
return;
$at = strrpos($then['event'], '/');
$object->events->add(substr($then['event'], 0, $at), substr($then['event'], $at + 1), $then['data'] ?? []);
};
// Цель-СУЩЕСТВО: точка берётся из его позиции на каждом шаге — так маршрут идёт за движущимся.
// Следование живёт внутри самого движения, а не отдельным событием группы: активное событие в группе одно,
// и два события затирали бы друг друга — тот, кто вешается вторым, отменял бы шаг первого, и шага не случалось бы вовсе.
$target = (string)($data['target'] ?? '');
$maxDistance = (float)($data['max_distance'] ?? 0);
if($target)
{
// Цель ушла из мира (убита, вышла, сменила карту) — идти больше не за кем.
if(!World::isset($target))
{
$object->events->remove('move/walk');
return;
}
$follow = World::get($target);
// Дистанция удержания меряется в клетках: по дробной позиции шаг перескакивал её и доводил до клетки самой цели.
$distance = $object->position->round()->distance($follow->position->round());
// Дистанция удержания: подошли ближе — следование окончено. Не задана — идём вплотную.
if($maxDistance > 0 && $distance <= $maxDistance)
{
$arrive();
return;
}
$goal = $follow->position->toArray();
$data['x'] = $goal['x'];
$data['y'] = $goal['y'];
$data['z'] = $goal['z'];
}
if(!is_numeric($data['x']) || !is_numeric($data['y']))
throw new Exception($object->key.': Невозможно идти к точкам x и y если это не цифровые координаты');
// Путь ищется по этажу цели: шагом этаж не сменить, и цель на другом этаже отбивает поиск пути.
// Этаж не прислан — цель на этаже самого существа.
$vector = new Position($data['x'], $data['y'], is_numeric($data['z'] ?? null) ? $data['z'] : $object->position->z);
// Клетка цели для отметки «маршрута нет» — до подмены цели ближайшей проходимой клеткой ниже.
$goal_tile = $vector->tile();
// Далеко ли позволено уходить за один клик. Предел цели клика — 1,25 радиуса жизни персонажа (решение
// автора 2026-11-01): у края карты, где упирается камера, экран лежит по одну сторону от персонажа, и на
// экране до 2,5:1 (браузер на телефоне 22:9 во весь экран) его дальний край отстоит на
// (радиус / 2 − 0,5) × 2,5 − 0,5 клетки; остаток запаса — на клик на ходу: персонаж к его приходу бывает
// на шаг дальше позиции, от которой кликнули. Предел
// маршрута шире предела цели: цель рядом, а обход преграды длиннее прямой. Разбуженному существу с нулевым
// радиусом предел маршрута берётся от нижней границы — иначе оно не сделает ни шага.
$walk_radius = max($object->lifeRadius, 8);
// Цель ДАЛЬШЕ предела верный клиент шлёт лишь кликом на ходу у края предела либо у края экрана шире
// 2,5:1, остальное — подделанный клиент;
// исход у обоих один — отказ без маршрута. Отбиваем ДО поиска пути: именно дальняя цель и стоит дорого — обход через полкарты
// раскрывает тысячи клеток внутри одного кадра. Проверяем всю ЦЕПОЧКУ, начатую клиентом, а не только
// команду из его пакета: подбор вещи и открытие контейнера ставят это движение СВОИМ кодом, и по
// from_client их цель не проверялась вовсе — подделанный клиент вёл персонажа куда угодно через них.
// Цели, которые код механик ставит сам по себе (погоня, разбег, случайная прогулка, патруль, возврат
// домой), сюда не попадают: клиент их не инициировал, и своей дальностью они управляют сами.
// Судится лишь НОВАЯ цель: шаг маршрута ставит это движение заново, и при обходе преграды персонаж законно
// оказывается от цели дальше, чем был в начале, — проверка на каждом шаге обрывала бы честный путь
// (решение автора 2026-10-21). Продолжением считается лишь повтор с той же целью с клетки, куда встал
// прошлый шаг: персонаж, ушедший оттуда иначе, ставит цель заново. Цель-существо — по его ключу.
$intent = $target !== '' ? $target : $data['x'].','.$data['y'].','.$data['z'];
$step = $object->buffer['walkStep'] ?? null;
unset($object->buffer['walkStep']);
if($client_origin && $step !== [$intent, $object->position->tile()] && $object->position->distance($vector) > $object->lifeRadius * 1.25)
{
// Из пакета игрока это не нарушение: своей проверки дальности у клиента нет, и такой клик шлёт и верный
// клиент — на ходу, когда персонаж ушёл от позиции клика шагами, ответ на которые ещё в пути (гонка,
// решение автора 2026-10-28), либо у края экрана шире 2,5:1 (решение автора 2026-10-31).
$object->warning('цель '.$vector->tile().' дальше обзора персонажа — команда move/walk/to отброшена');
// Отбит подход, который поставил код механик (атака по цели): повтор упрётся в тот же предел, и атаке это
// «маршрута нет». Отбитый клик самого игрока отметки не ставит — атака после него остаётся.
if(!$from_client)
$object->buffer['walkNoRoute'] = $goal_tile;
$object->events->remove('move/walk');
return;
}
// если осталось меньше шага то путь уже не проложим
if($object->position->tile() == $vector->tile())
{
$arrive();
return;
}
$tile = $vector->tile();
// Годность цели спрашиваем ТЕМ ЖЕ предикатом, которым делается шаг: наличие клетки в матрице её не
// доказывает — матрица держит и клетки соседних карт открытого мира, а они проходимы лишь пока их карта
// доступна. Разойдясь, проверка цели и проверка шага дают маршрут, по которому нельзя сделать ни шага.
if(!Map2D::isPassable($vector, $object))
{
// Кешируем результат radius-search по click-координатам — иначе при каждой итерации
// (когда игрок переместился) исключение его тайла даёт другой ближайший тайл и движение осциллирует.
$cache_key = $data['x'].','.$data['y'].','.$data['z'];
if(isset($object->buffer['walkToTarget']) && $object->buffer['walkToTarget']['key'] === $cache_key)
{
$vector = $object->buffer['walkToTarget']['vector'];
$tile = $object->buffer['walkToTarget']['tile'];
}
else
{
// Игрок кликнул мимо карты, в преграду (клетка с коллайдером в матрицу проходимости не попадает
// вовсе) либо в сторону недоступной соседней карты — ищем ближайший проходимый тайл вокруг точки клика.
// Ширина поиска — настройка игры (PASSABLE_SEARCH_RADIUS): ту же величину получает клиент при входе
// и ею решает, есть ли смысл слать команду вовсе.
$tx = (int)round($vector->x, 0, PHP_ROUND_HALF_EVEN);
$ty = (int)round($vector->y, 0, PHP_ROUND_HALF_EVEN);
$tz = (int)round($vector->z, 0, PHP_ROUND_HALF_EVEN);
$cur_tile = $object->position->tile();
$me = $object->position->toArray();
$best = null;
$best_dist = PHP_INT_MAX;
for($dx = -PASSABLE_SEARCH_RADIUS; $dx <= PASSABLE_SEARCH_RADIUS; $dx++)
for($dy = -PASSABLE_SEARCH_RADIUS; $dy <= PASSABLE_SEARCH_RADIUS; $dy++)
{
if($dx == 0 && $dy == 0) continue;
$candidate = new Position($tx + $dx, $ty + $dy, $tz);
$cand_tile = $candidate->tile();
if($cand_tile == $cur_tile) continue;
if(!Map2D::isPassable($candidate, $object)) continue;
// Близость считается от ПЕРСОНАЖА, не от точки клика: по близости к клику
// ближайшей регулярно оказывается клетка по ДРУГУЮ сторону преграды, и маршрут уводит
// в обход всего препятствия, хотя игрок показал на стену рядом с собой. Подход к преграде
// с той стороны, где он стоит, и есть ожидаемый им исход; вплотную к самой точке клика
// его дотягивает creep по прибытии ниже.
$ddx = $tx + $dx - $me['x'];
$ddy = $ty + $dy - $me['y'];
$dist = $ddx * $ddx + $ddy * $ddy;
if($dist < $best_dist) { $best = $candidate; $best_dist = $dist; }
}
if(!$best)
{
$object->buffer['walkNoRoute'] = $goal_tile;
$object->events->remove('move/walk');
return;
}
$vector = $best;
$tile = $vector->tile();
$object->buffer['walkToTarget'] = ['key' => $cache_key, 'vector' => $vector, 'tile' => $tile];
}
// Игрок дошёл до целевого тайла — creep ближе к оригинальному клику, встанет вплотную к стене.
if($object->position->tile() == $tile)
{
$pos = $object->position->toArray();
if($creep = Map2D::tryCreep($object->position, $data['x'] - $pos['x'], $data['y'] - $pos['y'], $object))
{
$creep_arr = $creep->toArray();
$object->forward = new Forward(($creep_arr['x'] - $pos['x']) / STEP, ($creep_arr['y'] - $pos['y']) / STEP);
$object->position = Map2D::clearance($creep, $object);
$object->action = 'walk';
}
unset($object->buffer['walkToTarget']);
$arrive();
return;
}
}
if(empty($object->buffer['pathFinding']) || end($object->buffer['pathFinding']) != $tile)
{
// Путь есть, но цель сместилась на другой тайл: полный A* не чаще раза в 0.5с — старый
// путь всё равно ведёт в её сторону, хвост доложит следующий пересчёт (иначе погоня за
// движущейся целью гоняет A* на каждый её шаг; погоню ставят и точкой — удар, заклинание).
// Цепочка, начатая игроком (клик в точку, по вещи, по контейнеру), — его новое намерение:
// старый путь ведёт к прежней цели, считаем сразу. Пустой буфер (нового маршрута ещё нет)
// считаем сразу, иначе движение замрёт до истечения лимита.
if($client_origin
||
empty($object->buffer['pathFinding'])
||
empty($object->buffer['pathFindingAt'])
||
Data::monotime() - $object->buffer['pathFindingAt'] >= 0.5)
{
$start = hrtime(true);
// Предел ограничивает не дальность цели, а ПЕТЛЯНИЕ сверх прямой: дорог именно обход, у которого
// маршрут в разы длиннее расстояния до цели. Считать предел от одного радиуса нельзя — цели,
// которые ставит код механик (обход зоны по кругу, возврат домой, погоня), законно бывают дальше
// него, и такой предел отбивал бы их как непроходимые.
// Вчетверо сверх прямой: обход бухты либо квартала законно тянет маршрут в два-три раза длиннее
// расстояния до цели — замер по карте 54 дал 72 клетки маршрута на 28 клеток прямой. Отсекается
// то, что длиннее вчетверо: такой обход и есть дорогой перебор, ради которого предел заведён.
$max_path = max($walk_radius * 4, $object->position->distance($vector) * 4 + $walk_radius);
if(!$object->buffer['pathFinding'] = PathFinding::astar($object->position->tile(), $tile, $max_path, $object->keepsToMap() ? Map2D::getCurrentMapTiles() : null))
{
$object->buffer['walkNoRoute'] = $goal_tile;
$object->events->remove('move/walk');
return;
}
$object->buffer['pathFindingAt'] = Data::monotime();
if(APP_PERFOMANCE)
Perfomance::set('Library | расчет поиска пути мс.', (hrtime(true) - $start)/1e+6);
}
}
$new_position = new Position(...explode(Position::DELIMETR, $object->buffer['pathFinding'][0]));
// forward к узлу пути (нормализован, длина ≤1 — валиден для Forward) и под-шаг в его направлении
$forward = $object->position->forward($new_position);
$position = $object->position->next($forward);
if(!Map2D::isPassable($position, $object))
{
// Узел маршрута сам обязан быть проходим ПРЯМО СЕЙЧАС, и спрашивается это отдельно: маршрут строится
// по матрице клеток и живёт дольше одного шага, а проходимость клетки соседней карты снимается вместе
// с доступностью её узла. Шаг в такую клетку уводит за границу карты, которая не поднимается: игрок
// остаётся записанным туда и войти обратно уже не может. Преграды матрицы после старта карты не
// меняются, потому непроходимым узел маршрута делает лишь недоступность соседней карты — сбой, не исход механики.
if(!Map2D::isPassable($new_position, $object))
{
$object->warning("клетка маршрута ".$new_position->tile()." лежит на соседней карте, ставшей недоступной, — движение из команды move/walk/to прекращено");
unset($object->buffer['pathFinding']);
$object->events->remove('move/walk');
return;
}
// возможно как то можно чуть чуть отклонить forward для того что бы он попадал в существующую клетку если заходит на непроходимую, но тут нужна формула учитывающая куда отклонять
$position = $new_position;
//todo увеличить таймаут за пройденные лишние клетки за раз
$object->events->get('move/walk')->resetTime($object->events->get('move/walk')->timeout()*2);
}
// под-шаг не попал в тайл узла, но узел уже в пределах шага — дотягиваемся точно в его центр.
// Иначе на дробной позиции (×.5) banker's-округление next() вечно перешагивает тайл узла
// в обе стороны (4.5↔5.5 → тайлы 4 и 6): array_shift ниже не срабатывает, путь не
// продвигается и NPC бесконечно осциллирует на месте, так и не дойдя до цели.
elseif($position->tile() != $new_position->tile() && $object->position->distance($new_position) <= STEP)
$position = $new_position;
$interrupt();
$object->forward = $forward;
$object->position = Map2D::clearance($position, $object);
// узел пройден (встали в его тайл) — снимаем его из пути; диагональ проходим в два шага
if($object->position->tile() == $new_position->tile())
array_shift($object->buffer['pathFinding']);
$object->action = 'walk';
$object->buffer['walkStep'] = [$intent, $object->position->tile()];
$object->events->add('move/walk', 'to', ['x'=>$data['x'], 'y'=>$data['y'], 'z'=>$data['z'], 'target'=>$target, 'max_distance'=>$maxDistance, 'then'=>$then]);