打开任务

打开任务

为Hytale打造的模块化可扩展任务系统。只需点击几下,即可直接在资源编辑器中创建任何你能想象的任务。

游戏玩法

OpenQuests

⚔️ 为你的 Hytale 服务器提供完整的任务系统。在资源编辑器中设计任务,把插件放入 mods/,你的玩家就有事可做了。

无需编写代码。以下所有功能开箱即用。

Discord GitHub

The quest tracker showing a composite quest: Introduction, holding Master the basics with its four gathering and crafting steps, an OR rule, and Skip Intro

你可以随心所欲地嵌套任务,并用 AND 和 OR 将它们串联起来,实现真正的分支式进度。用剑击败守护者,或者另寻他路。

📦 想看看实际效果? 在 OpenQuests 旁边安装 OpenQuests Examples:现成的任务线,提供英文和法文版本,服务器启动后就会交到你的玩家手中。


✨ 你将获得

📝 一切都在资源编辑器中完成。 自动补全、校验和内联定义,让整条任务链容纳在一个文件中。

🧩 任务由任务构成。 一个步骤就是一个任务,和其他任务一样拥有自己的奖励。你可以根据故事需要任意深度地嵌套。

🔀 分支路径。 OR 让玩家自行选择通过章节的方式,AND 则要求完成所有内容。

📖 带章节的任务日志。 /ojournal 将你的任务按章节整理,并以地图形式绘制它们之间的通往关系,再次打开时会回到你上次离开的位置。

🖼️ 任务文本清晰易读。 每个任务都有图标、在 HUD 上准确说明该做什么的短句,以及讲述故事的描述,支持段落、斜体和颜色。

📊 追踪器 HUD。 标题、计数器、嵌套和计时器,与截图完全一致。玩家可以隐藏或移动它,服务器可以决定它的初始位置。

🎁 值得期待的奖励。 物品、后续任务、命令、随机抽取的奖品,或让玩家自选的弹窗。

⏳ 适用于任何任务的规则。 时间限制、世界、冷却、次数上限:将它们添加到任何任务上并自由组合。

🌍 全服事件。 “一起击杀 1,000,000 只骷髅”是一个任务,而不是一个插件。

🔔 可以听见的结局。 完成的任务会占据屏幕中央,并播放你选择的声音。

🗄️ 文件或数据库。 无需配置的 JSON 文件,或适用于大型网络的 PostgreSQL、MySQL、MariaDB 和 SQLite。多个服务器可以共享相同的任务。

🛡️ 启动时检查。 缺失的引用或任务之间的循环会让服务器以明确的原因停止启动,而不是在数小时后当着玩家的面崩溃。

🈯 内含英文和法文。 每一行文本都可翻译。


📖 章节与任务日志

The journal's Chapters tab: the Adventure group unfolds, then The Forgotten Temple and The Goblin Breach open one after the other, each drawn as a graph of quest icons

将你的任务归入章节,再将章节归入分组,每个都有其图标。章节被绘制成一张地图:每个任务是一个图块,箭头显示哪一个会开启下一个。

Hovering The restless dead shows its tooltip and lights its two branches, then hovering Knights of the crypt shows its own
  • 悬停任务即可查看其状态和所需内容,通往它的路径会高亮显示。
  • 地图可任意大小: 双向滚动,或一键切换为章节的普通列表。
  • 三个标签页: 章节、带状态筛选和搜索框的任务,以及奖励,当有待领取的内容时会变为金色。
  • 可展开的行显示故事、每个目标及其计数器,以及提供的奖励。
  • 从日志中追踪: 一键将某个任务或长任务链中的单个步骤放到 HUD 上。
From the quest list, a reward link opens Bomb throwers, then Boom powder, Bangsticks and The Voidtaken Grizzly, the trail folding its oldest steps; a click on the trail goes back one step
  • 可浏览的任务链: 奖励或目标中提及其他任务时为链接,顶部的轨迹可带你返回。
  • 它会记住: 关闭日志,再次打开,你会回到相同的标签页、章节和任务。
In edit mode, the Rune of fire tile is picked up and dropped one cell further right, then the edit is closed

在游戏内布局章节。 拥有编辑权限的玩家会看到编辑按钮:选中一个图块,将其放到另一个格子上,章节文件就会自动为你写入。


