HUD Tracker
HUD Tracker
Section titled “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
Section titled “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
Section titled “Objective Status Markers”| Marker | Meaning |
|---|---|
- | In progress |
+ | Completed |
x | Locked (sequential quest, previous objectives not yet done) |
Tracking Quests
Section titled “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
Display Limits
Section titled “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
Section titled “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.
Player Settings
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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.