respawn

из группы object/container
Срок пополнения вышел: состав контейнера ПРИВОДИТСЯ к разыгранному по таблице его префаба (loot_table): стопроцентная строка ложится всегда, редкая — по своему шансу, а выпавшее сверх предела разных вещей добычи (сколько ячеек в умолчании компонента inventory — поле «По умолчанию») пропадает: на землю оно не ложится. Вынесенное возвращается, а лишнее сверх разыгранного — в том числе принесённое игроками (проданное торговцу, положенное в сундук) — пропадает: от частичной выемки контейнер не богатеет, чужим не засоряется, а торгующий пополняется наравне с прочими (пополняйся контейнер лишь опустев, торговец, у которого монеты лежат всегда, не пополнялся бы никогда). Розыгрыш идёт заново КАЖДЫМ сроком, поэтому набор редких вещей меняется от пополнения к пополнению. Непустой контейнер, рядом с которым стоит игрок — на клетке контейнера либо на соседней того же этажа, как при открытии добычи, — пропускается целиком: состав, возможно, у игрока перед глазами, и подменённый под рукой состав пересобрал бы окно добычи, оборвав начатое перетаскивание, и сменил бы то, из чего в этот самый миг забирают; срок продолжает идти, и пополнение случится первой проверкой после того, как отойдёт последний игрок. Сущность рядом, кроме игрока, пополнения не держит. Пустой контейнер наполняется и при игроке рядом: беречь в нём нечего. Проверка, которую контейнер не пропустил, возвращает в «idle» действие «open», оставленное открытием добычи, — и тогда, когда состав не меняется: иначе вошедший в обзор увидел бы открытие заново. Состав совпал с разыгранным — он не перезаписывается, и игрокам рядом с контейнером ничего не рассылается. Проверка повторяется всю жизнь контейнера, поэтому ставится стартовым событием префаба; наполняется контейнер именно ею — первым же ходом, который ему достанется, и без этого события он останется пустым навсегда. Ход этот приходит не в момент создания: своего радиуса жизни у контейнера нет, и события ему исполняются, лишь пока его клетку накрывает чужой радиус — на практике радиус подошедшего игрока. На пустой карте первое наполнение поэтому случается тем же кадром, которым игрок на неё входит: пустым он контейнер не застаёт, сколько бы тот ни простоял до его прихода.
Цена в кадре
Одно срабатывание: 0.15 мс процессорного времени
Срабатываний в минуту у одной сущности: 0.5
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Кому доступна
object trader trader_silent
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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);
К игре