fight/bolt0.15 мс процессорного времениMath.min(120, 120 * targets)| Параметр | По умолчанию | Что задаёт |
|---|---|---|
target |
пусто | Ключ цели — сущности, игрока в том числе, — на запущенной карте (вида players_1). Пусто — цели нет: стрелок поворачивается в направлении из составляющих x и y и стреляет. Движение игрока такой выстрел не трогает: игрок стреляет в эту сторону и идёт дальше.
Подход — движение к цели, которое выстрел ставит стрелку, чтобы цель оказалась в пределах выстрела. Исходы выстрела по цели:
- Цели нет на карте, она мертва, у неё нет компонента здоровья (hp) — сундук и т.п. — либо она стоит дальше радиуса жизни и стрелка, и самой цели — выстрела нет; выстрел снимается вместе с подходом, если он шёл: стрелок останавливается.
- Цель на клетке стрелка — выстрела нет: в упор заклинанием не бьют; подход, если шёл, продолжается.
- Цель ближе радиуса жизни стрелка и видна по прямой — стрелок поворачивается к ней и стреляет; свой подход прекращает.
- Цель дальше радиуса жизни стрелка либо закрыта преградой — стрелок идёт к ней в обход преград и повторяет выстрел, пока не увидит её.
- Стрелок — игрок, а цель стоит на клетке, которую запомнило его движение (описание move/walk/to), — вместо подхода выстрел снимается, игрок стоит на месте.
Выстрел по цели и движение игрока:
- Выстрел повторяется на подходе, а игрок отправил команду движения, которая ещё не исполнилась, — выстрел движение не снимает и подходом не заменяет: цель видна — стреляет, иначе ждёт следующего повтора.
- Выстрел, который игрок отправил сам, и его движение — идущее (по клику в клетку либо подходом прежней атаки) и команда движения, ещё не исполненная:
- цели нет на карте, она мертва, у неё нет компонента здоровья (hp) либо она дальше радиуса жизни и игрока, и самой цели — выстрела нет, движение отменяется: игрок стоит на месте;
- цель на клетке игрока — выстрела нет, движение остаётся: игрок идёт дальше;
- цель ближе радиуса жизни игрока и видна по прямой — движение остаётся: игрок стреляет и идёт дальше;
- цель дальше радиуса жизни игрока либо за преградой — движение заменяется подходом: игрок идёт к цели и стреляет, когда увидит её. |
x |
0 | Составляющая направления выстрела по оси X, когда цель не указана: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока, приславшего такой выстрел, отключает от игры. Обе составляющие нулевые — выстрела нет. |
y |
0 | Составляющая направления выстрела по оси Y, когда цель не указана: это вектор направления, а не точка на карте. Каждая составляющая — от -1 до 1, а длина вектора не больше единицы: по диагонали это около 0.7 по каждой оси, не 1. Составляющая вне -1…1 либо длина вектора больше единицы (сверх погрешности округления) — ошибка: игрока, приславшего такой выстрел, отключает от игры. Обе составляющие нулевые — выстрела нет. |
spell |
обязателен | Какое заклинание применяется — префаб заклинания; из него берётся и стоимость маны. Пустое значение — ошибка, и проверяется оно первым, раньше того, жив ли стрелок: клиент игры пустым его не шлёт, а код механик ставит выстрел всегда со своим заклинанием. Заклинания нет в книге заклинаний стрелка — тоже ошибка, но проверяется она после того, жив ли стрелок: у мёртвого её нет. Обе проверки идут раньше маны и цели. Игрока, приславшего выстрел с такой ошибкой, отключает от игры. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
// Пустое заклинание верный клиент не шлёт, а код игры ставит выстрел всегда со своим заклинанием:
// пришедший без него выстрел — нарушение, не гонка, и у мёртвого тоже.
if(empty($data['spell']))
throw new Error('не указано заклинание выстрела (fight/bolt/index)');
if(!$object->components->isset('hp') || $object->components->get('hp')<=0)
return;
$object_spells = $object->components->get('spell_book');
if(empty($object_spells[$data['spell']]))
throw new Exception('не найдено заклинание '.$data['spell']);
$prefab = World::prefabGet($data['spell'], 'spell');
$cost = $prefab['component']['mp_cost'];
$current = $object->components->get('mp');
if($current < $cost)
return;
// стрельба по направлению (без цели)
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;
// Цель исчезла, мертва либо ушла за радиусы — выстрел снимает и свой подход, как удар (fight/melee/index):
// иначе игрок доходил бы до клетки, где цель стояла (решение автора 2026-11-02).
$stopWalk = function() use ($object, $player_move): void
{
if(!$player_move)
$object->events->remove('move/walk');
};
// стрельба по цели — валидация
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())
return;
$distance = $object->position->distance($target_object->position);
if($distance>$object->lifeRadius && $distance>$target_object->lifeRadius)
{
$stopWalk();
return;
}
$forward = $object->position->forward($target_object->position);
// проверим видимость цели (raycast)
$success = false;
if($distance && $distance < ($object->lifeRadius>0?$object->lifeRadius:10))
$success = $object->position->raycast($target_object->position);
if(!$success)
{
// Ждущая команда движения игрока: выстрел ждёт следующего прогона, как подход удара (fight/melee/index).
if($player_move)
{
$object->events->add('fight/bolt', 'index', ['spell'=>$data['spell'], 'target'=>$data['target']]);
return;
}
// Игрок: движение сняло себя, не найдя пути к клетке, где цель стоит сейчас, либо отбито пределом дальности
// клика (отметка «маршрута нет», move/walk/to). Выстрел снимается, как удар (fight/melee/index): повтор лишь
// искал бы путь каждым прогоном (решение автора 2026-11-02).
if($object instanceof Player && !$move->action && isset($object->buffer['walkNoRoute']) && $object->buffer['walkNoRoute'] === $target_object->position->tile())
return;
// не в радиусе — подойти и повторить
$object->events->remove('move/walk');
$object->events->add('move/walk', 'to', ['x'=>$target_object->position->x, 'y'=>$target_object->position->y, 'z'=>$target_object->position->z]);
$object->events->add('fight/bolt', 'index', ['spell'=>$data['spell'], 'target'=>$data['target']]);
return;
}
// Подход дал видимость — дальше не идём: ход до клетки цели после выстрела ставил стрелка на её клетку,
// откуда выстрел уже не уходит. Снимается лишь свой подход: движение, отданное игроком
// пакетом, не трогаем.
$walk = $object->events->get('move/walk');
if(!$from_client && !$walk->from_client)
$object->events->remove('move/walk');
$object->forward = $forward;
}
// выстрел (общий код для обоих веток)
$object->action = 'attack';
$object->components->add('mp', $current - $cost);
$new_object = World::add($data['spell'], [
'lifeRadius' => $object->lifeRadius?:1,
'map' => MAP_ID,
'action' => 'walk',
'forwardX' => $object->forward->x,
'forwardY' => $object->forward->y,
'forwardZ' => $object->forward->z,
'x' => $object->position->x,
'y' => $object->position->y,
'z' => $object->position->z,
'components'=>['speed'=>5, 'owner'=>$object->key],
]);
$new_object->events->add('status/collision', 'bolt');
$new_object->events->add('move/walk', 'kamikadze');
$object->events->add('status/stagger', 'index');
// NPC продолжают атаковать
if(!($object instanceOf Player) && !empty($data['target']))
$object->events->add('fight/bolt', 'index', ['spell'=>$data['spell'], 'target'=>$data['target']]);