index

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