ui/loot0.08 мс процессорного времени1| Параметр | По умолчанию | Что задаёт |
|---|---|---|
key |
пусто | Ключ сущности-контейнера на запущенной карте, который открывает игрок: тела либо сущности с добычей (компонент loot) — сундука, лавки торговца. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
# Открытие контейнера — трупа существа, объекта-сундука либо лавки торговца. Состав добычи приватен и уходит только тому,
# кто стоит рядом с контейнером, потому открытие и есть запрос состава.
# Исход механики — ТИХИЙ отказ (return), НЕ throw: throw в клиентском событии фреймворк (Frame::tick)
# трактует как фатал и ОТКЛЮЧАЕТ игрока. Живой труп (успел вернуться) — ожидаемый исход механики.
#
# Клик издалека → сервер сам ведёт: подход несёт движение move/walk/to и по прибытии ставит открытие заново.
#
# Пустой состав ШЛЁТСЯ тоже: клиент показывает пустое окно («обыскал — пусто»), молчание же неотличимо
# от несработавшего клика. Перенос предметов — события группы ui/inventory (take/put/index с key).
if(!World::isset($data['key']))
return;
// мёртвый не лутает — и не водим его к контейнеру
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
return;
$container = World::get($data['key']);
// живая цель — клик по живому существу либо исход механики (труп успел смениться живым); у сундука hp нет вовсе
if($container->components->isset('hp') && $container->components->get('hp') > 0)
return;
if(!$container->components->isset('loot'))
return;
// Добыча закреплена за другими — состав не наш, и показывать его нечего: недопущенному не уходит
// ни содержимое, ни само окно. Что нельзя и сколько ждать, уже говорит полоска ожидания над телом.
if(!Inventory::lootAllowed($container, $object->key))
return;
// Рядом — клетка контейнера либо любая из восьми соседних на том же этаже, как у разговора с NPC. Издалека —
// подойти до соседней клетки: дойдя, движение само повторит открытие. Повтор пришёл уже от него, а рядом всё
// ещё не стоим (маршрут упёрся раньше) — второй подход дал бы тот же исход.
// Контейнер соседней карты открывают лишь на его карте: подход идёт вплотную, через границу, и открытие повторяется уже там.
if($container->map != MAP_ID || !$object->position->adjacent($container->position))
{
if(!$from_client)
return;
$object->events->add('move/walk', 'to', ['x' => $container->position->x, 'y' => $container->position->y, 'z' => $container->position->z, 'target' => $container->key, 'max_distance' => $container->map == MAP_ID ? 1 : 0, 'then' => ['event' => 'ui/loot/open', 'data' => ['key' => $data['key']]]]);
return;
}
$loot = $container->components->get('loot');
$packet = ['components' => ['loot' => $loot]];
// У лавки — и цены штуки обеих сторон по каждому предмету игры: правила цены клиент не держит. Множители
// торговца меняются лишь правкой автора, а она доходит до карты её перезагрузкой — до нового открытия лавки
// цены не устаревают. Вещь со своей ценой (её отличие от префаба) стоит иначе, чем её предмет: цена в лавке
// зависит лишь от базовой цены, потому для каждой своей базовой цены вещей товара и инвентаря открывшего —
// цена покупки и скупки, ключом сама базовая цена строкой (решения автора 2026-11-01). Купленная вещь лежала
// в товаре, проданная — в инвентаре: новая своя цена при открытой лавке не появляется.
if($container->components->isset('trade'))
{
$buyRate = Trade::rate($container, true);
$sellRate = Trade::rate($container, false);
$own = ['buy' => [], 'sell' => []];
foreach([$loot, $object->components->get('inventory')] as $slots)
foreach($slots as $slot)
if(!empty($slot) && isset($slot['components']['price']))
{
$base = (string)(float)$slot['components']['price'];
$own['buy'][$base] = Trade::unit($buyRate, $slot, true);
$own['sell'][$base] = Trade::unit($sellRate, $slot, false);
}
// объектом всегда: ключи-цены вида 0 и 1 ушли бы JSON-массивом
$packet['offer'] = [
'buy' => Trade::offer($buyRate, true),
'sell' => Trade::offer($sellRate, false),
'own' => ['buy' => (object)$own['buy'], 'sell' => (object)$own['sell']],
];
}
$object->send($packet, from: $container);
// Открытие крышки сундука видно всем — это действие самой сущности контейнера, а чужому существу поля
// меняют каналом status/changes. Показ разовый: в покой тело возвращает сам клиент, а действие на сервере
// снимает пополнение. У трупа действие занято смертью (dead), его не трогаем.
if(!$container->components->isset('hp'))
$container->events->push('status/changes', 'index', ['data' => ['action' => 'open']]);