magic/heal0.12 мс процессорного времени2| Параметр | По умолчанию | Что задаёт |
|---|---|---|
spell |
обязателен | Какое заклинание применяется — префаб заклинания; из него берётся стоимость маны. У мёртвого заклинателя заклинание не проверяется: его команда ничего не делает и ошибки не даёт. У живого пустое значение либо заклинание, которого нет в его книге заклинаний, — нарушение: игрок, приславший команду, отключается от игры; проверяется оно раньше маны и цели. |
target |
пусто | Ключ игрока-цели на запущенной карте (вида players_1). Пусто либо ключ самого заклинателя — заклинатель лечит себя. Движение игрока такое лечение не трогает: игрок лечится на ходу и идёт дальше.
Подход — движение к цели, которое лечение ставит заклинателю, чтобы цель оказалась ближе радиуса жизни заклинателя и на виду по прямой. Исходы лечения другого игрока:
- Цели нет на карте — лечения нет; лечение снимается вместе с подходом, если он шёл: заклинатель останавливается.
- Цель — не игрок — нарушение: игрок, приславший команду, отключается от игры.
- Цель мертва либо стоит дальше радиуса жизни и заклинателя, и самой цели — так же, как при цели, которой нет на карте.
- Цель на клетке заклинателя либо ближе его радиуса жизни и видна по прямой — заклинатель поворачивается к ней и лечит; свой подход прекращает.
- Цель дальше радиуса жизни заклинателя либо закрыта преградой — заклинатель идёт к ней в обход преград и повторяет лечение, пока не увидит её.
- Заклинатель — игрок, а цель стоит на клетке, которую запомнило его движение (описание move/walk/to), — вместо подхода лечение снимается, игрок стоит на месте.
Лечение другого игрока и движение заклинателя-игрока:
- Лечение повторяется на подходе, а игрок отправил команду движения, которая ещё не исполнилась, — лечение движение не снимает и подходом не заменяет: цель видна — лечит, иначе ждёт следующего повтора.
- Лечение, которое игрок отправил сам, и его движение — идущее (по клику в клетку либо подходом прежней атаки) и команда движения, ещё не исполненная:
- цели нет на карте, она мертва либо дальше радиуса жизни и игрока, и самой цели — лечения нет, движение отменяется: игрок стоит на месте;
- цель на клетке игрока либо ближе его радиуса жизни и видна по прямой — движение остаётся: игрок лечит цель и идёт дальше;
- цель дальше радиуса жизни игрока либо за преградой — движение заменяется подходом: игрок идёт к цели и лечит, когда увидит её. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
// Сколько очков здоровья возвращает заклинание — там же, где у атаки задан урон снаряда: в коде самой механики
$heal = 5;
if(!$object->components->isset('hp') || $object->components->get('hp')<=0)
return;
// Клиент шлёт лечение только заклинанием из книги, повтор после подхода несёт то же заклинание:
// пустое приходит лишь от неверного клиента — нарушение, не исход механики.
if(empty($data['spell']))
throw new Exception('заклинание лечения не указано — клиент не должен был слать команду (magic/heal/index)');
$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;
// цель не указана либо указан сам заклинатель — лечим себя
$target_object = $object;
if(!empty($data['target']) && $data['target'] != $object->key)
{
// Ждущая команда движения игрока главнее подхода лечения: состоявшись, она снимет лечение сама
// (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 instanceof Player))
throw new Exception('цель лечения '.$target_object->key.' не игрок — клиент не должен был слать команду (magic/heal/index)');
if(!$target_object->components->isset('hp') || $target_object->components->get('hp')<=0)
{
$stopWalk();
return;
}
$distance = $object->position->distance($target_object->position);
if($distance>$object->lifeRadius && $distance>$target_object->lifeRadius)
{
$stopWalk();
return;
}
// в упор преграде взяться неоткуда, луч туда не гоняем
$success = !$distance;
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('magic/heal', '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('magic/heal', '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');
// Цель на своей клетке: направление на неё не вычислить (Position::forward бросает), разворот не нужен.
if($target_object->position->tile() != $object->position->tile())
$object->forward = $object->position->forward($target_object->position);
}
// полный запас — лечить нечего: ману за пустое действие не берём (клиент гасит заклинание тем же признаком)
if($target_object->components->get('hp') >= $target_object->components->get('hp_max'))
return;
$object->components->add('mp', $current - $cost);
// прибавляет запас сама цель: только у неё актуально текущее здоровье на момент применения
$target_object->events->push('status/heal', 'index', ['hp'=>$heal]);
$object->events->add('status/stagger', 'index');