quest/bring| Параметр | По умолчанию | Что задаёт |
|---|---|---|
cooldown |
обязателен | Откат NPC в секундах; ноль — без отката. |
intent |
обязателен | take — взять квест, complete — сдать. |
npc |
обязателен | Ключ NPC, выдавшего квест, на запущенной карте. |
quest |
обязателен | Ключ квеста в квестах этого NPC. |
term |
обязателен | Срок на выполнение в секундах с момента взятия. |
prefab |
обязателен | Какую вещь принести — префаб. |
reward |
обязателен | Награда за сдачу — вещь: словарь из prefab (префаб вещи) и count (сколько штук, больше нуля). Монеты — тоже вещь, их префаб называется явно. |
count |
обязателен | Сколько штук принести. |
$object — сущность, выполняющая команду$data — параметры команды: ключ — slug параметра; непереданные приходят со своим значением по умолчанию$from_client — команду прислал игрок пакетом, а не поставил код механик$client_origin — цепочку начал игрок: признак наследуют и события, которые код поставит по ходу неёКод команды ничего не возвращает. Менять компоненты и свойства можно только у своей сущности.
Кроме них коду доступны классы фреймворка игры и подключённых к ней библиотек — их зовут по имени класса; что именно они умеют, сказано на их страницах.
<?php
/** @var EntityAbstract $object @var array $data @var bool $from_client */
# Квест «принести N предметов». Ставит команду только выбор квестового варианта (ui/dialog/quest); с выбора
# прошёл кадр, потому всё перепроверяется здесь. Гонка (выбор обошёл свой же шаг игрока: отход, переход границы,
# смена состояния квеста) — ТИХИЙ отказ с записью в журнал, исход механики (срок, откат) — без записи; все
# проверки — до первой записи.
// NPC пропал из мира игрока между выбором варианта и этим кадром: команды игрока едут с ним при переходе
// на другую карту (код выхода игры), а на несоседней карте этого NPC нет. Гонка, не ошибка клиента: пишется
// в журнал предупреждений с ключом игрока.
if(!World::isset($data['npc']))
{
$object->warning('квест «'.$data['quest'].'» не исполнен: NPC '.$data['npc'].' больше не видно (quest/bring/index)');
return;
}
$npc = World::get($data['npc']);
// Игрок успел отойти: выбор варианта проверил дистанцию кадром раньше, а движение, отданное следом, идёт
// своей группой и за этот кадр уводит с соседней клетки. Гонка, не ошибка клиента: пишется в журнал
// предупреждений с ключом игрока (решение автора 2026-10-21).
if(!$object->position->adjacent($npc->position))
{
$object->warning('квест «'.$data['quest'].'» у '.$npc->key.' не исполнен: игрок не рядом с NPC (quest/bring/index)');
return;
}
// Та же функция, что показала вариант и приняла выбор. NPC теперь на соседней карте (игрок за этот кадр перешёл
// границу) либо запись квеста жива, а намерение иное (квест уже взят, вещи для сдачи убраны), — вариант сменил
// прежний шаг самого игрока: гонка с записью в журнал предупреждений (решение автора 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 === null ? 'NPC на соседней карте' : 'квест в состоянии '.$option['state'].', выбрано '.$data['intent']).' (quest/bring/index)');
return;
}
$log = $object->components->get('quest_log');
if($data['intent'] === 'take')
{
// Форму награды проверил код компонента quests при появлении NPC на карте.
$log[$npc->slug][$data['quest']] = [
'event' => 'quest/bring/index',
'data' => ['prefab' => $data['prefab'], 'count' => (int)$data['count'], 'reward' => ['prefab' => (string)$data['reward']['prefab'], 'count' => (int)$data['reward']['count']], 'term' => (int)$data['term']],
'map' => (int)MAP_ID,
'prefab' => (string)$npc->prefab,
'x' => (int)$npc->position->x,
'y' => (int)$npc->position->y,
'until' => time() + (int)$data['term'],
'done' => false,
];
$object->components->add('quest_log', $log);
// Признак «выполнен» — тем же пересчётом, что после смены инвентаря.
$object->events->add('quest/recount', 'index');
}
else
{
// Сдачу решают параметры, записанные при взятии, а не нынешнее описание квеста у NPC.
$entry = $log[$npc->slug][$data['quest']]['data'];
// Признак мог отстать от инвентаря — предметы проверяются заново. Убрать их успел лишь прежний шаг самого игрока:
// гонка с записью в журнал предупреждений.
$changes = Inventory::take($object->components->get('inventory'), $entry['prefab'], $entry['count']);
if($changes === null)
{
$object->warning('квест «'.$data['quest'].'» у '.$npc->key.' не сдан: вещей для сдачи уже нет (quest/bring/index)');
return;
}
unset($log[$npc->slug][$data['quest']]);
// __transfer: сданное ушло NPC, а не выброшено на землю. Награду кладёт зачисление той же записи: место
// ищется по составу после списания, некуда — награда падает игроку под ноги.
$object->components->add('inventory', $changes + ['__add' => [['item' => $entry['reward']]], '__transfer' => true]);
$object->components->add('quest_log', $log);
}
// Откат NPC — и взятием, и сдачей: пока он идёт, NPC не выдаёт ни одного квеста никому.
$npc->events->get('quest/cooldown')->resetTime((float)$data['cooldown']);