$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;