status/dead0.4 мс процессорного времени0.3$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);
}
}