index

из группы status/dead
Обработка смерти сущности, игрока в том числе. Когда здоровье (компонент hp) падает до нуля, команда ставит действие dead, останавливает движение и сдвигает тело от центра клетки смерти на случайное смещение, не уводя из этой клетки. Сущности, появившейся на карте уже мёртвой (событие ей ставит код входа — поле игры «Code in»), ставится только действие: смерть не наступает — состояние восстанавливается, тело остаётся там, где положено записью, добыча у неё от прошлой смерти. Событие ставится при каждом обнулении здоровья, а добыча разыгрывается и записывается лишь в миг смерти: повторная обработка уже мёртвого тела состава не перебрасывает. В миг смерти у сущности с таблицей добычи (loot_table) команда разыгрывает добычу: выпало непустое и сущность кто-то бил — допускает к добыче первого по вкладу урона и заводит отсчёт до допуска следующего (status/lootfree). Пусто либо урона никто не наносил — ни допуска, ни отсчёта: добыча открыта любому. Сам состав записывается в миг смерти у того, кому добыча положена по виду сущности, — пустой в том числе. Выпавшее ложится в тело по порядку розыгрыша; разных вещей в теле не больше предела — сколько ячеек в умолчании компонента inventory (поле «По умолчанию»), — и выпавшее сверх него пропадает, на землю не ложится. Телу, которому не досталось ничего, эта команда сразу сжимает срок снятия с карты: оно не лежит полный срок наравне с тем, в котором есть что взять. Телу, опустевшему после выноса последней вещи, срок сжимает компонент добычи (loot); длительность сжатия и зачем она такая — в его описании. Часть выпавшего не попадает в тело, а падает на землю отдельными вещами: их берёт любой подошедший, допуск к добыче их не касается. Шанс обратен ценности вещи: дешёвое разлетается часто, дорогое почти всегда достаётся бившим; у валюты торговой цены нет, и расчёт берёт её номинал, поэтому монеты рассыпаются наравне с прочим. На землю падает часть количества, остаток ложится в тело. Кладётся всё на клетку тела — развести вещи по свободным соседним клеткам и разбросать внутри клетки берёт на себя код входа, он же ставит срок снятия с карты: правило одно на все механики, роняющие вещи наземь. Собственные инвентарь и экипировка сущности не трогаются: добычу даёт лишь таблица добычи (loot_table). Что сущность сохраняет, возвращаясь на точку появления, решает код выхода — сказано в описании команды status/despawn/index.
Цена в кадре
Одно срабатывание: 0.4 мс процессорного времени
Срабатываний в минуту у одной сущности: 0.3
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Кому доступна
bot enemy animal player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
if(!$object->components->isset('hp') || $object->components->get('hp')==0)
{
	// Сущность появилась уже мёртвой (событие ей вешает код входа): смерть не наступает — состояние
	// восстанавливается. Ставим действие и выходим: тело лежит там, где его положили, движения у него
	// нет, добыча досталась от прошлой смерти. Признак появления — действие «load»: свойства сущности
	// код входа менять не вправе, и до первого игрового действия она остаётся с тем, с каким создана.
	if($object->action == SystemActionEnum::Load->value)
	{
		$object->action = 'dead';
		return;
	}

	// Первый вход в смерть: action ещё не dead. Розыгрыш добычи только здесь — повторный
	// заход (событие вешается триггером hp на каждое обнуление) переразыграл бы содержимое
	// уже обысканного трупа — бесконечный источник предметов.
	$isFirstDeath = $object->action != 'dead';

	$object->action = "dead";
	$object->events->remove('move/walk');

	// Разброс тел внутри клетки смерти: NPC ходят по центрам тайлов (A*-узлы) и умирают
	// точь-в-точь в центре — несколько трупов сливаются в одну точку, их не различить
	// ни кружком-подсветкой, ни кликом. Смещение от ЦЕНТРА клетки до ±0.35 сохраняет
	// tile() (banker's rounding меняет клетку с ±0.5) — клетка тела, от которой меряют доступ к добыче, та же.
	$tile = explode(Position::DELIMETR, $object->position->tile());
	$object->position = new Position(
		(int)$tile[0] + rand(-35, 35) / 100,
		(int)$tile[1] + rand(-35, 35) / 100,
		$object->position->z
	);

	// Запись состава идёт на ЛЮБОМ первом входе в смерть у того, кому добыча вообще положена по виду,
	// включая пустой состав: тело без дропа уходит с карты той же короткой паузой, что и обысканное дочиста
	// (сжатие срока — ниже, за записью). Гейт по компоненту, а не по таблице: таблица
	// решает только, есть ли что разыгрывать, а у видов без добычи (игрок, животное) самого компонента нет.
	if($isFirstDeath && $object->components->isset('loot'))
	{
		// Раскладка выпавшего своя у каждого потребителя таблицы: труп кладёт вещи по порядку розыгрыша
		// и сверх предела разных вещей ничего не пишет — не влезшее пропадает вместе с ним.
		$loot = [];

		if($object->components->isset('loot_table'))
		{
			foreach(Inventory::rollLoot($object->components->get('loot_table')) as $item)
			{
				// Часть добычи достаётся не телу, а земле вокруг: предмет на земле — самостоятельная сущность,
				// прав доступа у неё нет вовсе, потому берёт её любой подошедший, пока очередь держит само тело.
				// Мера ценности здесь одна — цена вещи: она уже стоит у каждого предмета, и отдельной
				// разметки в таблице дропа под это не заводим. Шанс в сотых долях процента обратен цене:
				// вещь в пару монет рассыпается всегда, расходник за четыре — в половине смертей, броня за двадцать
				// — в десятой части, меч за восемьдесят — почти никогда.
				//
				// У валюты торговой цены нет вовсе (ноль выводит её из торговли: монеты не покупают),
				// поэтому ценность ей даёт собственный номинал: монета стоит монету. Без этого деньги выпали бы
				// из правила целиком и никогда не рассыпались бы, хотя именно они — самая частая добыча.
				$price = $item['prefab'] === Trade::COIN ? 1 : Trade::itemPrice($item);
				$chance = $price > 0 ? (int)round(20000 / $price) : 0;

				if($chance && rand(1, 10000) <= $chance)
				{
					// Уходит ЧАСТЬ стака, остаток ложится в тело: вокруг видно рассыпанное, а обыск тела
					// смысла не теряет. Единственная штука не делится и уходит целиком.
					$drop = rand(1, (int)ceil($item['count'] / 2));

					// Кладём НА КЛЕТКУ ТЕЛА, разводить по соседним клеткам не наше дело: код входа сущности сам
					// уносит вещь с занятой клетки и разбрасывает внутри своей — правило одно на все механики,
					// роняющие предметы наземь. Срок лежания вешается там же.
					World::add($item['prefab'], [
						'map' => MAP_ID,
						'x' => $object->position->x,
						'y' => $object->position->y,
						'z' => $object->position->z,
						'components' => ['count' => $drop],
					]);

					$item['count'] -= $drop;

					if(!$item['count'])
						continue;
				}

				if(($next = Inventory::lootPut($loot, $item)) === null)
					break;

				$loot = $next;
			}

			// Добыча закрепляется за первым по вкладу урона, дальше круг ширится по ступеням (status/lootfree).
			// Никто не бил — закреплять не за кем. Список допущенных едет параметром самого отсчёта: право
			// действует, пока висит команда, и гаснет вместе с ней. Очередь в параметрах не держим — она
			// считается по накопителю урона на самом трупе, когда понадобится следующий.
			//
			// Создание группы ставит ближайший кадр (плюс разброс первого запуска NPC) — сама ступень берётся
			// из таймаута группы, потому сброс обязателен (тот же порядок, что у срока лежания тела).
			//
			// Закрепляем ДО записи состава: запись разошлёт его стоящим рядом с трупом, а рассылка спрашивает
			// право — не будь его на этот миг, первый же пакет состава ушёл бы и тем, кому добыча закрыта.
			if($loot && ($queue = Inventory::lootQueue($object)))
			{
				$object->events->add('status/lootfree', 'index', ['open' => [$queue[0]]]);
				$object->events->get('status/lootfree')->resetTimeout();
			}
		}

		$object->components->add('loot', $loot);

		// Пустой состав поверх пустого кода добычи не будит: запись равного значения фреймворк пропускает
		// (ComponentCollection::add). Срок лежания тела без дропа сжимаем здесь тем же правилом, что код добычи.
		if(!$loot && $object->events->isset('status/despawn'))
			$object->events->get('status/despawn')->resetTime(1);
	}
}
К игре