inventory

словарь со своим кодом
Инвентарь сущности: словарь «номер ячейки → вещь»; пустая ячейка держит null. Ячеек столько, сколько ключей в умолчании компонента (поле «По умолчанию»). Вещь в ячейке — prefab (префаб вещи — вида item либо носимого вида, например weapon), count (сколько штук) и необязательный components (свои значения компонентов этой вещи). Присланное изменение дописывается в инвентарь: ячейка, которой в нём нет, остаётся как была, пустое значение её очищает, присланная вещь заменяет прежнюю. Вещи, которых после записи стало меньше, падают на клетку владельца — кроме записи у мёртвого владельца и переноса в другой инвентарь (ключ __transfer). Номера ячеек хранят компоненты equip и actionbars; запись инвентаря правит их командами ui/equip и ui/actionbars. Вещь переехала в другую ячейку — ссылка на неё переходит за ней. Вещь ушла из своей ячейки без переезда — ссылка снимается, и тогда, когда ячейку той же записью заняла другая вещь. У владельца с непустым журналом квестов смена инвентаря ставит пересчёт квестов. Служебные ключи записи из механик (не ячейки): __transfer — уменьшение является переносом в другой инвентарь, на землю ничего не падает; __add — список зачислений [{item, to?}, ...], где item — вещь (prefab, count, components), to — номер желаемой ячейки. Ячейка находится в момент применения: стак той же вещи приоритетнее to, иначе первая пустая; некуда — вещь падает на клетку владельца. Список, а не одна запись — «забрать всё» зачисляет несколько вещей одной заявкой. Уровень вложенности значения (maxCompareLevel) у компонента не меняют: при другом значении код компонента отбивает каждое значение ошибкой — с тем же исходом, что неверная скорость (описание компонента speed).
Стартовое значение
{
    "1": [],
    "2": [],
    "3": [],
    "4": [],
    "5": [],
    "6": [],
    "7": [],
    "8": [],
    "9": [],
    "10": [],
    "11": [],
    "12": [],
    "13": [],
    "14": [],
    "15": [],
    "16": []
}
Кому выдаётся
bot enemy player
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

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

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

<?php
# Этот код и при создании существ проверит значение компонента и далее из события что будет меняться.
# Формат: {slot_idx => {prefab, count, components?} | null}. Партиальные апдейты: отсутствующий
# в $value ключ слота остаётся как в $current; null = слот очищается; non-null = слот заменяется.
# Служебные ключи (не слоты):
#   __transfer=true — уменьшение является ПЕРЕНОСОМ в другой инвентарь (item/give, ui/inventory/put),
#     не выбросом — дроп разницы на землю подавляется (иначе дубль: вещь и у получателя, и на земле);
#   __add=[{item:{prefab,count,components?}, to?:int}, ...] — СПИСОК зачислений с поиском слота
#     В МОМЕНТ применения (стак приоритетнее to, иначе первый пустой): канал доставки переносов
#     (status/changes) асинхронен, предвычисленный отправителем слот мог заняться. Список, а не одна
#     запись — «забрать всё» зачисляет несколько вещей одной заявкой. Совсем некуда — вещь уже списана у источника, отказ невозможен: дроп на
#     клетку владельца, не потеря.
#   Клиентского пути у служебных ключей нет: публичные события инвентаря принимают только номера слотов —
#   иначе зачисление прошло бы мимо анти-чита события (он считает только позиции с вещью).
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */

$component = ComponentCollection::list()['inventory'];

if($component->maxCompareLevel!=2)
	throw new Error('Компонент inventory не должен иметь в настройках предела уровня анализа уникальных данных для Рассылки кроме как 2');

// Правила слотового хранилища (ёмкость, ключ стакуемости, форма слота, поиск слота, доступность
// контейнера) живут библиотекой inventory-trade: они нужны и там, где инвентаря нет вовсе —
// добыче сундука на карте без инвентарных существ.

$isTransfer = !empty($value['__transfer']);
unset($value['__transfer']);

$current = $object->components->get('inventory');
$slotCount = count($component->default);

