任务框架

创作者: aedenthorn
已更新:2025-10-31 03:05:15
9KB

关于此 MOD

用于组织和展示任务的简单框架。
此模组旨在为《英灵神殿》实现各类任务提供一种途径。

关于它的工作原理示例,请参见:


这个模组有两个基本功能——显示任务和组织任务。


显示任务

任务可以有名称和描述;每个任务阶段可以有自己的名称和描述;而每个阶段中的目标也可以有名称和描述。

配置中包含用于显示这些内容的模板,以及显示区域的主要页眉。如果任务缺少某个字段,则相应的模板将被忽略。

模板支持富文本标签,如<color=#xxxxxx>、<b>、<i>、<size=xx>。

显示可通过自定义快捷键进行切换(默认 j)。可通过鼠标拖拽移动。


整理任务

如果你不是模组制作者,可以跳过本节。

基本上,模组会实现自己的任务功能,并依赖本模组来告知玩家已拥有哪些任务,以及这些任务的状态。任务信息保存在 BepInEx\plugins\QuestFramework\ 作为每种格式的二进制文件 玩家世界 组合。

任务操作

将此模组的dll设置为你的模组的依赖项,并使用 QuestFrameworkAPI 用于访问当前玩家任务的类。

  • 获取当前任务() 获取以任务ID为键的任务字典。
  • 按ID获取任务(string ID) 获取由ID指定的任务,若该任务对玩家未激活则返回空值。
  • AddQuest(QuestData qd, bool force = false) 添加一个任务。要更新现有任务, 强制 必须是 true.返回 true 如果成功的话。
  • 移除任务(字符串ID) 从玩家的任务列表中移除一个任务。返回 真 如果成功的话。
  • IsQuestActive(string ID) 返回 true 如果任务对本地玩家处于激活状态。
  • ChangeStage(string questID, string stageID) 为指定任务设置当前阶段。返回 真的 如果成功的话。
  • GetCurrentStage(string questID) 返回指定任务的当前阶段ID。

你也可以直接在以下位置查看此模组的任务词典: QuestFramework.BepInExPlugin.currentQuests.questDict.


任务格式

使用 QuestFramework.QuestData 用于向模组提交任务的类别。

  • quest_data_name
  • string QuestData.desc
  • string QuestData.ID - 任务唯一标识符
  • string QuestData.currentStage
  • Dictionary<string, object> QuestData.data - 特定于你的任务模组中任务的一组任意数据(例如进度等)。
  • Dictionary<string, QuestStage> QuestData.questStages

任务阶段 职业

  • 任务阶段名称
  • string QuestStage.desc
  • string QuestStage.ID - 此阶段的唯一ID
  • Dictionary<string, object> QuestStage.data - 一组任意数据,特定于您的任务模组中的任务(例如,进度等)。
  • Dictionary<string, QuestObjective> QuestStage.objectives

任务目标
职业

  • 任务目标名称
  • string QuestObjective.desc
  • string QuestObjective.ID - 阶段的唯一标识
  • Dictionary<string, object> QuestObjective.data - 特定于你的任务模组任务的一组任意数据(例如进度等)。


控制台命令

任务框架重置 - 重置模组配置

questframework end <index> - 放弃任务(使用列表获取任务的索引)

任务框架 列表 - 获取活动任务索引列表

questframework clear 放弃所有任务



配置

一份配置文件 BepInEx/config/aedenthorn.QuestFramework.cfg 在安装此模组并运行一次游戏后生成。

你可以通过使用文本编辑器编辑此文件或在游戏内进行调整配置值,来修改这些配置参数。 配置管理器.


技术

要安装这个模组,最简单的方式就是直接使用 涡流,Nexus Mods 模组管理器。它会自动处理所有依赖项。

要手动安装,请将dll文件放入BepInEx/plugins文件夹。你需要先安装BepInEx。

代码位于 https://github.com/aedenthorn/ValheimMods.

如果你想提出建议、寻求帮助,或者帮我测试模组,可以访问 我的Discord服务器.

点击此处查看我所有的Valheim模组列表。

Valheim: 英灵神殿 的热门 MOD

探索适用于 Valheim: 英灵神殿 的最佳MOD,带来新功能、升级画面,以及令人兴奋的方式来改变您的游戏体验。

使用 Xmod 解锁 Valheim: 英灵神殿 的全部潜力 — 今天就探索这些顶级 MOD!