🎯 任务类型

类型 完成条件
Gather 持有一定数量的物品
InteractivelyPickup 手动拾取一定数量的物品
Craft 制作一定数量的物品,无论配方如何
Consume 食用或饮用一定数量的物品
DropItem 从物品栏中丢弃一定数量的物品
PickupItem 从地面或手动拾取一定数量的物品
BreakBlock 破坏一定数量的方块
PlaceBlock 放置一定数量的方块
UseBlock 与方块交互一定次数
UseEntity 与某组的 NPC 交互
KillNpc 击杀某组的 NPC
KillPlayer 击杀玩家,可选指定玩家
ReachLocation 进入某个位置周围的一定半径内
EnterWorld 进入名称匹配某个模式的世界
TriggerVolume 进入触发区域,即使在生成的世界中也可以
Walk、Run、Sprint 以该速度覆盖一段距离或一段时间
Jump 跳跃一定次数
Composite 其子任务,以 AND 或 OR 组合
QuestState 另一个任务达到某个状态:作为前置条件
NoOp 本身不完成任何内容:由命令、奖励或你自己的插件结束

物品和方块通过 id、标签或家族命名,例如任意花朵或任意生肉。"AntiAbuse": true 可防止同一物品被丢弃后拾取、或同一方块被放置后破坏被重复计数。

🎁 奖励

类型 效果
Item 给予物品
GrantQuest 交出后续任务:任务链就是这样延续的
Command 以控制台或玩家身份运行服务器命令
Random 抽取其奖励中的一项,每项有其自身的权重
Choice 打开弹窗,由玩家选择其获得的奖励
In the Rewards tab, Claim on The veilbound coffer opens a Choose your reward popup, and picking Greater Health Potion closes it

奖励可以在成功、失败或放弃时发放,可以立即交付或从日志中领取。无法交付的奖励(物品栏已满或玩家离线)会为他们保留。不会有任何损失。

⏳ 约束

类型 效果
TimeLimit 在若干秒后结束任务,无论失败或成功
Deadline 在设定日期结束该资源的所有任务
InWorld 仅在某些世界中计数;离开可能导致任务失败
NearPosition 仅在某个位置的半径内计数
EntityCondition 仅在冲刺、脱战、处于某种效果下时计数……
RequiresQuest 仅在另一个任务处于要求的状态后或期间计数
MinPlayersOnline 仅在在线玩家足够时计数
FailOnDeath 死亡会导致任务失败
Cooldown 每个周期至多一次,例如每日任务为一天
MaxQuests 限定次数,或同时只能接一个
"Constraints": [
  { "Type": "TimeLimit", "Seconds": 300 },
  { "Type": "Cooldown", "Seconds": 86400 }
]

日志会显示它们及剩余时间,限时任务在追踪器上会显示倒计时条。

🌐 任务的归属

同一个任务资源可以有四种玩法:

  • 👤 玩家。 每个人都按自己的节奏运行自己的副本。
  • 🚪 世界。 由世界内的所有人共享,非常适合地下城:击杀首领、存活十波、点亮所有火盆。最终在场的人获得奖励。
  • 🗺️ 世界组。 一个任务跨越地下城的所有副本:例如统计当天所有轮次的每日狩猎。
  • 🌍 宇宙。 整个社区共同推进的一个计数器。任务在这里成为服务器事件。

🎨 打造属于你的风格

  • 每个任务、章节和分组都有图标,可取自游戏中的任何物品或模型,或你自己的资源包。
  • 每个任务有两种文本: 在 HUD 上显示的说明该做什么的短句,以及讲述故事的描述。
  • 分类为日志中的任务进行颜色编码:地下城、服务器事件、支线任务……
  • 隐藏任务仅在达成后出现,使用 "Visibility": "WhenCompleted"。
  • 按结果播放声音,可来自游戏或你自己的资源包。
  • 自动追踪在任务交出的那一刻就将其放到 HUD 上。
  • 默认标题在你未填写时生效:一个 Gather 任务会自动显示为 采集 2 根木棍。

🛠️ 面向服务器管理员

