index

из группы magic/heal
вызывает игрок
Лечение заклинанием себя либо другого игрока. Применение списывает с заклинателя стоимость маны заклинания, откладывает его ближайший шаг на полную паузу между шагами (status/stagger) и ставит тому, кого лечат, восстановление здоровья — команду status/heal/index: как прибавка ложится на здоровье, сказано у неё. Сила лечения задана в коде команды, не параметром. Проверки по порядку (проверки заклинания и их место в этом порядке — в описании параметра spell): - Заклинатель мёртв — ничего не происходит. - Маны не хватает — лечения нет, движение заклинателя не меняется: движение к цели, если шло, продолжается, а игрок, отправивший лечение на ходу, идёт дальше. - Проверки цели — в описании параметра target. - Запас здоровья того, кого лечат, полон — лечения нет, мана не списывается. Собственная команда движения игрока снимает лечение, ждущее повтора; когда именно, сказано в описании move/walk/to.
Цена в кадре
Одно срабатывание: 0.12 мс процессорного времени
Срабатываний в минуту у одной сущности: 2
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
spell обязателен
Какое заклинание применяется — префаб заклинания; из него берётся стоимость маны. У мёртвого заклинателя заклинание не проверяется: его команда ничего не делает и ошибки не даёт. У живого пустое значение либо заклинание, которого нет в его книге заклинаний, — нарушение: игрок, приславший команду, отключается от игры; проверяется оно раньше маны и цели.
target пусто
Ключ игрока-цели на запущенной карте (вида players_1). Пусто либо ключ самого заклинателя — заклинатель лечит себя. Движение игрока такое лечение не трогает: игрок лечится на ходу и идёт дальше. Подход — движение к цели, которое лечение ставит заклинателю, чтобы цель оказалась ближе радиуса жизни заклинателя и на виду по прямой. Исходы лечения другого игрока: - Цели нет на карте — лечения нет; лечение снимается вместе с подходом, если он шёл: заклинатель останавливается. - Цель — не игрок — нарушение: игрок, приславший команду, отключается от игры. - Цель мертва либо стоит дальше радиуса жизни и заклинателя, и самой цели — так же, как при цели, которой нет на карте. - Цель на клетке заклинателя либо ближе его радиуса жизни и видна по прямой — заклинатель поворачивается к ней и лечит; свой подход прекращает. - Цель дальше радиуса жизни заклинателя либо закрыта преградой — заклинатель идёт к ней в обход преград и повторяет лечение, пока не увидит её. - Заклинатель — игрок, а цель стоит на клетке, которую запомнило его движение (описание move/walk/to), — вместо подхода лечение снимается, игрок стоит на месте. Лечение другого игрока и движение заклинателя-игрока: - Лечение повторяется на подходе, а игрок отправил команду движения, которая ещё не исполнилась, — лечение движение не снимает и подходом не заменяет: цель видна — лечит, иначе ждёт следующего повтора. - Лечение, которое игрок отправил сам, и его движение — идущее (по клику в клетку либо подходом прежней атаки) и команда движения, ещё не исполненная: - цели нет на карте, она мертва либо дальше радиуса жизни и игрока, и самой цели — лечения нет, движение отменяется: игрок стоит на месте; - цель на клетке игрока либо ближе его радиуса жизни и видна по прямой — движение остаётся: игрок лечит цель и идёт дальше; - цель дальше радиуса жизни игрока либо за преградой — движение заменяется подходом: игрок идёт к цели и лечит, когда увидит её.
Кому доступна
bot player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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');
К игре