  🔵 Discord     ☕ Ko-fi     ⭐ Patreon     📖 Wiki  

QuestLines

QuestLines is a Hytale server plugin that brings NPCs to life through a fully data-driven dialogue and quest system.

Tie any NPC — whether a HyCitizens citizen or a standard Hytale entity — to branching conversation trees that drive player progression through quests, achievements, rewards, and world state.

Quests can be as simple as a single NPC conversation or as complex as a multi-staged boss encounter with branching outcomes, timed events, and economy rewards.

If you can imagine it, QuestLines can drive it.

Features

Branching Dialogue

Every NPC interaction is a page of dialogue with any number of response buttons, each with its own requirements and actions. Players see only the responses they qualify for.

Flexible Quest State

Track progress through:

Tags
Kills
Block breaks
Item collection
Crafting
Harvesting
Fishing
Economy checks
Proximity
Time of day

Chain conditions with any: and not: logic for complex branching.

Named Tracker System

Define reusable trackers with:

Wildcard targets (Rock*, *Planks)
Bracket lists ([Rat,Bat])
Optional location/world gating

Tracker progress drives requirements, actions, and inline text variables.

Rich Action System

Trigger actions from responses or automatically when requirements pass:

Give items
Run commands
Award currency
Grant titles
Spawn NPCs
Navigate between pages
Mutate named variables

Achievements

Server-defined milestones with:

Single-stage progression
Staged (cascading tier) progression

Players track them via /achievements; admins manage them in-game.

In-Game Quest Editor

Build, edit, validate, and translate quests entirely in-game:

/ql quest

Quest Goal HUD

A clean overlay showing current objectives, updated automatically as players progress.

Player Journal

Review active and completed quest dialogue anytime:

/journal
Aliases: /j, /log

Localization

Includes:

English
German
Spanish
French
Portuguese (Brazilian)
Russian

Players select language via /qlconfig.

Editor includes a one-click Translate Quest feature backed by a pluggable translation service.

Auto-Validation

Validates on startup and reload
Manual validation via /ql validate
Custom API extensions auto-recognized

Economy & Permission Support

Native integration with VaultUnlocked:

Balance checks
Payments
Permission-gated content

Region & Location Gating

Scope logic by:

Radius
World
OrbisGuard / QL Claims region

Optional Plugin Integrations

HyCitizens
OrbisGuard
VaultUnlocked
MMOSkillTree
RPGLeveling
HyFishing
Anglers' Almanac
Endgame QoL (Wave Arena)
Endless Leveling
QuestLines Companion Suite:
- Icons
- Dialog
- Titles
- GUI
- Claims
- MMO

Extensibility API

Requirements
Actions
Text variables

via QuestLinesAPI.

Resources

📖 Wiki
📖 QuestBuilder — Web app for building quests (community-made)
💬 Discord — Community support, suggestions, and /validate-quest bot
☕ Support the project on Ko-fi

QuestLines Core