安装

  • ⚔️ OpenQuests:本项目,包含任务类型、奖励、日志和 HUD
  • ⚙️ OpenQuests Core:底层系统,随其一并引入
  • 📦 OpenQuests Examples(可选):现成的任务线

将它们放入 mods/。无需其他配置。

编写任务

在资源编辑器中打开它并修改你喜欢的内容,每个字段在你输入时都会被校验:

The Asset Editor on The veilbound coffer: Auto Track gets ticked and Target Quantity goes from 12 to 20

在底层,任务是一个 JSON 资源,包含步骤:

{
  "Type": "Composite",
  "TitleKey": "quest.basics.title",
  "QuestAssetIds": [
    "GatherSticks",
    { "Type": "Craft", "ItemToCraft": { "ItemId": "Weapon_Sword_Crude" }, "TargetQuantity": 1 }
  ],
  "SuccessfulRewards": [
    { "Type": "Item", "ItemId": "Ingredient_Life_Essence", "Quantity": 25, "AutoClaim": true },
    { "Type": "GrantQuest", "QuestAssetIds": ["DefeatTheGuardian"] }
  ]
}

旁边的分配文件说明谁在何时获得它:连接时、进入世界时,或按计划,一次或反复进行。

{
  "Trigger": { "Type": "PlayerEnterWorld", "WorldNamePattern": "instance-Portals-Portals_Goblins-.*" },
  "Scope": { "Type": "World" },
  "QuestAssetIds": ["GoblinBreachIntruders"]
}

命令

命令 效果 授予
/ojournal 打开任务日志,也可用 /journal 和 /quests hytale:Adventurer
/oquest abandon <quest> 放弃你匹配的任务 hytale:Adventurer
/oquest complete <quest> 将它们以成功结束 hytale:WorldEditor
/oquest fail <quest> 将它们以失败结束 hytale:WorldEditor
/oquest create player <assetId> <player> 将任务交给玩家 hytale:WorldEditor
/oquest create world <assetId> <world> 与世界共享任务 hytale:WorldEditor
/oquest create universe <assetId> 与整个服务器共享任务 hytale:WorldEditor
/ohud show、/ohud hide 显示或隐藏你的任务追踪器 hytale:Adventurer
/ohud move --side=<side> --top=<n> 移动它,也可用 --offset=<n> 指定距侧边的距离 hytale:Adventurer
/ohud reset 将其恢复到服务器设定的位置 hytale:Adventurer
/ohud default show 等 对未做选择的玩家应用相同设置,保存在 hud.json 中 hytale:WorldEditor

<quest> 是任务 id 或资源 id,输入时会提示资源 id。/oquest 也可用 /quest 和 /q。

存储

任务以 JSON 形式保存在你的 universe 目录下,无需任何设置。对于大型服务器,或多个共享玩家的服务器,可在 mods/MartelStudios_OpenQuestsCore/config.json 中使用数据库:

{
  "Storage": {
    "Type": "Jdbc",
    "Url": "jdbc:postgresql://localhost:5432/openquests",
    "User": "openquests",
    "Password": "…",
    "DriverPath": "libs/postgresql-42.7.4.jar"
  }
}

支持 PostgreSQL、MySQL、MariaDB 和 SQLite;将数据库驱动放到服务器旁边。共享数据库的服务器会共享全服任务和跨多个世界的任务,玩家切换服务器时会从上次离开的地方继续。为避免密码出现在 mods/ 中,可将 OPENQUESTS_CONFIG 环境变量指向其他位置的文件。


💻 面向开发者

OpenQuests Core 是独立的系统,不含任何任务类型,而 OpenQuests 添加了任务类型、奖励、日志和 HUD,每个功能一个包:这是编写你自己的扩展的参考。新增一种任务类型只需一次调用:

QuestProgressionService.get().registerQuestType(
    "MyType",
    MyQuestAsset.class, MyQuestAsset.CODEC,
    MyQuestProgression.class, MyQuestProgression.CODEC
);

奖励、约束、HUD 和日志渲染器各只需一行,追踪器和日志会绘制你的类型,而无需知道它的存在。在你的 manifest.json 中声明 "MartelStudios:OpenQuestsCore" 或 "MartelStudios:OpenQuests"。


源码与文档: https://github.com/MartelStudios/OpenQuests

MIT 许可。