HUD Tracker
The Quest Tracker HUD is a persistent on-screen display that shows your tracked quests and their objective progress in real time. It follows an MMO-style design and is fully customizable per player.
What the HUD Shows
The tracker displays only quests you have explicitly chosen to track (not all active quests). For each tracked quest, you see:
- Quest Name -- The localized name of the quest
- Type Indicator -- A colored bar showing the quest type:
- Gold = Daily
- Cyan/Blue = Weekly
- Purple = Story
- Teal = Hub
- Gray = Side
- Objectives -- Each objective with a status marker and optional progress counter
- Turn-in Destination -- Appears when all objectives are complete, showing where to deliver (NPC name or "Quest Book")
Objective Status Markers
| Marker | Meaning |
|---|---|
- | In progress |
+ | Completed |
x | Locked (sequential quest, previous objectives not yet done) |
Tracking Quests
You can track and untrack quests from the Quest Book UI:
- Open the Quest Book with
/ksquest - Find an active quest in any tab
- Click the Track button (eye icon) to add it to the HUD
- Click the Untrack button (crossed eye icon) to remove it
Quests are automatically untracked when you complete or abandon them. There is no need to manually untrack finished quests.
Display Limits
| Setting | Default | Range |
|---|---|---|
| Max tracked quests | 5 | 1 -- 5 |
| Max objectives per quest | 5 | 1 -- 5 |
If you track more quests than your configured maximum, only the first N tracked quests are displayed. The header shows a counter like "3/5" indicating how many slots are in use.
Position Presets
The HUD tracker can be placed in one of six screen positions using presets:
| Preset | Location |
|---|---|
top_left | Upper-left corner |
top_right | Upper-right corner (default) |
middle_left | Center-left |
middle_right | Center-right |
bottom_left | Lower-left corner |
bottom_right | Lower-right corner |
You can also use a custom position with specific X/Y pixel coordinates for precise placement.
Changing the HUD position requires the tracker to be recreated. The change takes effect immediately after saving settings.
Player Settings
Each player can customize their HUD tracker through the Quest Settings page (gear icon in the Quest Book, or /ksquestsettings):
| Setting | Description | Default |
|---|---|---|
| HUD Enabled | Show or hide the tracker entirely | On |
| Position Preset | Screen position (see presets above) | top_right |
| Show Progress | Display numeric progress counters (e.g. "3/10") next to objectives | On |
| Show Empty State | Show the tracker frame even when no quests are tracked | On |
| Max Displayed Quests | How many tracked quests to show (1--5) | 5 |
| Max Displayed Objectives | How many objectives per quest to show (1--5) | 5 |
All settings are saved per player and persist across sessions.
Auto-hide Behavior
The HUD tracker automatically hides in the following situations:
- HUD disabled -- When the player has turned off the tracker in settings
- No tracked quests -- When no active quests are being tracked (unless "Show Empty State" is enabled, which shows an empty frame instead)
- World map open -- The tracker hides while the world map is displayed to avoid visual clutter, and reappears when the map is closed
Empty State
When you have no tracked quests and "Show Empty State" is enabled, the tracker frame remains visible with a counter showing "0/N". This serves as a reminder that the tracker is available. If "Show Empty State" is disabled, the tracker disappears completely until you track a quest.
Server Owner Defaults
Server owners can configure default HUD settings for new players in the quest config. When a player joins for the first time, they inherit these defaults:
- Default position preset
- Default "Show Empty State" setting
Players can override these defaults at any time through their personal settings.
Dimensions
The HUD tracker has a fixed width of 280 pixels and adapts its height based on content. It is designed for 1920x1080 resolution and scales proportionally on other screen sizes.