InkQuest — 叙事任务引擎

为你熟悉的工具赋予力量,打造 Minecraft 中的剧情驱动任务。
InkQuest 是一款轻量级的 Minecraft 1.20.1 (Fabric) 任务引擎,专为地图制作者、整合包开发者和叙事设计师打造。它与记分板、Minecraft 谓词和数据包函数等系统协同工作——这些都是你已经掌握的系统。无需学习专有任务类型。
任务具备真正的失败状态、分阶段推进机制以及基于结果的分支选项。让你的选择有意义,让结局有所不同。
玩家体验
- 任务书 — 按
J 键或右键点击书本即可浏览所有任务:进行中的、已完成的和已失败的。每个任务均显示标题、当前任务、描述和进度。
- HUD 追踪器 — 将任务固定以使其任务和进度条始终显示在屏幕上,并带有平滑的阶段过渡和完成动画。
- 任务卷轴 — 一种通过右键点击启动任务的实体物品。可通过战利品表、交易或
/give 命令分发——玩家只需右键点击,无需执行任何命令。
- 新任务通知 — 当新任务出现时显示 HUD 提示框,按一个键即可立即打开查看。
InkQuest 的工作原理
阶段,而非复选框。 任务按顺序经历各个阶段。每个阶段有一个必做任务和任意数量的可选任务。完成必做任务即可推进;可选任务提供额外内容、奖励或叙事分支。
真实的失败机制。 任何任务都可能失败——且失败会立即结束该任务。世界会对每种结果做出不同的反应。
分支与记忆。 任务通过依赖关系相互解锁。不同的完成方式会开启不同的链条。无需编写代码即可实现完整的叙事树。
你已熟悉的条件:
| 条件 |
检查内容 |
score |
记分板目标阈值 —— 附带进度条 |
global_score |
跨多个玩家共享的全局计数器 |
predicate |
任何 Minecraft 谓词:位置、物品栏、NBT、成就…… |
all / any / none |
布尔组合,可无限嵌套 |
optionals |
当前阶段中已完成足够数量的可选任务 |
生命周期钩子。 在任务生命周期的不同阶段运行 mcfunction 文件并分配记分板标签:阶段加载时、激活期间每刻、激活且固定期间每刻、停用时的成功时以及失败时。
从这些基础元素出发——限时挑战、护送任务、带有共享计数器的全服击杀目标、阵营竞赛——一切皆基于你已理解的系统构建而成。
为地图制作者和整合包开发者打造
两种定义任务的方式:
- 数据包 (
data/<namespace>/quests/<id>.json) — 版本化、可移植、支持源代码管理。随你的项目一同发布。
- 命令 (
/quest new) — 无需退出游戏即可创建任务。适合快速迭代:在游戏中构建任务,将其连接到命令方块,立即测试。
完整的命令 API:
/quest give, complete, fail, skip, pin, unpin, drop, modify, new
/execute if quest — 在命令方块和功能文件中检查任务和任务状态
/quest query — 检查任务进度、任务状态和阶段完成情况 —— 无论任务使用哪种条件类型
手动按钮。 可为任何任务添加成功/失败/跳过按钮,让玩家直接从任务书中做出决策。
可重复任务。 一个标记即可允许从头开始重玩已完成的任务 —— 日常任务、阵营任务或任何循环任务均可适用。
游戏规则:
doQuestBookItemCheck — 要求手持书本才能打开(迫使玩家寻找或制作它)
allowManualQuestPin — 锁定玩家端的固定功能,仅允许通过命令控制 HUD
本地化。 标题和描述中完全支持 Minecraft JSON 文本格式 —— 颜色、格式化、translate 键。向资源包中添加语言文件后,任务文本将根据每位玩家的偏好语言自动适配。
资源包覆盖。 所有模组纹理均可替换。通过单个数据包文件即可覆盖合成配方。
入门指南
/quest new tutorial:intro "First Quest"
/quest give @s tutorial:intro pin
/quest modify tutorial:intro tasks add required step1 "Find the ruins"
三条命令,即可创建一个工作的固定任务。添加记分板条件、生命周期钩子或链接到下一个任务链 —— 从这里开始扩展。
→ [完整文档] · [GitHub] · [问题追踪器]
为什么选择 InkQuest
大多数任务系统提供的是预构建任务类型的菜单。而 InkQuest 将你手中已有的 Minecraft 工具——记分板、谓词、函数、标签——组合成一个没有硬编码限制的任务引擎。
任务存储在 JSON 中,与你的项目一起版本控制,并以标准数据包的形式发布。
安装模组,放入数据包 —— 你的世界便拥有了故事。
需要 Fabric 1.20.1。无其他依赖项。
InkQuest — Narrative Quest Engine

