fight/melee0.04 мс процессорного времениMath.min(120, 120 * targets)| Параметр | По умолчанию | Что задаёт |
|---|---|---|
target |
пусто | Ключ цели — сущности либо игрока — на запущенной карте (вида players_1). Пусто — цели нет: атакующий поворачивается в направлении из составляющих x и y и бьёт клетку перед собой. Движение игрока такой удар не трогает: игрок бьёт в эту сторону и идёт дальше.
Подход — движение к цели, которое удар ставит атакующему, чтобы встать рядом и ударить. Исходы удара по цели:
- Цели нет на карте, она мертва, у неё нет компонента здоровья (hp) — сундук и т.п. — либо она стоит дальше радиуса жизни и атакующего, и самой цели — удара нет; удар снимается вместе с подходом, если он шёл: атакующий останавливается.
- Цель на клетке атакующего (в упор) — удар по своей клетке; подход снимается.
- Цель на соседней клетке и видна по прямой — атакующий поворачивается к ней и бьёт; подход снимается.
- Цель дальше соседней клетки либо закрыта преградой — атакующий идёт к ней в обход преград и повторяет удар, пока не встанет рядом.
- Цель видна, но не рядом, а атакующий — не игрок, у которого в книге заклинаний есть атакующее заклинание и маны на него хватает, — вместо подхода он стреляет этим заклинанием (fight/bolt). К цели за преградой идёт и он: снаряд летит по прямой.
- Атакующий — игрок, а цель стоит на клетке, которую запомнило его движение (описание move/walk/to), — вместо подхода удар снимается, игрок стоит на месте.
Удар по цели и движение игрока:
- Удар повторяется на подходе, а игрок отправил команду движения, которая ещё не исполнилась, — удар движение не снимает и подходом не заменяет: цель рядом — бьёт с места, иначе ждёт следующего повтора.
- Удар, который игрок отправил сам, и его движение — идущее (по клику в клетку либо подходом прежней атаки) и команда движения, ещё не исполненная:
- цели нет на карте, она мертва, у неё нет компонента здоровья (hp) либо она дальше радиуса жизни и игрока, и самой цели — удара нет, движение отменяется: игрок стоит на месте;
- цель на клетке игрока либо на соседней клетке и видна по прямой — движение отменяется: игрок стоит и бьёт;
- цель дальше соседней клетки либо за преградой — движение заменяется подходом: игрок идёт к цели и бьёт, встав рядом. |
x |
0 | Составляющая направления удара по оси X, когда цель не указана: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока, приславшего такой удар, отключает от игры. Обе составляющие нулевые — удара нет. |
y |
0 | Составляющая направления удара по оси 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(!$object->components->isset('hp') || $object->components->get('hp')<=0)
return;
// бой в упор: цель на нашей же клетке — сквозное движение (без коллизии существ) штатно даёт наложение
$point_blank = false;
// атака по направлению (без цели)
if(empty($data['target']))
{
if(isset($data['x'], $data['y']) && ($data['x'] || $data['y']))
$object->forward = new Forward($data['x'], $data['y']);
else
return;
}
else
{
// Ждущая команда движения игрока главнее подхода удара: состоявшись, она снимет удар сама (move/walk/to),
// а отбитая оставит его — отказ атомарен. Потому удар её не затирает своим подходом и не снимает: подход
// встанет следующим прогоном удара, когда группа освободится. Такая команда — пришедшая пакетом и ещё
// не исполненная.
$move = $object->events->get('move/walk');
$player_move = !$from_client && $move->action && $move->from_client;
$stopWalk = function() use ($object, $player_move): void
{
if(!$player_move)
$object->events->remove('move/walk');
};
// атака по цели — валидация. Прерванное преследование снимает walk в каждой ветке отдельно:
// безусловный remove тут обнулял бы walk до гейта $walkToTarget и его сравнение не работало бы
if(!World::isset($data['target']))
{
$stopWalk();
return;
}
$target_object = World::get($data['target']);
if(!$target_object->components->isset('hp') || $target_object->components->get('hp')==0)
{
$stopWalk();
return;
}
if($target_object->position->tile() == $object->position->tile())
{
// в упор бьём свою клетку; forward не трогаем (направление на цель с той же клетки не вычислить)
$stopWalk();
$point_blank = true;
}
else
{
$distance = $object->position->distance($target_object->position);
if($distance>$object->lifeRadius && $distance>$target_object->lifeRadius)
{
$stopWalk();
return;
}
// перевесить walk-преследование только если цель сменила тайл: walk 'to' persist и сам себя
// поддерживает, а re-add того же маршрута каждый тик атаки лишь пересоздаёт событие
// и рассылает пакеты; путь walk и так кеширует по целевому тайлу
$walkToTarget = function() use ($object, $target_object, $move, $player_move): void
{
if($player_move)
return;
if($move->action == 'to'
&&
isset($move->data['x'], $move->data['y'])
&&
(new Position((float)$move->data['x'], (float)$move->data['y'], is_numeric($move->data['z'] ?? null) ? (float)$move->data['z'] : null))->tile() == $target_object->position->tile())
return;
$object->events->add('move/walk', 'to', ['x'=>$target_object->position->x, 'y'=>$target_object->position->y, 'z'=>$target_object->position->z]);
};
// Игрок: движение сняло себя, не найдя пути к клетке, где цель стоит сейчас (отметка «маршрута нет»,
// move/walk/to), — атака снимается, как подход к контейнеру и вещи: повтор лишь искал бы путь каждым ударом.
// Цель перешла на другую клетку — новый подход. Проверяется лишь там, где нужен новый подход: дошедший до
// соседней клетки бьёт. Моба это не касается: его поиск целей выбрал бы ту же цель снова, и поиск пути
// не стал бы реже (решение автора 2026-10-10).
// «Маршрута нет» — отметка самого движения, а не пустая группа: её оставляет и отбитая команда движения
// игрока, и атака после неё не снимается — отказ атомарен.
$stuck = $object instanceof Player && !$move->action && isset($object->buffer['walkNoRoute']) && $object->buffer['walkNoRoute'] === $target_object->position->tile();
// проверим видимость цели (raycast)
if(!$object->position->raycast($target_object->position))
{
if($stuck)
return;
// Цель не видна — идём к ней и повторяем удар: прямой видимости нет, а маршрут строит поиск
// пути и огибает преграду. Ветка общая игроку и NPC: выбранная цель плюс удар значат
// «подойти и ударить» независимо от того, видна ли цель по прямой. Магия тут недоступна
// даже NPC: снаряд летит по прямой и в преграду упрётся
$walkToTarget();
$object->events->add('fight/melee', 'index', ['target'=>$data['target']]);
return;
}
$forward = $object->position->forward($target_object->position);
// не рядом — подойти и повторить
if($object->position->next($forward)->tile() != $target_object->position->tile())
{
// Заклинание вместо подхода — только НЕ игроку: игрок нажал слот рукопашной сам, и подмена
// удара магией тратит ему ману на то, чего он не выбирал. NPC так достаёт далёкую цель.
$magic = '';
if(!($object instanceof Player) && $object->components->isset('spell_book') && $object->components->isset('mp'))
{
$object_spells = $object->components->get('spell_book');
$currentMp = $object->components->get('mp');
$bolts = ['firebolt', 'icebolt', 'lightbolt'];
shuffle($bolts);
foreach($bolts as $spell)
{
if(!isset($object_spells[$spell]))
continue;
$prefab = World::prefabGet($spell, 'spell');
if($currentMp >= $prefab['component']['mp_cost'])
{
$magic = $spell;
break;
}
}
}
if($magic)
{
$object->events->remove('move/walk');
$object->events->add('fight/bolt', 'index', ['spell'=>$magic, 'target'=>$data['target']]);
}
elseif($stuck)
return;
else
{
$walkToTarget();
$object->events->add('fight/melee', 'index', ['target'=>$data['target']]);
}
return;
}
$object->forward = $forward;
// рядом — бьём с места, преследование больше не нужно
$stopWalk();
}
}
// удар (общий код для всех веток); в упор — по своей клетке, иначе — по клетке перед собой
$object->action = 'attack';
$object->events->add('status/stagger', 'index');
$target_position = $point_blank ? $object->position : $object->position->next($object->forward);
if(
$gameObjects = World::filter
(
$target_position->x, $target_position->y, $target_position->z
,
function(EntityAbstract $gameObject) use ($object):bool
{
// себя не бьём: при ударе по своей клетке (в упор) атакующий тоже в выборке
return $gameObject->key != $object->key && $gameObject->components->isset('hp') && $gameObject->components->get('hp')>0;
}
,
count: null
)
)
{
foreach($gameObjects as $gameObject)
{
$gameObject->events->push('status/hurt', 'index', ['hp'=>1, 'from'=>$object->key]);
}
}
// NPC продолжают атаковать
if(!($object instanceOf Player) && !empty($data['target']))
$object->events->add('fight/melee', 'index', ['target'=>$data['target']]);