InkQuest — Narrative Quest Engine¶

InkQuest — система квестов для Minecraft 1.20.1 (Fabric), ориентированная на нарративный геймплей. Квест здесь — это сюжетное событие с развитием: он проходит этапы, может завершиться успехом, провалом или быть пропущен. Вся конфигурация ведётся через JSON-датапаки и команды.

InkQuest не ограничен типами задач вроде "убей X монстров". Любая механика реализуется через scoreboard-условия, predicate Minecraft и функции датапаков. Квесты версионируются, распространяются в составе датапака и глубоко интегрируются с ванильными механиками Minecraft.

С чего начать¶

Если ты здесь впервые — открой Быстрый старт и собери первый квест за пять минут. Дальше документация устроена так, что её не нужно читать подряд: каждый раздел отвечает на свой тип вопроса. Ищи свою колонку ниже.

Содержание¶

Начало¶

Быстрый старт — первый квест командами и через датапак.

Как устроены квесты¶

Понять модель — что вообще такое квест и по каким правилам он живёт.

Структура квеста — этапы, задачи, исходы.
Активный этап — какой этап «сейчас» и как он сдвигается.
Статусы квестов и задач — active, complete, success/failure.
Зависимости между квестами — как один квест открывает другой (after, require).
Повторяемые квесты — квест, который можно пройти заново.
Закрепление — как квест попадает в HUD и кто этим управляет.

Справочник датапака¶

Точные поля JSON — чтобы посмотреть «как именно записать».

Формат файла квеста — полный список полей квеста и задачи, версии формата, текст и стили.
Условия выполнения задачи — автозавершение: score, predicate, all/any/none, tasks, кнопки.
Хуки жизненного цикла задачи — запуск функций и выдача тегов на события задачи.
Предметы в датапаке — рецепт книги, привязка свитка к квесту, геймрул doQuestBookItemCheck.

Что видит игрок¶

Интерфейс игрока — HUD, книга квестов, уведомления.
Предметы — книга и свиток квеста, gamerule открытия.

Командное API¶

Справочник команд — все команды /quest и /execute if quest.
Интеграция с командами — квест как читаемое состояние; связка с командными блоками и scoreboard.

Паттерны квестов¶

Паттерны квестов — заметка в дневнике, цепочка, развилка, ивент с общим прогрессом и др.

Решение проблем¶

Частые вопросы и ошибки — что делать, если квест не загрузился или условие не сработало.