{
"1": [],
"2": [],
"3": [],
"4": [],
"5": [],
"6": [],
"7": [],
"8": [],
"9": [],
"10": [],
"11": [],
"12": [],
"13": [],
"14": [],
"15": [],
"16": []
}
$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;