open

из группы ui/loot
вызывает игрок
Открытие контейнера — тела погибшей сущности, сундука (сущности вида object) либо лавки торговца (клик по нему; у торговца с разговором — вариант «Торговать»). Состав добычи приватен, поэтому открытие и есть запрос состава: он уходит лишь открывшему игроку. Игрок не допущен к добыче (стоит отсчёт status/lootfree, а игрока в его списке допущенных нет) — не уходит ничего: чужой состав не показывают вовсе, и окно у клиента не открывается; что нельзя и сколько ждать, говорит полоска ожидания над телом. Добыча игроку доступна, но пуста — пустой состав шлётся: молчание было бы неотличимо от несработавшего клика. Открывают на карте контейнера — с его клетки либо с любой из восьми соседних на том же этаже, так же, как говорят с NPC. Открытие от игрока издалека ставит движение к контейнеру, и движение, дойдя до соседней клетки, ставит открытие заново. К контейнеру соседней карты, видному у границы карт, движение ведёт персонажа через границу вплотную к нему, и открытие повторяется уже на его карте. Любая новая команда движения отменяет подход; движение, снятое раньше (маршрута к контейнеру нет), открытия не ставит. Открытие не от игрока (повтор, поставленный движением по прибытии) застало игрока всё ещё не рядом с контейнером на его карте — окно не открывается, без ошибки: второй подход дал бы тот же исход. У сундука и лавки торговца (здоровья у них нет) открытие ставит действие «open»: в отличие от состава добычи, оно уходит всем видящим контейнер. Показ разовый: ни закрытия, ни слежения за тем, кто стоит рядом, открытие не ставит; у контейнера действие «open» держится до ближайшего пополнения (object/container/respawn), которое и возвращает его в «idle». Живая цель, игрок мёртв, ключа нет ни на карте игрока, ни на соседних либо добычи у цели нет — исход механики: тихий отказ без записи в журнал предупреждений; игрока эти отказы от игры не отключают. Отказы — живая цель, игрок мёртв, добычи у цели нет, игрок не допущен к добыче — приходят до подхода: к такому контейнеру персонаж не идёт, и через границу карт тоже. Перенос вещей — команды take и put группы ui/inventory.
Цена в кадре
Одно срабатывание: 0.08 мс процессорного времени
Срабатываний в минуту у одной сущности: 1
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 1
Параметр По умолчанию Что задаёт
key пусто Ключ сущности-контейнера на запущенной карте, который открывает игрок: тела либо сущности с добычей (компонент loot) — сундука, лавки торговца.
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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']]);
К игре