quest_log

словарь со своим кодом
Журнал квестов игрока: словарь «идентификатор сущности NPC, выдавшего квест → ключ квеста у этого NPC → запись». В записи event и data — команда типа квеста и параметры, с которыми квест взят, кроме отката NPC: сдачу решают они, а не нынешняя запись квеста у NPC (компонент quests), откат же и при сдаче берётся из нынешней записи квеста; map, x, y и prefab — карта и клетка, где стоит NPC, и его префаб: по ним журнал квестов называет NPC, а мини-карта и обзорная карта мира ставят на месте его метки знак квеста и тогда, когда NPC не видно; until — момент конца срока календарным временем сервера в секундах, поэтому срок идёт и пока игрока нет в игре; done — условия квеста выполнены, его можно сдать. Истёкшая запись в игре не действует: взять, сдать либо ждать по ней ничего нельзя, хотя в значении она лежит до появления игрока на карте либо до следующей записи журнала. Клиент сверяет срок со своими часами лишь для показа. Значение уходит только своему игроку и при каждой смене целиком: снятая запись иначе до клиента не дошла бы. Неверная форма записи отбивается кодом компонента — с тем же исходом, что неверная скорость (описание компонента speed).
Стартовое значение
пусто
Сущность получает компонент пустым: ноль у числа, пустая строка у текста, пустой набор у списка.
Кому выдаётся
player
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

Записано будет то, что лежит в $value после кода: платформа возвращает его сама, свой return тоже годится — так значение правят перед записью либо отказывают в смене. Пустое значение выражается пустой строкой либо пустым набором, null запрещён. Код срабатывает на смену значения и на появление сущности на карте; повторная запись прежнего значения его не запускает. В коде компонента менять компоненты нельзя, ставить события можно.

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

<?php
# Журнал квестов игрока; форма записи — в описании компонента. Пишут его команды типа квеста. Срок обязан идти и без игрока в игре, а время команд вне игры стоит, потому конец срока лежит
# в записи календарным временем сервера (until) и сам не наступает ничем — его сверяет $alive ниже.
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */

// Жива ли запись. Журнал читают только чистка ниже и квестовые варианты: прочие места (разговор, выбор
// варианта, команды типа квеста) спрашивают состояние квеста вариантами, а не сверяют срок сами.
$alive = static fn(array $entry): bool => $entry['until'] > time();

// Квестовые варианты разговора игрока с NPC и состояние каждого для этого игрока: take — можно взять,
// progress — взят и не выполнен, complete — можно сдать, cooldown — NPC на откате (остаток — у его группы
// quest/cooldown, клиент получает его рассылкой). Одна функция на сборку разговора, выбор варианта и
// команды типа квеста: исполниться обязано ровно то, что игроку показали. Кладёт её журнал, а не разговор
// NPC: журнал есть у каждого говорящего игрока своей карты, а код компонента копии NPC с соседней карты
// здесь не срабатывает. NPC соседней карты квестов не даёт: квест берут и сдают лишь на карте NPC (решение
// автора 2026-10-20), а откат пишется паузой его группы, которую копии не записать.
if(!Methods::hasMethod('questOptions'))
	Methods::addMethod('questOptions', static function(EntityAbstract $player, EntityAbstract $npc) use ($alive): array
	{
		if($npc->map != MAP_ID || !$npc->components->isset('quests'))
			return [];

		$log = $player->components->get('quest_log')[$npc->slug] ?? [];
		$cooldown = $npc->events->isset('quest/cooldown') && $npc->events->get('quest/cooldown')->remainTime(Data::monotime()) > 0;

		$options = [];
		foreach($npc->components->get('quests') as $key => $quest)
		{
			if(isset($log[$key]) && $alive($log[$key]))
				$state = $log[$key]['done'] ? 'complete' : 'progress';
			else
				$state = $cooldown ? 'cooldown' : 'take';

			$options[$key] = ['text' => $quest['text'], 'quest' => $key, 'state' => $state];
		}

		return $options;
	});

if(!is_array($value))
	throw new Error($object->key.': компонент quest_log задаётся словарём {slug NPC: {ключ квеста: запись}}');

foreach($value as $npc => $quests)
{
	if(!is_string($npc) || !is_array($quests))
		throw new Error($object->key.': журнал квестов — словарь по slug NPC, у «'.$npc.'» не словарь его квестов');

	foreach($quests as $quest => $entry)
	{
		if(!is_string($quest) || !is_array($entry) || array_diff(array_keys($entry), ['event', 'data', 'map', 'prefab', 'x', 'y', 'until', 'done']) || !isset($entry['event'], $entry['data'], $entry['map'], $entry['prefab'], $entry['x'], $entry['y'], $entry['until'], $entry['done']) || !is_string($entry['event']) || !is_array($entry['data']) || !is_int($entry['map']) || !is_string($entry['prefab']) || !is_int($entry['x']) || !is_int($entry['y']) || !is_int($entry['until']) || !is_bool($entry['done']))
			throw new Error($object->key.': запись журнала квестов '.$npc.'/'.$quest.' — словарь ровно из event и prefab (строки), data (словарь), map, x, y и until (целые), done (да либо нет)');

		// Истёкшее для читателей уже отсутствует, а из значения уходит здесь — при входе игрока и при
		// каждой записи журнала: иначе копилось бы в сохранении игрока.
		if(!$alive($entry))
			unset($value[$npc][$quest]);
	}

	if(empty($value[$npc]))
		unset($value[$npc]);
}

return $value;
К игре