ui/dialog| Параметр | По умолчанию | Что задаёт |
|---|---|---|
intent |
обязателен | Что игрок делает с квестом: take — берёт, complete — сдаёт. Сверка намерения с состоянием квеста нужна затем, чтобы на границе срока нажатое «сдать» не исполнилось взятием заново. |
key |
обязателен | Ключ NPC, чей квест выбран, на запущенной карте. |
quest |
обязателен | Ключ квеста в квестах этого NPC (поле quest варианта разговора). |
$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']]);