index

из группы ui/inventory
вызывает игрок
Раскладка СВОЕГО инвентаря: перестановка вещей по ячейкам и слияние стаков внутри него. Игрок мёртв — отказ без ошибки. Вещи чужих контейнеров эта команда не раскладывает: перенос между своим инвентарём и добычей контейнера — соседние команды группы ui/inventory/take и ui/inventory/put.
Цена в кадре
Одно срабатывание: 0.15 мс процессорного времени
Срабатываний в минуту у одной сущности: 2
Формулами, потому что обе величины зависят от обстановки на карте — сколько вокруг сущностей и сколько из них живых.
Параметры 1
Параметр По умолчанию Что задаёт
inventory обязателен
Ячейки своего инвентаря: словарь «номер ячейки → вещь в том же виде, в каком её хранит компонент inventory». Ключ — номер ячейки, счёт с единицы; номер вне размера инвентаря либо ключ — не номер, в том числе служебный ключ записи компонента inventory (зачисление __add, пометка переноса __transfer), — нарушение: игрок отключается от игры. Принимается только перекладывание и слияние уже имеющегося; проверяется ИТОГОВЫЙ состав — присланное поверх текущего: новых вещей появиться не может, суммарное количество каждой вещи не должно вырасти, иначе — тоже нарушение. Как присланное ложится на инвентарь и куда уходит лишнее, сказано в описании компонента inventory.
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

Код команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.

Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.

<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */

// Перестановка СВОЕГО инвентаря. Валидация — контракт/анти-чит (вещь не найдена /
// количество выросло), остаётся throw — виден в логе.

// мёртвый инвентарём не управляет
if($object->components->isset('hp') && $object->components->get('hp') <= 0)
	return;

$inventory = $data['inventory'];
$currentSlots = $object->components->get('inventory');
$slotCount = Inventory::slotCount();

// Присланный состав — только номера слотов. Служебные ключи записи компонента (зачисление, пометка
// переноса) исполняет его триггер, а в тоталы ниже они не попадают — счёт идёт по позициям с вещью.
// Принятые от клиента, они зачислили бы любую вещь мимо анти-чита; серверные механики пишут
// компонент напрямую, клиентского пути у них нет по устройству механики.
foreach(array_keys($inventory) as $slot)
	if(!is_int($slot) || $slot < 1 || $slot > $slotCount)
		throw new Error('Позиция '.$slot.' вне инвентаря');

// Форма присланного слота проверяется ДО тоталов и тем же правилом, что при записи хранилища:
// тоталы суммируют количество, и слот без этого поля уронил бы подсчёт предупреждением рантайма
// раньше, чем игрок узнал бы, что именно не так. Очистка слота (пустое значение) проверки не требует.
foreach($inventory as $slot => $item)
	if(!empty($item))
		Inventory::slotCheck($item, $slot);

// Анти-чит мерит ИТОГОВЫЙ состав, а не присланный: запись компонента партиальна — непереданный
// слот триггер сохранит из текущего. Счёт по присланному даёт дюп: перенос вещи в другой слот
// без упоминания исходного оставляет его и на прежнем месте, а тоталы присланного этого не видят.
$merged = $inventory;
for($i = 1; $i <= $slotCount; $i++)
	if(!array_key_exists($i, $merged) && !empty($currentSlots[$i]))
		$merged[$i] = $currentSlots[$i];

// считаем суммарное количество каждой вещи до и после (identity — общий ключ стакуемости
// из библиотеки inventory-trade, единый алгоритм всех механик инвентаря). Имя префаба держим рядом —
// в текст ошибки идёт оно, а не identity-ключ (тот несёт ещё и слепок components и читается как мусор).
$oldTotals = [];
$newTotals = [];
$prefabs = [];

foreach($currentSlots as $slot)
{
	if(!empty($slot['prefab']))
	{
		$key = Inventory::stackKey($slot);
		$oldTotals[$key] = ($oldTotals[$key] ?? 0) + $slot['count'];
		$prefabs[$key] = $slot['prefab'];
	}
}

foreach($merged as $slot)
{
	if(!empty($slot['prefab']))
	{
		$key = Inventory::stackKey($slot);
		$newTotals[$key] = ($newTotals[$key] ?? 0) + $slot['count'];
		$prefabs[$key] = $slot['prefab'];
	}
}

// новых вещей не должно появиться, количество не должно вырасти
// (может быть меньше — лишнее уйдёт на землю дроп-веткой триггера)
foreach($newTotals as $key => $count)
{
	if(!isset($oldTotals[$key]) || $count > $oldTotals[$key])
		throw new Error(!isset($oldTotals[$key]) ? 'Вещь '.$prefabs[$key].' не найдена в инвентаре' : 'Количество вещи '.$prefabs[$key].' увеличилось');
}

$object->components->add('inventory', $inventory);
К игре