take

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