quest

из группы ui/dialog
вызывает игрок
Выбор квестового варианта в разговоре: взять либо сдать квест NPC. Сам квест ведёт команда его типа (запись квеста у NPC — компонент quests): здесь проверяется, что игроку показан именно такой вариант, и игроку ставится событие команды типа с параметрами из записи квеста и тем, кто выдал квест, какой это квест и что игрок делает. Вариант принимается по тем же правилам, по которым был показан в начале разговора (ui/dialog/open): с клетки NPC либо соседней на том же этаже, только у NPC карты игрока, и намерение обязано совпасть с нынешним состоянием квеста для игрока. Исходы в момент выбора: - Игрок отошёл от NPC, выбрано взятие уже взятого квеста либо сдача квеста, который в журнале квестов ещё без признака «выполнен», — гонка: такое состояние создаёт лишь прежний шаг самого игрока; выбор не исполняется, отказ пишется в журнал предупреждений карты. - Срок истёк, начался откат, выбрана сдача квеста, которого в журнале квестов уже нет, NPC с таким ключом нет ни на карте игрока, ни на соседних либо игрок мёртв — исход механики: выбор не исполняется, в журнал предупреждений не пишется. - Квест, которого у NPC нет, NPC без квестов, NPC на соседней карте (и у мёртвого игрока тоже) либо неизвестное намерение — нарушение: игрок отключается от игры — такого варианта игроку не показывали. При гонке и исходе механики игроку ничего не приходит: ни отказа, ни ошибки. Квест у NPC соседней карты, видного у границы карт, берут и сдают лишь на его карте — начало разговора ведёт персонажа туда через границу. Событие команды типа исполняется кадром позже и проверяет всё заново: исходы того мига — в описании её команды (у квеста «принести» — quest/bring/index).
Параметры 3
Параметр По умолчанию Что задаёт
intent обязателен
Что игрок делает с квестом: take — берёт, complete — сдаёт. Сверка намерения с состоянием квеста нужна затем, чтобы на границе срока нажатое «сдать» не исполнилось взятием заново.
key обязателен Ключ NPC, чей квест выбран, на запущенной карте.
quest обязателен Ключ квеста в квестах этого NPC (поле quest варианта разговора).
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $object — сущность, выполняющая команду
  • $data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию
  • $from_client — команду прислал игрок пакетом, а не поставил код механик
  • $client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неё

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

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

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

# Выбор квестового варианта в разговоре. Квест ведёт закрытая команда его типа на игроке — её и ставим, убедившись,
# что вариант показан игроку именно таким. Исполняет сам игрок, а не NPC: ошибка в коде квеста на NPC уронила бы карту.
# Исход механики — ТИХИЙ отказ (return), НЕ throw: throw в клиентском событии фреймворк отключает игрока.

if($data['intent'] !== 'take' && $data['intent'] !== 'complete')
	throw new Error('намерение выбора квеста — take либо complete, пришло «'.$data['intent'].'» (ui/dialog/quest)');

if(!World::isset($data['key']))
	return;

$npc = World::get($data['key']);

// NPC соседней карты: разговор ведёт игрока на его карту, а окно разговора клиент закрывает, когда игрок ушёл с карты
// NPC, — выбор квеста у него присылает неверный клиент, не гонка, и мёртвым тоже (решение автора 2026-10-20).
if($npc->map != MAP_ID)
	throw new Error($npc->key.' стоит на соседней карте — квест у него берут и сдают лишь на его карте (ui/dialog/quest)');

if($object->components->isset('hp') && $object->components->get('hp') <= 0)
	return;

// Квесты NPC за игру не меняются: выбор квеста, которого у него нет, — неверная команда, не гонка.
if(!$npc->components->isset('quests') || !isset($npc->components->get('quests')[$data['quest']]))
	throw new Error('у '.$npc->key.' нет квеста «'.$data['quest'].'» — клиент не должен был его выбирать (ui/dialog/quest)');

// Та же дистанция, что у разговора: отошёл после начала разговора — выбор не принимается. Это гонка (решение автора
// 2026-10-21): клиент шлёт выбор из окна разговора, открытого рядом с NPC, и не рядом его застаёт лишь шаг самого
// игрока, исполненный раньше, — пишется в журнал предупреждений с ключом игрока.
if(!$object->position->adjacent($npc->position))
{
	$object->warning('выбор квеста «'.$data['quest'].'» у '.$npc->key.' не исполнен: игрок не рядом с NPC (ui/dialog/quest)');
	return;
}

// Та же функция, что показала варианты в начале разговора (ui/dialog/open). Запись квеста жива (квест уже взят, вещи
// для сдачи убраны), а намерение иное — состояние сменил прежний шаг самого игрока: гонка с записью в журнал
// предупреждений (решение автора 2026-10-21). Откат и запись, которой нет либо срок которой вышел, — исход механики.
$option = Methods::questOptions($object, $npc)[$data['quest']] ?? null;
if($option === null || $option['state'] !== $data['intent'])
{
	if($option !== null && ($option['state'] === 'progress' || $option['state'] === 'complete'))
		$object->warning('выбор квеста «'.$data['quest'].'» у '.$npc->key.' не исполнен: квест в состоянии '.$option['state'].', выбрано '.$data['intent'].' (ui/dialog/quest)');
	return;
}

$quest = $npc->components->get('quests')[$data['quest']];
$at = strrpos($quest['event'], '/');

// Имена npc, quest, intent команда типа обязана объявить, а описание квеста — не задавать (проверяет код компонента quests).
$object->events->add(substr($quest['event'], 0, $at), substr($quest['event'], $at + 1), $quest['data'] + ['npc' => $npc->key, 'quest' => $data['quest'], 'intent' => $data['intent']]);
К игре