index

из группы quest/bring
Квест «принести N вещей». Событие ставит игроку выбор квестового варианта в разговоре (команда ui/dialog/quest) — он же задаёт параметры intent, npc и quest; исполняется событие кадром позже. Взять — квест ложится в журнал квестов игрока (компонент quest_log) со сроком на выполнение, признак «выполнен» считается сразу (нужное бывает в инвентаре уже при взятии). Сдать — у игрока снимается N вещей и выдаётся награда, запись уходит из журнала квестов; что сдать и какую награду выдать, решают параметры, записанные в журнал квестов при взятии. Награде место в инвентаре не нужно: без места она падает игроку под ноги. Взятие и сдача дают NPC откат (группа quest/cooldown). В момент исполнения всё перепроверяется по тем же правилам, по которым вариант был показан игроку; любой отказ — без изменений. Исходы в момент самого выбора варианта — в описании команды ui/dialog/quest; в момент исполнения исходы такие: - Гонка — выбор устарел из-за прежнего шага самого игрока: игрок отошёл от NPC, NPC больше нет ни на карте игрока, ни на соседних либо он стоит теперь на соседней карте (игрок за этот кадр ушёл через границу карт), пришло взятие уже взятого квеста, сдача квеста без признака «выполнен» либо на сдаче не хватает вещей; отказ пишется в журнал предупреждений карты. - Срок истёк, начался откат либо на сдаче квеста в журнале квестов уже нет — исход механики, в журнал предупреждений не пишется.
Параметры 8
Параметр По умолчанию Что задаёт
cooldown обязателен Откат NPC в секундах; ноль — без отката.
intent обязателен take — взять квест, complete — сдать.
npc обязателен Ключ NPC, выдавшего квест, на запущенной карте.
quest обязателен Ключ квеста в квестах этого NPC.
term обязателен Срок на выполнение в секундах с момента взятия.
prefab обязателен Какую вещь принести — префаб.
reward обязателен Награда за сдачу — вещь: словарь из prefab (префаб вещи) и count (сколько штук, больше нуля). Монеты — тоже вещь, их префаб называется явно.
count обязателен Сколько штук принести.
Кому доступна
player
Что делает команда — код, который выполняется при её срабатывании
Что платформа подаёт в код
Код исполняется телом функции, и платформа подаёт в него эти переменные:
  • $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']);
К игре