loot

список со своим кодом
Добыча контейнера — тела погибшей сущности, сущности вида object (сундук и т.п.) либо лавки торговца (её товар и касса): то, что лежит в нём СЕЙЧАС. Своего значения по умолчанию у компонента нет, поэтому пустое значение ему даёт сам тип: пустой состав заводится у КАЖДОЙ сущности разрешённого вида в момент её создания, ещё до того как в него что-то положат. Само наличие компонента поэтому ни о чём не говорит: есть у цели добыча или нет, решает только содержимое. Префабу этот компонент не задают: что достанется с сущностей этого префаба и когда это разыгрывается, описывает таблица добычи (loot_table). Состав ПРИВАТЕН: видящим не рассылается, а уходит адресно игрокам, которые стоят рядом с контейнером — на его клетке либо на соседней того же этажа — и допущены к добыче: при каждом изменении состава и по открытию. Пока стоит отсчёт status/lootfree, допуск к добыче есть лишь у допущенных, перечисленных в нём: остальным состав не уходит, даже когда они стоят рядом; отсчёта нет — допущен каждый игрок рядом. Тело, чья добыча опустела, уходит с карты через секунду после выноса последней вещи, а тело, которому при смерти не досталось ничего, — через секунду после смерти, не дожидаясь конца срока снятия с карты (группа status/despawn). Вместе с телом у смотревших закрывается окно добычи. Первый случай исполняет сам этот компонент, когда добыча опустела, второй — команда смерти status/dead/index. Секунда нужна, чтобы доиграла смерть и было видно, что взято последнее. Касается только того, у кого идёт срок снятия с карты, то есть тела: у сундука и торговца срока нет вовсе, и пустота у них значит лишь ожидание своего пополнения. Формат — список вещей без мест: [{prefab, count, components?}, ...]. У одной вещи (тот же prefab и те же components) одна запись, разных вещей не больше предела — столько, сколько ячеек в умолчании компонента inventory (поле «По умолчанию»); состав сверх предела либо с одной вещью двумя записями отбивается ошибкой — с тем же исходом, что неверная скорость (описание компонента speed). Запись — весь новый состав списком либо служебный ключ __add — список зачислений [{item:{prefab,count,components?}, from}, ...], применяемых к составу в момент записи: та же вещь прибавляет количество к своей записи, новая ложится в конец. from — ключ сущности, положившей вещь, на запущенной карте (вида players_1). Новой вещи при пределе разных вещей места нет: она возвращается положившему — в его инвентарь, а без места там падает ему под ноги; положившего к этому моменту не видно (ушёл с карты, вышел из игры) — вещь пропадает, и это пишется в журнал предупреждений. На клетку контейнера вещь не ложится. Пишет только серверный код механик, клиентского пути записи у компонента нет. При уменьшении на землю ничего не кладётся — забрать можно только командой ui/inventory/take.
Стартовое значение
пусто
Сущность получает компонент пустым: ноль у числа, пустая строка у текста, пустой набор у списка.
Кому выдаётся
enemy object trader trader_silent
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

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

<?php
# Добыча контейнера — трупа существа, объекта-сундука либо лавки торговца: список вещей без мест (решение автора
# 2026-11-01), на одну вещь одна запись, разных вещей не больше ёмкости хранилища (Inventory::lootPut). Форма вещи
# проверяется тем же общим правилом библиотеки inventory-trade, что у инвентаря: хранилища разные, форма вещи одна.
# При уменьшении НИЧЕГО не спавнится на землю: у inventory дроп разницы — семантика выброса живым
# владельцем, здесь же уменьшение всегда означает забор через события лута, спавн дал бы дубль.
# Клиентского пути записи нет (пишет только код механик) — проверки ниже страховочные.
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */

// Запись — весь новый состав списком либо зачисления __add поверх нынешнего: несколько вещей ложатся одной заявкой,
// место ищется в момент применения.
if($value === [] || array_keys($value) === range(0, count($value) - 1))
	$loot = $value;
