put

из группы ui/inventory
вызывает игрок
Переложить вещь из своего инвентаря в добычу контейнера — тела либо сущности с добычей (компонент loot): сундука, лавки торговца, — стоящих на карте игрока, на его клетке либо на соседней того же этажа. Кладут названную вещь с количеством, а не ячейку своего инвентаря. Игрок — владелец источника: списание у себя — перенос, разница на землю не падает. Сундуку и телу зачисление уходит отдельным изменением их состояния и применяется тем же кадром. В добыче сундука либо тела та же вещь (того же префаба и с теми же своими значениями компонентов) прибавляет количество к своей записи, новая ложится новой записью. Полный сундук либо тело — такой вещи в добыче нет, а разных вещей уже предел (сколько ячеек в умолчании компонента inventory — поле «По умолчанию»), — новую вещь не берёт: тихий отказ, вещь остаётся у игрока. Исход тот же, когда место кончилось уже после списания, тем же кадром (контейнер успели наполнить другие): контейнер возвращает вещь игроку в инвентарь, а без места там она падает игроку под ноги; игрока к этому моменту не видно (ушёл с карты, вышел из игры) — вещь пропадает с записью в журнал предупреждений. На клетку контейнера вещь не ложится. Новый состав контейнера приходит адресной рассылкой его добычи стоящим рядом с ним — на его клетке и на соседних того же этажа; отдельного ответа на команду нет. Торговцу (есть компонент trade) вещь не кладут, а продают: снятая у игрока вещь уходит торговцу заявкой скупки (item/give/buy), сделку решает он, и ответом приходит выручка монетами из его кассы либо возврат вещи. Место у продавца выручке не нужно: без места она падает игроку под ноги. До снятия вещи команда сверяет лавку торговца — его добычу, где лежат и товар, и касса (монеты, которыми он платит): монет в кассе должно хватать на выручку, а под вещь в лавке должно быть место: такая вещь там уже лежит либо разных вещей меньше предела. Не сошлось — тихий отказ, вещь остаётся у игрока. Сверка предварительная — лавку меняют и чужие сделки того же кадра, окончательно сделку решает торговец. Вещь, которую торговец не принимает и даром, клиент игры продать не даёт, и пришедшая продажа — нарушение: игрок отключается от игры, вещь остаётся у него. Таких случаев два: торговец с закрытой скупкой (ценник — множители компонента trade — не задан либо множитель скупки (sell) нулевой) и вещь без цены (компонент price) у торговца, который скупает. В контейнер соседней карты, видного у границы карт, кладут лишь на его карте: открытие добычи ведёт персонажа туда через границу, и клиент игры перекладку к контейнеру соседней карты не шлёт — она приходит лишь от программы, которая шлёт команды игрока мимо него, и это нарушение: игрок отключается от игры, вещь остаётся у него. Контейнер не рядом (дальше соседней клетки либо на другом этаже) либо названной вещи у игрока меньше названного количества — гонка: перекладку шлют из окна, открытого рядом с контейнером, а застать игрока не рядом и убрать его вещь успевает лишь его же шаг, исполненный раньше; тихий отказ с записью в журнал предупреждений. Сущности по ключу нет, она живая, а не тело, у неё нет компонента loot, игрок мёртв, в добыче сундука, тела либо лавки нет места под вещь либо в кассе торговца не хватает монет — исход механики: тихий отказ, в журнал не пишется. Игрока эти отказы от игры не отключают. Контейнер на соседней карте, вещь названа не по форме (параметр item), количество меньше единицы и продажа, которую торговец не принимает (абзацы выше), — нарушение: игрок отключается от игры, вещь остаётся у него.
Цена в кадре
Одно срабатывание: 0.15 мс процессорного времени
Срабатываний в минуту у одной сущности: 1
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 2
Параметр По умолчанию Что задаёт
item пусто
Вещь, которую игрок кладёт, с количеством — {prefab, count, components}, как её хранит компонент inventory (components — лишь у вещи со своими значениями компонентов). В своём инвентаре она ищется по самой себе, а не по ячейке: монеты либо другая вещь, легшие в ту ячейку, не уходят; вещь, разложенная по нескольким ячейкам, списывается с них по порядку, остаток остаётся на месте.
key пусто Ключ сущности-контейнера на запущенной карте, куда игрок кладёт вещь.
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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]]]]]]);
К игре