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

Register custom:

• 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