InkQuest

模组

· 作者 bigpixellab

一款以叙事为核心的任务引擎,专为地图制作者和整合包开发者设计——完全通过数据包和命令来定义具有成功与失败结局的分支任务。

0 本站下载 0 关注 更新于 5 个月前

需要前置:Fabric API

最新 1.0.0 · 1.20.6 · Fabric

一键开服(送7天)

InkQuest — 叙事任务引擎

Quest Book & HUD

为你熟悉的工具赋予力量,打造 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。无其他依赖项。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源