ui/inventory0.15 мс процессорного времени1| Параметр | По умолчанию | Что задаёт |
|---|---|---|
item |
пусто | Вещь, которую игрок кладёт, с количеством — {prefab, count, components}, как её хранит компонент inventory (components — лишь у вещи со своими значениями компонентов). В своём инвентаре она ищется по самой себе, а не по ячейке: монеты либо другая вещь, легшие в ту ячейку, не уходят; вещь, разложенная по нескольким ячейкам, списывается с них по порядку, остаток остаётся на месте. |
key |
пусто | Ключ сущности-контейнера на запущенной карте, куда игрок кладёт вещь. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
# Я — владелец источника: списание у себя атомарно ЗДЕСЬ (__transfer — перенос, без дропа на
# землю). Торговцу вещь уходит заявкой скупки (item/give/buy); сундуку и телу — зачисление status/changes __add
# (контейнер применит его тиком в этом же кадре: sort 0 после ui/inventory -9999; место ищется в момент
# применения, и вещь, которой места не хватило, контейнер возвращает мне — решение автора 2026-11-01).
# Исход механики — ТИХИЙ отказ, НЕ 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/put)');
// мёртвый не перекладывает
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
return;
// Жив либо нет разыгранной добычи — исход механики, тихий отказ. Не рядом — гонка (решение автора 2026-10-21):
// клиент шлёт перекладку из окна, открытого рядом с контейнером, и не рядом её застаёт лишь шаг самого игрока,
// исполненный раньше, — пишется в журнал предупреждений с ключом игрока.
if(!Inventory::isLootableBy($corpse, $object))
{
if(!$corpse->position->adjacent($object->position))
$object->warning('перекладка в '.$corpse->key.' не исполнена: игрок не рядом с контейнером (ui/inventory/put)');
return;
}
// Торговец, который не скупает (ценник не задан либо множитель скупки нулевой), вещь не принимает и даром: клиент
// такую продажу не шлёт, и пришедшая — неверная команда, а не гонка.
if($corpse->components->isset('trade') && Trade::rate($corpse, false) <= 0)
throw new Error('торговец '.$corpse->key.' не скупает — клиент не должен был слать продажу (ui/inventory/put)');
// Вещь с количеством называют саму, не позицию своего инвентаря (решение автора 2026-10-21): монеты и чужая вещь,
// легшие в ту же позицию, не уходят. Форма вещи — та же, что у позиции хранилища, количество не меньше единицы; иное —
// нарушение контракта.
$item = (array)($data['item'] ?: []);
Inventory::slotCheck($item, 0);
$item['count'] = (int)$item['count'];
if($item['count'] < 1)
throw new Error('Количество '.$item['count'].' вещи '.$item['prefab'].' меньше единицы (ui/inventory/put)');
// Своей вещи меньше названного — гонка: убрать её успевает лишь прежний шаг самого игрока; пишется в журнал
// предупреждений. Вещь, разложенная по нескольким позициям, списывается с них по порядку.
$taken = Inventory::take($object->components->get('inventory'), $item, $item['count']);
if($taken === null)
{
$object->warning('перекладка в '.$corpse->key.' не исполнена: в инвентаре меньше '.$item['count'].' '.$item['prefab'].' (ui/inventory/put)');
return;
}
// Предмет без базовой цены торговец не берёт и даром: клиент такую продажу не шлёт, и пришедшая — неверная
// команда, а не гонка (решение автора 2026-10-12, как у покупки товара без цены).
if($corpse->components->isset('trade') && Trade::itemPrice($item) <= 0)
throw new Error('торговец '.$corpse->key.' не покупает '.$item['prefab'].' — у вещи нет цены, клиент не должен был слать продажу (ui/inventory/put)');
$loot = $corpse->components->get('loot');
// Торгующему контейнеру предмет не кладут, а продают: то же списание у себя, но взамен
// приходит выручка. Платит он из своего запаса монет — касса пуста, сделки нет. Места в лавке нет — сделки
// тоже нет: клиент такую продажу не шлёт, пришедшая — исход механики (лавку и кассу сменили чужие сделки). Так же
// полный сундук и тело новую вещь не берут — она остаётся у игрока (решение автора 2026-11-01). Выручке место
// у продавца не нужно: без места она падает ему под ноги.
$price = 0;
if($corpse->components->isset('trade'))
{
$price = Trade::price($corpse, $item, false);
$coins = Inventory::take($loot, Trade::COIN, $price);
// место ищется по составу после выплаты: опустевшая запись кассы годится
if($coins === null || Inventory::lootPut(Inventory::lootAfter($loot, $coins), $item) === null)
return;
}
elseif(Inventory::lootPut($loot, $item) === null)
return;
// списание у себя (владелец источника) — атомарно, перенос без дропа; остаток стака остаётся на месте
$object->components->add('inventory', $taken + ['__transfer' => true]);
// Торговцу снятая здесь вещь уходит заявкой скупки: лавку и кассу пишет лишь он сам, а проверки выше —
// предварительные (лавку меняют чужие сделки того же кадра). Он решает сделку у себя и отвечает выручкой либо
// возвратом вещи — решение автора 2026-10-18.
if($price)
{
$corpse->events->push('item/give', 'buy', ['key' => $object->key, 'item' => $item]);
return;
}
// зачисление контейнеру штатным каналом чужих изменений; from — кому вернуть вещь, если места к применению не станет
$corpse->events->push('status/changes', 'index', ['data' => ['components' => ['loot' => ['__add' => [['item' => $item, 'from' => $object->key]]]]]]);