if(!empty($value['__add']))
{
	// Место ищется по составу ПОСЛЕ слотов той же записи: слот, освобождённый её списанием (сдача квеста, оплата
	// покупки), годится под зачисление, а стак, который она меняет, доращивается от нового количества, не от прежнего.
	$pending = array_replace($current, array_diff_key($value, ['__add' => true]));

	foreach($value['__add'] as $add)
	{
		$slot = Inventory::findSlot($pending, $add['item'], (int)($add['to'] ?? 0));

		if($slot)
		{
			$merged = $add['item'];
			if(!empty($pending[$slot]))
				$merged['count'] += $pending[$slot]['count'];

			$pending[$slot] = $merged;
			$value[$slot] = $merged;
		}
		else
			World::add($add['item']['prefab'], [
				'map' => MAP_ID,
				'x' => $object->position->x,
				'y' => $object->position->y,
				'z' => $object->position->z,
				'components' => ['count' => $add['item']['count']] + ($add['item']['components'] ?? []),
			]);
	}
}
unset($value['__add']);

// Один проход: строим $inventory[$i], считаем тотал по identity-ключу стака (для drop-в-мир)
// и ключи $currentIds/$inventoryIds (для $slotMap ниже).
$inventory = [];
$oldTotals = [];
$oldPrefabs = [];
$oldComponents = [];
$newTotals = [];
$currentIds = [];
$inventoryIds = [];
for($i=1;$i<=$slotCount;$i++)
{
	if(!empty($value[$i]))
	{
		Inventory::slotCheck($value[$i], $i);

		$slot = ['prefab'=>$value[$i]['prefab'], 'count'=>$value[$i]['count']];
		if(!empty($value[$i]['components']))
			$slot['components'] = $value[$i]['components'];
		$inventory[$i] = $slot;
	}
	elseif(array_key_exists($i, $value))
		$inventory[$i] = null;
	elseif(!empty($current[$i]))
	{
		$slot = ['prefab'=>$current[$i]['prefab'], 'count'=>$current[$i]['count']];
		if(!empty($current[$i]['components']))
			$slot['components'] = $current[$i]['components'];
		$inventory[$i] = $slot;
	}
	else
		$inventory[$i] = null;

	if(!empty($current[$i]))
	{
		$key = Inventory::stackKey($current[$i]);
		$currentIds[$i] = $key;
		$oldTotals[$key] = ($oldTotals[$key] ?? 0) + $current[$i]['count'];
		$oldPrefabs[$key] = $current[$i]['prefab'];
		if(!empty($current[$i]['components']))
			$oldComponents[$key] = $current[$i]['components'];
	}

	if(!empty($inventory[$i]))
	{
		$key = Inventory::stackKey($inventory[$i]);
		$inventoryIds[$i] = $key;
		$newTotals[$key] = ($newTotals[$key] ?? 0) + $inventory[$i]['count'];
	}
}

// Дропаем на землю положительную разницу oldTotals - newTotals (реальная потеря).
// Нулевая или отрицательная разница = swap/merge внутри инвентаря или partial-pickup —
// дропать нечего. Подход не зависит от порядка обхода и иммунен к багам с накоплением балансов.
// Дроп — семантика ВЫБРОСА живым владельцем: у мёртвого (hp<=0) забирают лут (item/give),
// при __transfer живой ПЕРЕКЛАДЫВАЕТ в контейнер (ui/inventory/put) — в обоих случаях вещь уже
// перенесён получателю, спавн на земле дал бы дубль.

$isDead = $object->components->isset('hp') && $object->components->get('hp') <= 0;

if(!$isDead && !$isTransfer)
	foreach($oldTotals as $key => $oldCount)
	{
		$diff = $oldCount - ($newTotals[$key] ?? 0);
		if($diff <= 0)
			continue;
		$entityData = ['count' => $diff];
		if(isset($oldComponents[$key]))
			$entityData += $oldComponents[$key];
		World::add($oldPrefabs[$key], [
			'map' => MAP_ID,
			'x' => $object->position->x,
			'y' => $object->position->y,
			'z' => $object->position->z,
			'components' => $entityData,
		]);
	}

