premium banner
A quest progression system that guides players through structured survival, crafting, exploration, and combat milestones in a cohesive adventure path.

Description

QuestBook is a quest management mod for Hytale inspired by FTB Quests and Better Questing from Minecraft. Create custom quest lines to guide players through progression, tutorials, or adventures.

Features

  • Quest Book UI - Full-screen interface for browsing quests organized into chapters
  • Quest Tracker HUD - Persistent on-screen display showing current quest progress (press Q with book in hand to toggle)
  • MultipleHUD Compatible - Works alongside the MultipleHUD mod without conflicts
  • Multiple Task Types - Crafting, killing, mining, item collection, and location discovery
  • Wildcard Patterns - Use * wildcards for flexible matching (e.g., Ore_* matches any ore)
  • JSON Configuration - Define quests in simple JSON files for easy customization

Commands

Command Description
/quest book Open the quest book UI
/quest track <id> Track a specific quest
/quest untrack Stop tracking current quest
/quest progress View your overall progress
/quest location Show your current zone/biome
/questadmin reload Reload quest files

Creating Your Own Quests

Quest File Location

Quest files are stored in your Hytale save folder:

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

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

Edit the included vanilla_quests.json or create your own .json files. Use /questadmin reload to apply changes without restarting.


Task Types

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 }

Set consume: true to require players to turn in items via a "Submit Items" button.

Location Discovery

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

Or use depth-based checks:

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

Use /quest location in-game to find zone and biome names.


Quest Structure Example

{
    "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 }
                    ]
                }
            ]
        }
    ]
}

Wildcard Patterns

Pattern Matches
* Anything
Wood_*_Trunk Any wood type
Trork_* Any Trork variant
Food_*_Cooked Any cooked food

Tips

  • Find Item IDs at hytaleitemids.com
  • Test quickly with the "Auto Complete" button in the quest UI
  • Check zones with /quest location before creating location quests
  • Use unique IDs for every quest and task

Perfect for modpack creators, server owners, or anyone wanting to add guided progression to their Hytale experience.