object/container0.15 мс процессорного времени0.5$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
// Повторяем проверку в любом исходе: контейнер живёт на карте постоянно, и следующая убыль состава
// должна застать срок уже идущим.
$object->events->add('object/container', 'respawn');
// Рядом с непустым контейнером стоит игрок — состав, возможно, у него перед глазами: подменённый под рукой
// состав пересобрал бы окно добычи, оборвав начатое перетаскивание, и сменил бы то, из чего в этот миг
// забирают. Срок идёт дальше, пополнит ближайший опрос после ухода последнего игрока. Пустой контейнер
// ждать нечего — его наполняют и при игроке рядом. «Рядом» — та же мера, что у открытия добычи.
if(($object->components->isset('loot') ? $object->components->get('loot') : []) && World::filter($object->position->x, $object->position->y, $object->position->z, static function(EntityAbstract $viewer):bool
{
return $viewer instanceof Player;
}, distance: 1))
return;
// Открытие добычи показывает крышку разово и в покой её не возвращает; возвращаем тут, чтобы вошедший
// в обзор не видел открытия заново. Присвоение действия рассылается всегда — ставим лишь при «open».
if($object->action == 'open')
$object->action = 'idle';
// Состав берётся у ПРЕФАБА, а не запоминается при создании: префаб — единственный источник того, что
// в контейнере лежит, и его правка доезжает до уже стоящих на карте контейнеров. Источник ОДИН —
// таблица с ключом-вещью: гарантированное стоит стопроцентной строкой, редкое — своим шансом, и
// одна вещь дважды в составе не окажется.
$prefab = World::prefabGet($object->prefab);
if(empty($prefab['component']['loot_table']))
return;
// Состав ПРИВОДИТСЯ к разыгранному, а не дополняется недостающим: иначе принесённое игроками копилось бы
// до предела разных вещей, а торгующий контейнер не пополнялся бы вовсе — монеты в его составе лежат
// всегда, и по правилу «пополняем только пустой» он навсегда остался бы пустым прилавком с кассой.
$value = [];
foreach(Inventory::rollLoot($prefab['component']['loot_table']) as $item)
{
if(($next = Inventory::lootPut($value, $item)) === null)
break;
$value = $next;
}
// Сравнение составов по содержимому, без порядка записей: одна форма для обеих сторон.
$pack = static function(array $loot): array
{
$out = [];
foreach($loot as $item)
$out[Inventory::stackKey($item)] = (int)$item['count'];
ksort($out);
return $out;
};
// Состав уже равен разыгранному — не пишем: запись рассылается стоящим рядом, и окно открытой
// добычи пересобиралось бы каждый срок, роняя начатое игроком перетаскивание.
if($pack($object->components->isset('loot') ? $object->components->get('loot') : []) === $pack($value))
return;
$object->components->add('loot', $value);