index

из группы fight/bolt
вызывает игрок
Атака заклинанием: выстрел по указанной цели либо в заданном направлении. Выстрел урона сразу не наносит: он списывает со стрелка стоимость маны заклинания, откладывает ближайший шаг стрелка на полную паузу между шагами (status/stagger) и выпускает с его клетки снаряд-сущность в ту сторону, куда стрелок повернулся. Снаряд летит сам, бьёт того, в кого врежется (status/collision/bolt, move/walk/kamikadze), и несёт ключ стрелка (компонент owner): стрелка снаряд не задевает, а урон попавшего снаряда числится от стрелка (параметр from команды status/hurt/index). Проверки по порядку (проверки заклинания и их место в этом порядке — в описании параметра spell): - Стрелок мёртв — ничего не происходит. - Маны не хватает — выстрела нет, движение стрелка не меняется: движение к цели, если шло, продолжается, а игрок, отправивший выстрел на ходу, идёт дальше. Не-игрок, стреляющий по цели, ставит себе следующий выстрел сам: серия идёт, пока обе стороны живы, цель на карте и не дальше радиуса жизни стрелка либо самой цели, маны хватает, а стрелок не побежал от ран. Игроку каждый выстрел ставит его собственная команда. Собственная команда движения игрока снимает выстрел, ждущий повтора; в каких случаях — в описании move/walk/to.
Цена в кадре
Одно срабатывание: 0.15 мс процессорного времени
Срабатываний в минуту у одной сущности: Math.min(120, 120 * targets)
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 4
Параметр По умолчанию Что задаёт
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 обязателен
Какое заклинание применяется — префаб заклинания; из него берётся и стоимость маны. Пустое значение — ошибка, и проверяется оно первым, раньше того, жив ли стрелок: клиент игры пустым его не шлёт, а код механик ставит выстрел всегда со своим заклинанием. Заклинания нет в книге заклинаний стрелка — тоже ошибка, но проверяется она после того, жив ли стрелок: у мёртвого её нет. Обе проверки идут раньше маны и цели. Игрока, приславшего выстрел с такой ошибкой, отключает от игры.
Кому доступна
bot enemy animal player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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']]);
К игре