黑波的任务树

黑波的任务树

在一张地图上打开任务和技能树,与团队共享进度,并导入现有的FTB Quests或Pufferfish书籍。

在一个地图上打开任务与技能树,与团队共享进度,并将整合包的两部分都集中在一处。

任务书与技能树通常来自不同的模组,并位于不同的界面中。Kuronami 的 Quest Tree 从数据包中读取两者,并将它们绘制在一起:章节、依赖关系、任务、奖励、技能点和等级都位于同一张地图上,并共享相同的搜索、缩放、图钉和物品提示功能。

界面功能

  • 任务与技能合一 —— 一个任务章节和一个技能章节都是章节。依赖关系、可选任务、互斥分支、可重复任务和点数消耗在两者中的运作方式相同。
  • 游玩时的进度 —— 按 J 键在游戏画面旁显示追踪器。它会列出你已固定的任务,并在完整模式下显示你当前打开章节中的下一个任务。当任务发生变化时,快捷栏上方的通知会以与任务界面相同的卡片样式显示任务、目标和数量,或你持有的数量。
  • 团队进度 —— 使用整合包已有的 FTB Teams 队伍,或在未安装 FTB Teams 时使用内置的队伍命令。队伍共享完成状态;已领取的奖励仍归领取它的玩家所有。
  • 游戏内创作 —— 开启编辑模式,添加和移动节点,编辑任务、奖励、条件、章节和奖励表,然后将任务书导出为数据包。编辑器在写入前会进行校验,并拒绝基于旧版本的编辑,而不会覆盖其他作者的修改。
  • 导入与迁移 —— 将现有的 FTB Quests 任务书或 Pufferfish's Skills 技能树转换为数据包,并将玩家现有的进度复制到团队记录中。无法迁移的设置会被列出,而不是被猜测。来自其他 FTB 附加模组的任务和奖励会按原样保留,因此处理该类型的模组可以接续它们;在此之前,它们不会阻碍任务完成。
  • 配方查看器与提示 —— JEI、REI 和 EMI 会以任务界面的风格将任务和战利品箱绘制为卡片:任务卡片显示任务名称、章节和状态,并标记该物品是所需还是奖励;箱子卡片显示其奖励表及可随机到的奖励,过长的名称在卡片内以省略号结尾,而不会溢出卡片。配方查看器可以从物品打开任务;描述可以打开配方、另一个任务或链接。物品提示会显示哪些任务需要该物品。
  • 箱子概率与保底 —— 箱子卡片在 JEI、REI 和 EMI 中显示每个奖励的概率,奖励表可以在连续未中后保证一个条目。
  • 纸张主题 —— 设置界面可将整个界面切换为浅色纸张外观。文本以及导入名称和描述中的颜色代码会在浅色背景上加深,直到清晰可读。主题是一组资源包文件,因此整合包可以对其重新设计样式。
  • 限制 —— 整合包可以封锁某个物品或方块,直到任务、阶段、分数、物品、进度或队伍人数允许为止。被封锁的物品无法装备、使用、用于攻击、放置、破坏或在合成网格中合成,原因会显示在快捷栏上方。
  • 扩展点 —— 其他模组可以注册任务、奖励和条件类型,选择它们在任务界面中的行外观,声明游戏内编辑器为其显示的字段,并监听完成、领取和任务事件。未声明字段的类型以 JSON 编辑。KubeJS 脚本可在 NeoForge 上实现相同功能。

任务书物品可从物品栏打开界面。在世界中,任务方块打开单个任务,屏障方块控制进度,检测器方块将红石脉冲转换为附近每个玩家的进度,任务屏幕接受来自其他模组管道的物品、流体和能量交付。战利品箱是整合包填充了奖励表的物品:使用它以随机抽取奖励表,或潜行以随机抽取整组;开箱器从漏斗中取出箱子,随机抽取并保留输出供漏斗抽取。安装 Jade 后,任务屏障的悬浮提示会显示它要求什么以及你是否可以通过。

数据与命令

章节、奖励表、组、补丁和翻译位于 data/<namespace>/progression/ 下。整合包可以自带任务书,或在不复制整个文件的情况下修补另一个整合包或模组提供的章节。

整合包作者最常用的命令:

  • /quest_tree import ftbquests [namespace] 和 /quest_tree import puffish [namespace] —— 将转换后的任务书写入世界的数据包并重新加载。
  • /quest_tree edit —— 为你自己开启或关闭游戏内编辑器。
  • /quest_tree migrate ftbquests [namespace] dry_run 然后 apply —— 将现有玩家进度复制到团队记录中。Pufferfish's Skills 也有相同的命令对。
  • /quest_tree validate —— 列出错误和警告,包括本整合包无法完成的任务,按章节分组。

原始 FTB Quests 和 Pufferfish's Skills 文件仅被读取。导入会写入单独的数据包,迁移在更改任何内容前会保留进度文件的备份。

依赖与限制

  • FTB Teams 是可选的。没有它时,玩家可以通过 /quest_tree party 组建队伍;没有队伍时,玩家单独进行进度。
  • currency 奖励需要一个向 FTB Library 注册提供者的经济模组。trophy 奖励需要 Kuronami's Trophies;没有它时该奖励不产生效果,也不会阻碍该任务上的其他奖励。
  • 迁移是合并操作。它会合并集合并保留较大的计数器;不会移除进度。除非强制,否则同一来源的第二次应用会被拒绝,因为重放它可能会恢复被有意清除的状态。
  • KubeJS 集成仅限 NeoForge。
  • 本书授予的阶段在两个加载器上均有效。其他模组或命令设置的阶段需要 Pack Stages,而在 1.21.1 上该模组仅支持 NeoForge。
  • 能量任务需要能量 API:NeoForge 自带一个,在 Fabric 上则需要 Team Reborn Energy。
  • 导入、迁移和编辑会写入世界。在人们已在游玩的整合包上使用它们之前,请备份世界。

Support my mods on Patreon Follow @kuronami333 on X Watch KURONAMI on YouTube

保留所有权利。可免费放入任何整合包、任何平台,无论是否盈利 —— 无需许可,无需署名。其他模组可以使用公共 API 构建附加组件;请勿将本模组的 jar 打包进其中。本模组的数据包、资源包、任务书、翻译、配置和 KubeJS 脚本可以制作和分享,包括在付费整合包中。源代码已公开,以便你确切了解它的功能。

Bug 与问题:在 CurseForge 页面评论,或在 X 上私信 @kuronami333。

源代码:https://github.com/KURONAMI333/kuronami-quest-tree