任务书

QuestBook 是一个专为 Hytale 设计的任务管理模组，灵感来源于 Minecraft 的 FTB Quests 和 Better Questing。您可以创建自定义任务线，引导玩家完成进度、教程或冒险。

功能特点

• 任务书界面 - 全屏界面，浏览按章节组织的任务
• 任务追踪 HUD - 持续显示当前任务进度的屏幕叠加层（手持任务书时按 Q 键切换）
• 兼容 MultipleHUD - 可与 MultipleHUD 模组共存，无冲突
• 多种任务类型 - 合成、击杀、挖掘、物品收集以及区域发现
• 通配符模式 - 使用 * 通配符进行灵活匹配（例如，Ore_* 匹配任何矿石）
• JSON 配置 - 在简单的 JSON 文件中定义任务，便于自定义

指令

指令	描述
/quest book	打开任务书界面
/quest track <id>	追踪指定任务
/quest untrack	停止追踪当前任务
/quest progress	查看整体进度
/quest location	显示当前区域/生物群系
/questadmin reload	重新加载任务文件

---

创建你自己的任务

任务文件存放位置

任务文件存储在你的 Hytale 存档文件夹中：

Mac： ~/Library/Application Support/Hytale/UserData/Saves/Modding/plugins/QuestBook/quests/

Windows： %APPDATA%/Hytale/UserData/Saves/Modding/plugins/QuestBook/quests/

编辑附带的 vanilla_quests.json 文件，或创建你自己的 .json 文件。使用 /questadmin reload 指令无需重启即可应用更改。

---

任务类型

合成 (Craft)

{ "type": "craft", "id": "craft_sword", "item": "Weapon_Sword_Copper", "count": 1 }

击杀 (Kill)

{ "type": "kill", "id": "kill_trorks", "mob": "Trork_*", "count": 10 }

破坏方块 (Block Break)

{ "type": "block_break", "id": "mine_ore", "block": "Ore_*", "count": 20 }

物品收集 (Item Collection)

{ "type": "item", "id": "have_iron", "item": "Ingredient_Bar_Iron", "count": 10, "consume": false }

设置 consume: true 要求玩家通过“提交物品”按钮上交物品。

区域发现 (Location Discovery)

{ "type": "location", "id": "reach_desert", "zone": "HowlingSands*" }

或使用基于深度的检测：

{ "type": "location", "id": "go_deep", "below_y": 110 }

在游戏中使用 /quest location 指令查找区域和生物群系名称。

---

任务结构示例

{
    "default_chapter": "getting_started",
    "chapters": [
        {
            "id": "getting_started",
            "title": "Getting Started",
            "icon": "Tool_Hatchet_Crude",
            "sort_order": 0,
            "quests": [
                {
                    "id": "first_tool",
                    "title": "Your First Tool",
                    "description": "Craft a crude hatchet to gather wood faster.",
                    "icon": "Tool_Hatchet_Crude",
                    "x": 0, "y": 0,
                    "dependencies": [],
                    "tasks": [
                        { "type": "craft", "id": "craft_hatchet", "item": "Tool_Hatchet_Crude", "count": 1 }
                    ],
                    "rewards": [
                        { "type": "item", "item": "Ingredient_Stick", "amount": 10 }
                    ]
                }
            ]
        }
    ]
}

---

通配符模式

模式	匹配内容
*	任何内容
Wood_*_Trunk	任何木材类型
Trork_*	任何 Trork 变种
Food_*_Cooked	任何熟食

---

提示

• 查找物品 ID，请访问 hytaleitemids.com
• 快速测试，使用任务界面中的“自动完成”按钮
• 检查区域，在创建区域任务前使用 /quest location 指令
• 使用唯一 ID，为每个任务和子任务设定唯一标识

---

非常适合整合包制作者、服务器管理员，或任何希望在 Hytale 体验中添加引导式进度的人。