
打开任务
为Hytale打造的模块化可扩展任务系统。只需点击几下,即可直接在资源编辑器中创建任何你能想象的任务。
查看大图OpenQuests
⚔️ 为你的 Hytale 服务器提供完整的任务系统。在资源编辑器中设计任务,把插件放入 mods/,你的玩家就有事可做了。
无需编写代码。以下所有功能开箱即用。
你可以随心所欲地嵌套任务,并用 AND 和 OR 将它们串联起来,实现真正的分支式进度。用剑击败守护者,或者另寻他路。
📦 想看看实际效果? 在 OpenQuests 旁边安装 OpenQuests Examples:现成的任务线,提供英文和法文版本,服务器启动后就会交到你的玩家手中。
✨ 你将获得
📝 一切都在资源编辑器中完成。 自动补全、校验和内联定义,让整条任务链容纳在一个文件中。
🧩 任务由任务构成。 一个步骤就是一个任务,和其他任务一样拥有自己的奖励。你可以根据故事需要任意深度地嵌套。
🔀 分支路径。 OR 让玩家自行选择通过章节的方式,AND 则要求完成所有内容。
📖 带章节的任务日志。 /ojournal 将你的任务按章节整理,并以地图形式绘制它们之间的通往关系,再次打开时会回到你上次离开的位置。
🖼️ 任务文本清晰易读。 每个任务都有图标、在 HUD 上准确说明该做什么的短句,以及讲述故事的描述,支持段落、斜体和颜色。
📊 追踪器 HUD。 标题、计数器、嵌套和计时器,与截图完全一致。玩家可以隐藏或移动它,服务器可以决定它的初始位置。
🎁 值得期待的奖励。 物品、后续任务、命令、随机抽取的奖品,或让玩家自选的弹窗。
⏳ 适用于任何任务的规则。 时间限制、世界、冷却、次数上限:将它们添加到任何任务上并自由组合。
🌍 全服事件。 “一起击杀 1,000,000 只骷髅”是一个任务,而不是一个插件。
🔔 可以听见的结局。 完成的任务会占据屏幕中央,并播放你选择的声音。
🗄️ 文件或数据库。 无需配置的 JSON 文件,或适用于大型网络的 PostgreSQL、MySQL、MariaDB 和 SQLite。多个服务器可以共享相同的任务。
🛡️ 启动时检查。 缺失的引用或任务之间的循环会让服务器以明确的原因停止启动,而不是在数小时后当着玩家的面崩溃。
🈯 内含英文和法文。 每一行文本都可翻译。
📖 章节与任务日志

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

- 悬停任务即可查看其状态和所需内容,通往它的路径会高亮显示。
- 地图可任意大小: 双向滚动,或一键切换为章节的普通列表。
- 三个标签页: 章节、带状态筛选和搜索框的任务,以及奖励,当有待领取的内容时会变为金色。
- 可展开的行显示故事、每个目标及其计数器,以及提供的奖励。
- 从日志中追踪: 一键将某个任务或长任务链中的单个步骤放到 HUD 上。

- 可浏览的任务链: 奖励或目标中提及其他任务时为链接,顶部的轨迹可带你返回。
- 它会记住: 关闭日志,再次打开,你会回到相同的标签页、章节和任务。

在游戏内布局章节。 拥有编辑权限的玩家会看到编辑按钮:选中一个图块,将其放到另一个格子上,章节文件就会自动为你写入。
🎯 任务类型
| 类型 | 完成条件 |
|---|---|
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 |
打开弹窗,由玩家选择其获得的奖励 |

奖励可以在成功、失败或放弃时发放,可以立即交付或从日志中领取。无法交付的奖励(物品栏已满或玩家离线)会为他们保留。不会有任何损失。
⏳ 约束
| 类型 | 效果 |
|---|---|
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/。无需其他配置。
编写任务
在资源编辑器中打开它并修改你喜欢的内容,每个字段在你输入时都会被校验:

在底层,任务是一个 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 许可。
正在加载版本记录…












正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。