quests

словарь видно другим игрокам со своим кодом
Квесты, которые выдаёт эта сущность: словарь «ключ квеста → запись квеста». У записи text — надпись варианта, которым игрок берёт квест в разговоре; event — команда типа квеста (категория quest), которую получит взявший; data — её параметры. Среди параметров обязательны срок на выполнение (term) и откат NPC (cooldown). Параметры npc, quest и intent записи квеста не задаются — кто их ставит, сказано в описании команды типа квеста. Квесты — черта конкретной сущности: их задают у каждой сущности карты, у префаба значение пустое. Значение рассылается всем видящим: по нему клиент узнаёт квестодателя до разговора и показывает условия квеста. Неверная форма — например, команды нет, её может вызвать сам игрок либо она не разрешена игроку, параметр не объявлен командой, обязательный не задан, срок не положителен, у квеста «принести» награда не вещь с количеством больше нуля — отбивается кодом компонента при появлении сущности на карте и при каждой смене значения: карта с такой сущностью не запускается, а смена значения по ходу игры роняет работающую карту; запись об ошибке ложится в журнал ошибок песочницы карты.
Стартовое значение
пусто
Сущность получает компонент пустым: ноль у числа, пустая строка у текста, пустой набор у списка.
Кому выдаётся
npc trader
Каждая сущность этих видов получает компонент при создании.
Код компонента — срабатывает, когда значение меняется, и когда сущность появляется на карте
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, которой присваивают значение компонента
  • $value — присваиваемое значение; в самом компоненте на этот момент ещё лежит прежнее

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

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

<?php
# Квесты, которые выдаёт NPC: запись на квест называет команду типа квеста и её параметры. Взявшему игроку
# эту команду ставит выбор варианта в разговоре, дописав свои параметры. Форму проверяем здесь: ошибка автора
# иначе всплыла бы у игрока в момент взятия, а не при появлении NPC на карте.
/** @var array $value входящее значение, прокинуто closure-обёрткой ComponentCollection::trigger */

// Параметры команды типа, которые ставит выбор варианта в разговоре, а не описание квеста.
$own = ['npc', 'quest', 'intent'];

if(!is_array($value))
	throw new Error($object->key.': компонент quests задаётся словарём {ключ квеста: {text, event, data}}');

$groups = EventCollection::list();

foreach($value as $key => $quest)
{
	if(!is_string($key))
		throw new Error($object->key.': ключ квеста «'.$key.'» — слово, не число: им квест адресуют разговор и журнал');

	if(!is_array($quest) || array_diff(array_keys($quest), ['text', 'event', 'data']) || !isset($quest['text'], $quest['event'], $quest['data']) || !is_string($quest['text']) || $quest['text'] === '' || !is_string($quest['event']) || !is_array($quest['data']))
		throw new Error($object->key.': квест «'.$key.'» — словарь ровно из text (надпись варианта взятия), event (команда типа квеста) и data (её параметры)');

	$at = strrpos($quest['event'], '/');
	$group = $at ? substr($quest['event'], 0, $at) : '';
	$action = $at ? substr($quest['event'], $at + 1) : '';

	if(empty($groups[$group]->event[$action]))
		throw new Error($object->key.': команды «'.$quest['event'].'» квеста «'.$key.'» нет в игре — event задаётся «категория/группа/команда»');

	if(!isset($groups[$group]->entity[EntityTypeEnum::Player->value]))
		throw new Error($object->key.': команда «'.$quest['event'].'» квеста «'.$key.'» не разрешена игроку');

	$event = $groups[$group]->event[$action];

	// Открытую команду игрок отдал бы сам, мимо разговора: взял бы чужой квест либо сдал невзятый.
	if($event->isPublic)
		throw new Error($object->key.': команда «'.$quest['event'].'» квеста «'.$key.'» открыта клиенту — тип квеста ставится только выбором варианта в разговоре');

	foreach($own as $name)
	{
		if(!isset($event->param[$name]))
			throw new Error($object->key.': команда «'.$quest['event'].'» квеста «'.$key.'» не объявляет параметр '.$name.' — его ставит выбор варианта в разговоре');

		if(array_key_exists($name, $quest['data']))
			throw new Error($object->key.': параметр '.$name.' квеста «'.$key.'» ставит выбор варианта в разговоре, описанию квеста он не задаётся');
	}

	if($unknown = array_diff(array_keys($quest['data']), array_keys($event->param)))
		throw new Error($object->key.': команда «'.$quest['event'].'» квеста «'.$key.'» не объявляет параметров '.implode(', ', $unknown));

	foreach($event->param as $name => $param)
		if($param->default === null && !in_array($name, $own, true) && !array_key_exists($name, $quest['data']))
			throw new Error($object->key.': квесту «'.$key.'» не задан обязательный параметр '.$name.' команды «'.$quest['event'].'»');

	// Срок нужен журналу каждого квеста, откат — паузе NPC: без них квест не взять и не сдать ни одного типа.
	if(!isset($quest['data']['term']) || !is_numeric($quest['data']['term']) || $quest['data']['term'] <= 0)
		throw new Error($object->key.': квесту «'.$key.'» нужен срок на выполнение term — число секунд больше нуля');

	if(!isset($quest['data']['cooldown']) || !is_numeric($quest['data']['cooldown']) || $quest['data']['cooldown'] < 0)
		throw new Error($object->key.': квесту «'.$key.'» нужен откат cooldown — число секунд, ноль либо больше');

	// Награда «принести» ложится в инвентарь записью той же формы, что вещь: неверная иначе всплыла бы
	// лишь у взявшего, со снятием его с карты.
	if($quest['event'] === 'quest/bring/index')
	{
		$reward = $quest['data']['reward'];

		if(!is_array($reward) || array_diff(array_keys($reward), ['prefab', 'count']) || !isset($reward['prefab'], $reward['count']) || !is_string($reward['prefab']) || $reward['prefab'] === '' || !is_numeric($reward['count']) || (int)$reward['count'] <= 0)
			throw new Error($object->key.': награда reward квеста «'.$key.'» задаётся вещью {prefab, count} с количеством больше нуля');
	}
}

return $value;
К игре