// Карта: старый_слот → новый_слот (куда переехала вещь в инвентаре).
// Строим один раз — переиспользуется для каскадов в actionbars и equip (оба хранят ссылки
// на инвентарные слоты по номеру). Сравнение по identity-ключу: только реальная смена
// вещи в слоте триггерит поиск — изменение одного count в том же слоте не считается «переездом».
$slotMap = [];
foreach($currentIds as $i => $oldKey)
{
	if($oldKey === ($inventoryIds[$i] ?? null))
		continue;
	foreach($inventoryIds as $j => $newKey)
	{
		// Целью переезда служит лишь слот, который эта вещь ПОЛУЧИЛА — новым содержимым либо прибавкой
		// количества: нетронутый стак той же вещи привязку не принимает, иначе при двух одинаковых стаках
		// она уходила бы не туда, куда переехала вещь, а проданный надетый подменялся бы соседним.
		if($j !== $i && $newKey === $oldKey && (($currentIds[$j] ?? null) !== $newKey || $inventory[$j]['count'] > $current[$j]['count']))
		{
			$slotMap[$i] = $j;
			break;
		}
	}
}

// обновить ссылки в actionbars (там хранится номер слота инвентаря)
// из тригера компонента нельзя менять компоненты напрямую, поэтому вешаем событие
// actionbars разрешён только player'ам — на enemy/прочих kind компонент не присвоен, get кинет ошибку
if($object->components->isset('actionbars'))
{
	// Каскад считает от раскладки, какой её сделает ждущая заявка того же кадра, и ставит объединённую: add заменяет
	// ждущую, а та несёт номера слотов, которые эта запись инвентаря могла сдвинуть (две записи инвентаря в одном кадре).
	$pendingBars = $object->events->isset('ui/actionbars') ? ($object->events->get('ui/actionbars')->data['actionbars'] ?? []) : [];
	$actionbars = array_replace($object->components->get('actionbars'), $pendingBars);
	// отправляем только изменённые ячейки actionbars
	$updates = [];
	foreach($actionbars as $barNum => $bar)
	{
		if(!empty($bar) && $bar['kind'] == 'item')
		{
			$oldSlot = (int)$bar['id'];
			if(isset($slotMap[$oldSlot]))
				$updates[$barNum] = ['kind' => 'item', 'id' => $slotMap[$oldSlot]];
			// Вещь пропала, а её слот пуст либо занят другой вещью той же записью (награда квеста, выручка
			// в освободившийся слот): кнопка указала бы на чужую вещь.
			elseif(($inventoryIds[$oldSlot] ?? null) !== ($currentIds[$oldSlot] ?? null))
				$updates[$barNum] = null;
		}
	}

	if($updates)
		$object->events->add('ui/actionbars', 'index', ['actionbars' => array_replace($pendingBars, $updates)]);
}

// аналогичный каскад для equip — переезд инвентарного слота меняет idx,
// drop из инвентаря снимает экипировку (idx → null)
// equip без default — на сущностях без экипировки компонент в values отсутствует
if($object->components->isset('equip'))
{
	// тот же счёт поверх ждущей заявки, что у actionbars выше
	$pendingEquip = $object->events->isset('ui/equip') ? ($object->events->get('ui/equip')->data['items'] ?? []) : [];
	$equip = array_replace($object->components->get('equip'), $pendingEquip);
	$updates = [];
	foreach($equip as $slot => $entry)
	{
		// значение слота экипировки — {idx, prefab} либо null (слот пуст): см. компонент equip
		$idx = is_array($entry) ? ($entry['idx'] ?? null) : $entry;

		if($idx === null)
			continue;

		if(isset($slotMap[$idx]))
			$updates[$slot] = $slotMap[$idx];
		// то же, что у кнопки: слот пуст либо в нём другая вещь — надетого больше нет
		elseif(($inventoryIds[$idx] ?? null) !== ($currentIds[$idx] ?? null))
			$updates[$slot] = null;
	}

	if($updates)
		$object->events->add('ui/equip', 'index', ['items' => array_replace($pendingEquip, $updates)]);
}

// Признак «выполнен» у квестов зависит от состава инвентаря; журнал отсюда менять нельзя — пересчёт командой.
// Журнал есть не у всех владельцев инвентаря, а пустому пересчитывать нечего.
if($object->components->isset('quest_log') && $object->components->get('quest_log'))
	$object->events->add('quest/recount', 'index');

$value = $inventory;
К игре