Build story-driven quests for Minecraft — using tools you already know.
InkQuest is a lightweight quest engine for Minecraft 1.20.1 (Fabric), built for map makers, pack developers, and narrative designers. It works with scoreboards, Minecraft predicates, and datapack functions — systems you already have. No proprietary task types to learn.
Quests have real failure states, stage-by-stage progression, and branching based on outcomes. Choices that mean something. Endings that differ.
What players experience
- Quest Book — press
J or right-click the book to browse all quests: active, completed, and failed. Each shows title, current task, description, and progress.
- HUD tracker — pin a quest to keep its task and progress bar always on screen, with smooth stage-transition and completion animations.
- Quest Scrolls — a physical item that starts a quest on right-click. Distribute via loot tables, trades, or
/give — the player just right-clicks, no commands on their end.
- New quest notification — a HUD toast when a quest arrives, with one key to open it immediately.
How InkQuest works
Stages, not checkboxes. A quest advances through stages in sequence. Each stage has one required task and any number of optional ones. Move forward when the required task is done; optional tasks add side content, bonus rewards, or narrative branches.
Real failure. Any task can fail — and failure ends the quest immediately. The world can react differently to each outcome.
Branching and memory. Quests unlock each other through dependencies. Different completions open different chains. Full narrative trees, no code required.
Conditions you already know:
| Condition |
What it checks |
score |
Scoreboard objective threshold — with progress bar |
global_score |
A shared global counter, safe across multiple players |
predicate |
Any Minecraft predicate: location, inventory, NBT, advancement… |
all / any / none |
Boolean composition, nested arbitrarily deep |
optionals |
Enough optional tasks in the current stage are done |
Lifecycle hooks. Run mcfunction files and assign scoreboard tags at different points in a task's life: when the stage loads, every tick while active, every tick while active and pinned, when it deactivates, on success, and on failure.
From these primitives — timed challenges, escort missions, server-wide kill goals with shared counters, faction races — all build from systems you already understand.
For map makers and pack developers
Two ways to define quests:
- Datapack (
data/<namespace>/quests/<id>.json) — versioned, portable, source-controlled. Ships with your project.
- Commands (
/quest new) — create quests without leaving the game. Good for rapid iteration: build a quest in-game, wire it to command blocks, test immediately.
Full command API:
/quest give, complete, fail, skip, pin, unpin, drop, modify, new
/execute if quest — check quest and task status in command blocks and functions
/quest query — inspect task progress, quest state, and stage completion — regardless of which condition type the task uses
Manual buttons. Add Success / Failure / Skip buttons to any task for player-driven decisions right from the quest book.
Repeatable quests. One flag to allow replaying a completed quest from scratch — daily tasks, faction missions, anything cyclical.
Gamerules:
doQuestBookItemCheck — require holding the book to open it (make players find or craft it)
allowManualQuestPin — lock player-side pinning so only commands control the HUD
Localization. Full Minecraft JSON Text in all titles and descriptions — colors, formatting, translate keys. Add a lang file to a resource pack and quest text adapts to each player's language.
Resource pack override. All mod textures replaceable. Craft recipe overridable via a single datapack file.
Getting started
/quest new tutorial:intro "First Quest"
/quest give @s tutorial:intro pin
/quest modify tutorial:intro tasks add required step1 "Find the ruins"
Three commands, one working pinned quest. Add a scoreboard condition, a lifecycle hook, or a chain to the next quest — it scales from there.
→ [Full documentation] · [GitHub] · [Issue tracker]
Why InkQuest
Most quest systems give you a menu of pre-built task types. InkQuest hands you the tools Minecraft already provides — scoreboards, predicates, functions, tags — and composes them into a quest engine with no hardcoded limits.
Quests live in JSON, version alongside your project, and ship as a standard datapack.
Install the mod, drop in a datapack — and your world has a story.
Requires Fabric 1.20.1. No additional dependencies.
评论 0
登录后参与评分
还没有评论,来抢沙发吧