index

из группы fight/search
повторяется при создании
Поиск цели для сущности вида enemy: ближайший живой игрок в радиусе жизни сущности, которого сущность видит — обзор до игрока не перекрыт преградой. Других сущностей, кроме игроков, такая сущность целью не берёт, поэтому сущности вида enemy между собой не дерутся; игрок на одной клетке с сущностью целью не становится. Цель ограничена домом сущности: при компоненте zone — игрок внутри этой зоны либо стоящий вне её не дальше трёх клеток от сущности; без зоны — игрок в радиусе привязки (параметр leash события блуждания, команда move/randommove/index) вокруг точки появления, к которому при каждом поиске прибавляется случайный запас до половины радиуса; нет ни того ни другого — только радиус жизни. Найденного игрока сущность атакует ближней атакой (fight/melee); эта атака и ведёт сущность к цели. Пока сущность атакует, куда-либо идёт либо мертва, поиск не идёт; обход зоны (команда patrol группы move/randommove) поиск не останавливает.
Цена в кадре
Одно срабатывание: 0.08 + 0.00012 * Math.min(entities + players + foreignAlive, 441) + 0.0008 * (inRadius + targets) * 441 / ((2 * lifeRadiusMax + 1) * (2 * lifeRadiusMax + 1)) мс процессорного времени
Срабатываний в минуту у одной сущности: 120
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Кому доступна
enemy
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

Код команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */

if(
	!$object->events->get('fight/bolt')->action
		&&
	!$object->events->get('fight/melee')->action
		&&
	// Обход зоны держит движение всю дорогу между её областями: занятость им поиск не останавливает, иначе
	// монстр на обходе проходил бы мимо игрока. Прочее движение (бегство, погоня, возврат) поиск ждёт.
	(!$object->events->get('move/walk')->action || ($object->events->get('move/walk')->action === 'to' && $object->events->get('move/randommove')->action === 'patrol'))
		&&
	(!$object->components->isset('hp') || $object->components->get('hp')>0)
)
{
	$tile = $object->position->tile();

	// Фильтр целей по «дому» существа: компонент zone (цель внутри именованной зоны либо вплотную
	// к её границе) приоритетнее радиуса от спавна. Нет зоны либо имя не найдено — radius-leash из
	// move/randommove. Ни того ни другого — цель ограничена только lifeRadius поиска.
	$zone = $object->components->isset('zone') ? $object->components->get('zone') : null;
	$useZone = $zone !== null && Map2D::hasZone($zone);
	$useLeash = !$useZone && $object->events->isset('move/randommove');
	$spawn = null;
	$leashRange = 0;
	if($useLeash)
	{
		$rmData = $object->events->get('move/randommove')->data;
		$spawn = new Position($rmData['spawn_x'], $rmData['spawn_y'], $rmData['spawn_z']);
		$leashRange = $rmData['leash'] + rand(0, (int)($rmData['leash'] / 2));
	}

	// Отступ агро от границы зоны (в клетках): цель вне зоны, но подошедшая к стражу ближе этого —
	// всё равно цель. Иначе страж у края зоны пассивен, пока подошедший вплотную стрелок не ударит
	// (ответка в status/hurt зону игнорирует, но реагировать нужно ДО провокации). Тюнится тут.
	$zoneEdgeAggro = 3;

	// Кандидаты берутся ВСЕ (count: null), а не первый попавшийся: перебор области идёт по клеткам от
	// угла, и «первый найденный» — это цель в углу области, а не ближайшая. Проверка видимости (raycast)
	// здесь не делается — она дорогая, её проходят уже отсортированные по дистанции кандидаты ниже,
	// до первого видимого.
	$candidates = World::filter
	(
		$object->x, $object->y, $object->z
			,
		function(EntityAbstract $gameObject) use($tile, $zone, $useZone, $useLeash, $spawn, $leashRange, $zoneEdgeAggro, $object):bool
		{
			return
				// Цель — только игрок: враждебность прочих существ не проверяется, и монстры дрались бы между собой
				// (решение автора 2026-10-14).
				($gameObject instanceOf Player)
					&&
				$gameObject->components->isset('hp')
					&&
				$gameObject->components->get('hp')>0
					&&
				($gameObject->position->tile() != $tile)
					&&
				($useZone
					? (Map2D::inZone($zone, $gameObject->position) || $object->position->distance($gameObject->position) <= $zoneEdgeAggro)
					: (!$useLeash || $spawn->distance($gameObject->position) <= $leashRange));
		}
			,
		($object->lifeRadius>0?$object->lifeRadius:10)
			,
		null
	);

	if($candidates)
	{
		$distances = [];
		foreach($candidates as $key => $gameObject)
			$distances[$key] = $object->position->distance($gameObject->position);

		asort($distances);

		foreach(array_keys($distances) as $key)
		{
			if($object->position->raycast($candidates[$key]->position))
			{
				$object->events->add('fight/melee', 'index', ['target'=>$key]);
				break;
			}
		}
	}
}
К игре