$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);