index

из группы status/hurt
Нанесение урона сущности, игроку в том числе. Уменьшает здоровье (компонент hp), откладывает ближайший шаг пострадавшего на полную паузу между шагами (группа status/stagger) и копит вклад урона по атакующим игрокам — по нему команда смерти status/dead/index решает, кого и в каком порядке допускать к добыче; у самого пострадавшего-игрока вклад урона не копится вовсе — добычи у игрока не бывает. Здесь же решается реакция пострадавшего на боль: ответный удар, зов сородичей вокруг на обидчика-игрока (компонент assist) и бегство при падении здоровья до своего порога либо ниже (компонент flee). Ответный удар — ближняя атака по обидчику, ставится при четырёх условиях сразу: пострадавший сам ещё никого не атакует — ни ближней атакой, ни заклинанием; один из двоих игрок, а другой нет (игрок отвечает не-игроку, не-игрок — игроку; игрок игроку и не-игрок не-игроку не отвечают); у пострадавшего включена настройка «Авто ответ на атаку» (у кого настроек нет вовсе — отвечает всегда); пострадавший-игрок не идёт — у него нет движения группы move/walk. Идущему игроку удар не ставится, потому что ходьба игрока — всегда его выбор (клик по карте, подход к сундуку либо вещи), а удар снял бы её либо увёл игрока к напавшему; остановившись, игрок ответит на следующий удар. Вместе с самоповтором удара у не-игрока (fight/melee) это значит, что начатый бой поддерживает себя сам до чьей-то смерти или бегства — слать команды каждый раз не нужно. Сущность, задетая ударом другой сущности, не игрока (сосед на клетке удара сущности вида enemy), не отвечает и сородичей не зовёт.
Цена в кадре
Одно срабатывание: 0.08 + 0.00012 * Math.min(entities + players + foreignAlive, 169) мс процессорного времени
Срабатываний в минуту у одной сущности: Math.min(60, 60 * targets)
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
from пусто
Ключ сущности, нанёсшей урон, на запущенной карте (вида players_1): по нему копится вклад урона (учитываются только игроки) и включается ответный удар пострадавшего. Пусто — урон ничей.
hp обязателен Сколько очков здоровья снять: положительное число, больше текущего запаса срезается до остатка. Ноль и меньше — ничего не происходит.
Кому доступна
bot enemy animal player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

if($data['hp']>0)
{
	$current_hp = $object->components->get('hp');

	// Удар, вставший в очередь за смертельным ударом того же кадра (EventCollection::push), исполняется уже
	// на теле: мёртвого не ранят — ни действия «hurt» поверх смерти, ни вклада в очередь на добычу.
	if($current_hp <= 0)
		return;
	if($data['hp'] > $current_hp)
		$data['hp'] = $current_hp;

	$object->action = 'hurt';																// укажем событие для анимации

	// остановим (застагерим) при попадании	объект в который попали.
	//тк они могу выполнятся в следующем кадре одновременно и тем самым игрока анимация не будет доступна на клиенте
	$object->events->add('status/stagger', 'index');

	// Вклад урона по атакующим — основа права на добычу (см. status/dead): труп достаётся
	// нанёсшему больше всего, а не добившему — иначе чужой игрок добивает чужого моба и забирает всё.
	// В зачёт только игроки: добыча адресуется игроку, урон от NPC владельца не даёт.
	// У самого пострадавшего-игрока вклад не копится: добычи у игрока не бывает, очередь строить не из чего и не для кого.
	// buffer не рассылается и не сохраняется, живёт до воскрешения (там же чистится).
	if(!($object instanceof Player) && $data['from'] && World::isset($data['from']) && (World::get($data['from']) instanceof Player))
		$object->buffer['damage'][$data['from']] = ($object->buffer['damage'][$data['from']] ?? 0) + $data['hp'];

	$total = $current_hp - $data['hp'];
	$object->components->add('hp', $total);													// отнимим жизни

	if($total && $data['from'] && World::isset($data['from']) && (!$object->components->isset('settings') || $object->components->get('settings')['autoattack']))
	{
		$gameObject = World::get($data['from']);
		// Ответ ударом — лишь между игроком и не-игроком: класс, которым код входа создаёт вид, исхода не решает.
		// Занятый любой атакой — ближней либо заклинанием — продолжает свою, как в зове сородичей ниже (решения автора 2026-10-14).
		// Идущего игрока автоответ не трогает: ходьба игрока — всегда его выбор (клик, следование, подход к сундуку
		// либо вещи), а удар снял бы её либо увёл к напавшему (решение автора 2026-11-02). Остановился — ответит
		// на следующий удар.
		if(($object instanceof Player) != ($gameObject instanceof Player) && !($object instanceof Player && $object->events->get('move/walk')->action))
		{
			if(empty($object->events->get('fight/melee')->action) && empty($object->events->get('fight/bolt')->action)) 							// если не атакуем никого то начнем атаковать того кто в нас ранит рукопашкой
				$object->events->add('fight/melee', 'index', ['target'=>$data['from']]);
		}
	}

	// Зов сородичей: бить одного в толпе безнаказанно — главная поддавка против стайных существ.
	// Зовём только свой вид и только свободных от боя: занятому смена цели ломала бы его собственную схватку.
	// Соседи С ДРУГОЙ карты пропускаются — ими распоряжается их собственный сервер.
	// Зов поднимает лишь на игрока: удар монстра по клетке задевает соседа-монстра, и стая иначе встала бы на своего
	// (решение автора 2026-10-14).
	if($total > 0 && $data['from'] && World::isset($data['from']) && (World::get($data['from']) instanceof Player) && !($object instanceof Player)
		&& $object->components->isset('assist') && ($assist = (float)$object->components->get('assist')) > 0)
	{
		$kind = $object->kind;
		$attacker = $data['from'];

		$helpers = World::filter
		(
			$object->x, $object->y, $object->z,
			static function(EntityAbstract $neighbour) use($object, $kind): bool
			{
				return $neighbour->key != $object->key
					&& $neighbour->kind === $kind
					&& $neighbour->map == MAP_ID
					&& $neighbour->components->isset('hp')
					&& $neighbour->components->get('hp') > 0
					&& !$neighbour->events->get('fight/melee')->action
					&& !$neighbour->events->get('fight/bolt')->action;
			},
			$assist,
			null
		);

		foreach($helpers as $helper)
			$helper->events->add('fight/melee', 'index', ['target' => $attacker]);
	}

	// Бегство: оставшись ниже своего порога, существо бросает бой и уходит. Ставится ПОСЛЕ ответного
	// удара и зова — чтобы перебить их у самого раненого, но оставить поднятой стаю.
	if($total > 0 && !($object instanceof Player) && $data['from'] && World::isset($data['from'])
		&& $object->components->isset('flee') && $object->components->isset('hp_max'))
	{
		$threshold = (float)$object->components->get('flee');
		$hp_max = (float)$object->components->get('hp_max');

		if($threshold > 0 && $hp_max > 0 && $total <= $hp_max * $threshold)
		{
			$object->events->remove('fight/melee');
			$object->events->remove('fight/bolt');
			$object->events->add('move/walk', 'flee', ['target' => $data['from']]);
		}
	}
}
К игре