index

из группы quest/recount
Пересчитывает у записей журнала квестов признак «выполнен» по нынешнему составу инвентаря: у квеста «принести» — хватает ли нужной вещи в нужном количестве. Журнал пишется, лишь когда признак у какой-то записи сменился. Событие этой команды ставят код компонента inventory при каждой смене инвентаря и взятие квеста — условие бывает выполнено уже в момент взятия.
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

# Признак «выполнен» у записей журнала квестов: из кода компонента инвентаря менять журнал нельзя, потому
# пересчёт — командой. Сдача признаку не верит и проверяет предметы сама — признак нужен показу у клиента.

$log = $object->components->get('quest_log');
$inventory = $object->components->get('inventory');
$changed = false;

foreach($log as $npc => $quests)
	foreach($quests as $quest => $entry)
	{
		if($entry['event'] !== 'quest/bring/index')
			continue;

		// Хватает ли предмета — тем же списанием, что у сдачи: разойдись правила, «выполнен» обещал бы сдачу,
		// которую сдача отклонит.
		$done = Inventory::take($inventory, $entry['data']['prefab'], (int)$entry['data']['count']) !== null;

		if($done !== $entry['done'])
		{
			$log[$npc][$quest]['done'] = $done;
			$changed = true;
		}
	}

if($changed)
	$object->components->add('quest_log', $log);
К игре