index

из группы move/randommove
повторяется
Блуждание сущности: сущность шагает на случайную свободную соседнюю клетку, в том числе по диагонали, — проходимую и без живой сущности на ней, игрока в том числе. Шаг не уводит сущность из дома. Дом — её зона: области зоны с именем, которое стоит у сущности в компоненте zone (область зоны — объект с площадью на слое объектов карты), а у сущности без зоны — клетки в радиусе привязки (параметр leash) вокруг точки появления. Сущность, оказавшаяся за своей зоной, не блуждает, а идёт к ближайшей к ней точке области зоны — ближайшей по расстоянию на карте, без учёта преград и пути до неё; точка области зоны — проходимая клетка области зоны, ближайшая к центру этой области зоны. Сущность с нулём здоровья и меньше не блуждает. После каждого срабатывания событие ждёт у живой и ничем не занятой сущности одну, две либо три паузы группы move/randommove — число выпадает случайно, а у сущности, занятой ближней атакой (группа fight/melee) либо движением (группа move/walk), и у мёртвой — одну паузу группы.
Цена в кадре
Одно срабатывание: 0.1 мс процессорного времени
Срабатываний в минуту у одной сущности: 45
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 4
Параметр По умолчанию Что задаёт
leash 10
Радиус привязки к точке появления в клетках — насколько далеко от точки появления сущности позволено уходить и брать цели; к радиусу добавляется случайная надбавка до его половины, чтобы сущности поворачивали назад на разном удалении от точки появления, а не все на одной границе. Действует, когда у сущности нет зоны (компонент zone). Радиус задают здесь, а действует он и на шаг (команда move/walk/index), и на поиск цели (группа команд fight/search).
spawn_x обязателен
Координата точки появления по оси X в клетках карты. От этой точки отсчитывается радиус привязки (параметр leash), и к ней сущность идёт назад, когда шаг увёл бы её дальше этого радиуса.
spawn_y обязателен
Координата точки появления по оси Y в клетках карты. От этой точки отсчитывается радиус привязки (параметр leash), и к ней сущность идёт назад, когда шаг увёл бы её дальше этого радиуса.
spawn_z обязателен Координата точки появления по оси Z — этаж карты, на котором стоит эта точка.
Кому доступна
bot enemy
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

if(!$object->events->get('fight/melee')->action && !$object->events->get('move/walk')->action && (!$object->components->isset('hp') || $object->components->get('hp')>0))
{
	$zone = $object->components->isset('zone') ? $object->components->get('zone') : null;
	$useZone = $zone !== null && Map2D::hasZone($zone);

	// вытолкнули/оказался вне своей зоны — идём к ближайшей её области, не блуждаем
	if($useZone && !Map2D::inZone($zone, $object->position))
	{
		if($home = Map2D::nearestZonePoint($zone, $object->position))
			$object->events->add('move/walk', 'to', ['x'=>$home->x, 'y'=>$home->y, 'z'=>$home->z]);
	}
	// если есть куда идти
	elseif($tiles = Map2D::getTile($object->position->tile()))
	{
		$keys = array_keys($tiles);
		shuffle($keys);

		foreach($keys as $tile_key)
		{
			// зона: не выбираем клетку за пределами своей области
			if($useZone)
			{
				$zc = explode(Position::DELIMETR, $tile_key);
				if(!Map2D::inZone($zone, new Position((float)$zc[0], (float)$zc[1], (float)$zc[2])))
					continue;
			}

			// Клетка соседней карты в матрице есть, но существу, которое держится своей карты, она стена.
			$tile_coords = explode(Position::DELIMETR, $tile_key);
			if(!Map2D::isPassable(new Position(...$tile_coords), $object))
				continue;

			if(!World::filter(
				$tile_coords[0], $tile_coords[1], $tile_coords[2],
				static function(EntityAbstract $gameObject) use($object): bool
				{
					return $gameObject->key != $object->key
						&& $gameObject->components->isset('hp')
						&& $gameObject->components->get('hp') > 0
						&& (!($gameObject instanceof Player) || !($object instanceof Player));
				}
			))
			{
				$forward = $object->position->forward(new Position(...explode(Position::DELIMETR, $tile_key)));
				$object->events->add('move/walk', 'index', ['x'=>$forward->x, 'y'=>$forward->y]);
				break;
			}
		}
	}

	$object->events->get('move/randommove')->resetTime(rand(1, 3) * $object->events->get('move/randommove')->timeout());
}
К игре