bolt

из группы status/collision
повторяется
Удар снаряда: снаряд ищет вокруг себя, в радиусе distance, живые сущности, игроков в том числе, кроме своего владельца (компонент owner), — и каждой найденной, но не больше count, наносит урон от имени владельца (команда status/hurt/index); сила урона задана в коде команды. Попав, снаряд останавливается в клетке цели и снимается с карты. Событие ставит снаряду механика, которая его выпускает (образец — группа fight/bolt).
Цена в кадре
Одно срабатывание: 0.04 мс процессорного времени
Срабатываний в минуту у одной сущности: 60 * fps
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
count 1
Сколько подходящих сущностей набрать, прежде чем перебор оборвётся: 1 — снаряд поражает первую же и дальше не смотрит. Пусто либо ноль — перебираются все, кто попал в радиус.
distance 0 Радиус проверки столкновений вокруг снаряда в клетках: 0 — только клетка, где снаряд сейчас, 1 — квадрат 3×3 вокруг неё и так далее.
Кому доступна
item spell object portal
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

// укажем что должно произойти если столкнулись
// вот так элегантно можно оправлять строковые версии кода которые после превратятся в замыкания (мы в php вызовем eval  в событии onCollision)
// и на постоянные события (что будут в бд писаться)  пригодиться что бы сохранять (тк уже созданное Closure и не в бд не передать не в другую локацию)

World::filter($object->x, $object->y, $object->z, static function(EntityAbstract $target) use($object):bool
{
	if(
		$target->components->isset("hp")
			&&
		$target->components->get("hp")>0
			&&
		$target->key != $object->components->get("owner")
	)
	{
		$target->events->push("status/hurt", "index", ["from"=>$object->components->get("owner"), "hp"=>1]);
		$object->events->remove("move/walk");

		// отложенно удалим наш объект что бы он успел пролететь до цели
		$object->position = $target->position;				// и сразу установим позицию точную попадания
		$object->remove();									// уничтожим наш фаербол тк было столкновение на следующем кадре

		return true;
	}
	else
		return false;

}, $data['distance'], $data['count']);
К игре