flee

из группы move/walk
повторяется
Бегство от угрозы: сущность шагает прочь от названной цели, пока не оторвётся на заданное расстояние либо не восстановит здоровье выше своего порога бегства (компонент flee). Упёршись в преграду, пробует отклонения от прямого направления, чтобы не замереть в углу. Событие ставит сущности нанесение урона (команда status/hurt/index), когда здоровье падает до порога бегства либо ниже; командой игрока его не поставить. Бегство и обычное движение — одна группа (move/walk), поэтому бегство сменяет погоню, а блуждание (группа move/randommove) на время бегства ждёт.
Цена в кадре
Одно срабатывание: 0.06 мс процессорного времени
Срабатываний в минуту у одной сущности: 150
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
target пусто Ключ сущности на запущенной карте — игрока либо иной, — от которой бежит сущность с событием бегства.
range 12 На сколько клеток нужно оторваться, чтобы перестать бежать.
Кому доступна
bot enemy spell animal player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

// Все несходимости тут — исходы механики (цель ушла, умерла, уехала на соседнюю карту): выходим тихо.
// Исключение здесь НЕЛЬЗЯ — событие исполняется на НЕ-игроке, а для него ошибка события роняет сервер.
$target = $data['target'];

if(!$target || !World::isset($target))
{
	$object->events->remove('move/walk');
	return;
}

$enemy = World::get($target);
$distance = $object->position->distance($enemy->position);

$hp = $object->components->isset('hp') ? $object->components->get('hp') : 0;
$hp_max = $object->components->isset('hp_max') ? $object->components->get('hp_max') : 0;
$threshold = $object->components->isset('flee') ? (float)$object->components->get('flee') : 0;

// оторвались, отдышались либо угроза мертва — бежать больше не от кого
$enemy_hp = $enemy->components->isset('hp') ? $enemy->components->get('hp') : 1;
if($distance > (float)$data['range'] || $enemy_hp <= 0 || ($hp_max > 0 && $threshold > 0 && $hp > $hp_max * $threshold))
{
	$object->events->remove('move/walk');
	return;
}

// Направление ОТ угрозы. Стоя с ней на одной клетке, направление не вычислить — берём куда смотрим.
if($enemy->position->tile() == $object->position->tile())
	$away = $object->forward;
else
	$away = $enemy->position->forward($object->position);

// Прямо прочь, а если там преграда — всё большими отклонениями в обе стороны: загнанное в угол
// существо должно пытаться выкрутиться, а не долбиться в стену до смерти.
$ax = $away->x;
$ay = $away->y;
$variants = [
	[$ax, $ay],
	[$ax != 0 ? $ax : 1, $ay != 0 ? 0 : 1],
	[$ax != 0 ? 0 : -1, $ay != 0 ? $ay : -1],
	[-$ay, $ax],
	[$ay, -$ax],
];

foreach($variants as $variant)
{
	if($variant[0] == 0 && $variant[1] == 0)
		continue;

	$forward = new Forward($variant[0], $variant[1]);
	$position = $object->position->next($forward);

	if(!Map2D::isPassable($position, $object))
		continue;

	$object->forward = $forward;
	$object->position = Map2D::clearance($position, $object);
	$object->action = 'walk';
	return;
}

// Со всех сторон преграды — бежать некуда, дальше существо дерётся.
$object->events->remove('move/walk');
К игре