ui/inventory0.1 мс процессорного времени1| Параметр | По умолчанию | Что задаёт |
|---|---|---|
items |
пусто | Вещи, которые игрок забирает, с количеством каждой: одна вещь — список из одной, «забрать всё» — все показанные вещи одним списком, и тогда берётся ровно то, что игрок видел. Вещь — {prefab, count, components}, как её хранит компонент inventory (components — лишь у вещи со своими значениями компонентов); количество не меньше единицы, больше лежащего — отдаётся сколько есть. Как выдача ищет названные вещи в контейнере, сказано в описании параметра items команды item/give/index. |
key |
пусто | Ключ сущности-контейнера на запущенной карте, из которого игрок забирает. |
to |
пусто | Желаемая ячейка своего инвентаря: её номер, счёт с единицы; номер вне инвентаря отбивается и тогда, когда место не учитывается (исход — в описании команды). Как выдача выбирает ячейку, сказано в описании параметра to команды item/give/index. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
# Списание исполняет ВЛАДЕЛЕЦ источника: здесь только валидации + item/give контейнеру — он
# в своём тике (sort -100, тот же кадр) спишет у себя атомарно, сверит право на добычу и зачислит
# мне. Конкурентный забор той же позиции получит в give пустую позицию — дюп исключён структурно.
# Исход механики — ТИХИЙ отказ (return), НЕ throw: throw в клиентском событии фреймворк
# (Frame::tick) трактует как фатал и ОТКЛЮЧАЕТ игрока. bounds позиций — контракт, остаются throw.
if(!World::isset($data['key']))
return;
$corpse = World::get($data['key']);
// Контейнер соседней карты: открытие ведёт игрока на его карту, а окно добычи и лавки клиент закрывает, когда игрок
// ушёл с карты контейнера, — забор у него присылает неверный клиент, не гонка (решение автора 2026-10-20).
if($corpse->map != MAP_ID)
throw new Error('контейнер '.$corpse->key.' стоит на соседней карте — забирать из него можно лишь на его карте (ui/inventory/take)');
// мёртвый не лутает (рядом с трупом может лежать и мёртвый игрок — без этого гейта он лутал бы)
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
return;
// Жив либо добычи нет вовсе — исход механики (труп воскрес за 30с). Не рядом — гонка (решение автора 2026-10-21):
// клиент шлёт забор из окна, открытого рядом с контейнером, и не рядом его застаёт лишь шаг самого игрока,
// исполненный раньше, — пишется в журнал предупреждений с ключом игрока.
if(!Inventory::isLootableBy($corpse, $object))
{
if(!$corpse->position->adjacent($object->position))
$object->warning('забор из '.$corpse->key.' не исполнен: игрок не рядом с контейнером (ui/inventory/take)');
return;
}
// Торговец, который не продаёт (ценник не задан либо множитель покупки нулевой), товар не отдаёт и даром: клиент
// такую покупку не шлёт, и пришедшая — неверная команда, а не гонка.
if($corpse->components->isset('trade') && Trade::rate($corpse, true) <= 0)
throw new Error('торговец '.$corpse->key.' не продаёт — клиент не должен был слать покупку (ui/inventory/take)');
$slotCount = Inventory::slotCount();
// Выбор — сами вещи с количеством, не позиции контейнера (решение автора 2026-10-21): вещь, легшая в ту же позицию
// после показа, не берётся. Форма вещи — та же, что у позиции хранилища, количество не меньше единицы; иное — нарушение
// контракта. Количество больше лежащего — исход механики: выдача отдаст сколько есть.
$items = [];
foreach((array)($data['items'] ?: []) as $item)
{
$item = (array)$item;
Inventory::slotCheck($item, 0);
if((int)$item['count'] < 1)
throw new Error('Количество '.$item['count'].' вещи '.$item['prefab'].' меньше единицы (ui/inventory/take)');
$items[] = $item;
}
// Пустой выбор клиент не шлёт (LootWindowController.SendTake отказывает до отправки) — пришедший есть нарушение.
if(!$items)
throw new Error('выбор забора пуст — клиент не должен был слать команду (ui/inventory/take)');
$to = (int)($data['to'] ?: 0);
if($to && ($to < 1 || $to > $slotCount))
throw new Error('Позиция '.$to.' вне инвентаря');
$loot = $corpse->components->get('loot');
$wanted = Inventory::pick($loot, $items);
// названных вещей в контейнере уже нет (их взял другой) — исход механики
if(!$wanted)
return;
// Товар без цены торговец не отдаёт, и клиент такую покупку не шлёт: пришедшая — неверная команда, как и покупка
// у торговца, который не продаёт.
if($corpse->components->isset('trade'))
foreach(array_keys($wanted) as $i)
if(Trade::price($corpse, $loot[$i], true) <= 0)
throw new Error('товар '.$loot[$i]['prefab'].' у торговца '.$corpse->key.' без цены — клиент не должен был слать покупку (ui/inventory/take)');
// Покупка у торговца — предоплатой (решение автора 2026-10-18): монеты покупателя пишет лишь его собственная команда,
// и у выдачи нет проверки ждущих изменений покупателя. Цену той же раскладкой, что у выдачи, снимаю здесь, а торговец
// решает сделку у себя и отвечает товаром либо возвратом монет.
$paid = 0;
if($corpse->components->isset('trade'))
{
$paid = Inventory::give($loot, $wanted, 0, $corpse)[2];
$coins = Inventory::take($object->components->get('inventory'), Trade::COIN, $paid);
// не хватает монет — сделки нет
if($coins === null)
return;
// __transfer: монеты перешли торговцу, а не выброшены на землю
$object->components->add('inventory', $coins + ['__transfer' => true]);
}
// списание — владельцу: контейнер отдаст в своём тике этого же кадра
$corpse->events->push('item/give', 'index', ['key' => $object->key, 'items' => $items, 'to' => $to, 'paid' => $paid]);