else
{
	$extra = array_diff_key($value, ['__add' => 1]);
	if($extra)
		throw new Error('Добыча '.$object->key.': неизвестные ключи записи '.implode(', ', array_keys($extra)));

	$loot = $object->components->isset('loot') ? $object->components->get('loot') : [];

	foreach($value['__add'] as $add)
	{
		if(($next = Inventory::lootPut($loot, $add['item'])) !== null)
			$loot = $next;
		// Разных вещей уже предел — вещь возвращается тому, кто её положил (решение автора 2026-11-01): в инвентарь,
		// без места — ему под ноги. Его больше не видно (ушёл с карты, вышел из игры) — вернуть некому, вещь пропадает.
		elseif(World::isset($add['from']))
			World::get($add['from'])->events->push('status/changes', 'index', ['data' => ['components' => ['inventory' => ['__add' => [['item' => $add['item']]]]]]]);
		else
			$object->warning('зачисление в '.$object->key.' не состоялось: места нет, положившего '.$add['from'].' больше не видно, вещь '.$add['item']['prefab'].' пропала');
	}
}

// Одна вещь — одна запись: две записи с тем же ключом стакуемости дали бы забору и выдаче две позиции одной вещи.
$keys = [];
foreach($loot as $i => $item)
{
	Inventory::slotCheck($item, $i);

	$key = Inventory::stackKey($item);
	if(isset($keys[$key]))
		throw new Error('Добыча '.$object->key.': вещь '.$item['prefab'].' лежит двумя записями — у одной вещи одна запись');
	$keys[$key] = true;

	$loot[$i] = ['prefab' => $item['prefab'], 'count' => (int)$item['count']];
	if(!empty($item['components']))
		$loot[$i]['components'] = $item['components'];
}

if(count($loot) > Inventory::slotCount())
	throw new Error('Добыча '.$object->key.': разных вещей '.count($loot).' — больше ёмкости '.Inventory::slotCount());

$value = $loot;

// Рассылка ИЗМЕНИВШЕГОСЯ состава стоящим рядом с контейнером — на его клетке и на соседних того же этажа,
// откуда его открывают: содержимое живёт на сервере, и без неё забранное либо положенное не доехало бы
// обратно в открытое окно. Разовый запрос состава и подвод игрока — дело события открытия, здесь их нет.
// Состав приватен (движок компонент не рассылает): иначе содержимое каждого сундука карты уезжало бы
// всем, кто его видит. Близости мало — право спрашиваем тем же общим предикатом, что открытие и выдача:
// закреплённая за другими добыча не показывается и стоящему рядом, иначе изменение состава открывало
// бы ему то, в чём отказано на открытии. Пакет несёт состав целиком: клиент подменяет им прежний.
// Гейт на присутствие в мире отсекает создание сущности — там состав ещё никто не запрашивал.
if(World::isset($object->key))
{
	foreach(World::filter($object->position->x, $object->position->y, $object->position->z, static function(EntityAbstract $viewer) use ($object):bool
	{
		return $viewer instanceof Player && Inventory::lootAllowed($object, $viewer->key);
	}, distance: 1, count: null) as $viewer)
		$viewer->send(['components' => ['loot' => $loot]], from: $object);
}

// Опустевшему телу лежать незачем: срок сжимается до короткой паузы — она даёт доиграть смерть
// и увидеть, что взято последнее, а окно добычи клиент закроет сам по исчезновению сущности.
// Гейт по ВИСЯЩЕМУ сроку важен вдвойне: набор позиций заводится пустым у КАЖДОЙ сущности
// разрешённого вида при создании, а у сундука и торговца срока нет вовсе — их пустота значит «вынесли»,
// и состав им вернёт свой срок пополнения.
if(!$loot && $object->events->isset('status/despawn'))
	$object->events->get('status/despawn')->resetTime(1);
К игре