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